跨市场差异速查

各市场一致的

行情类字段跨市场完全一致（A 股 / 港股 / 美股都一样，8 个字段）：

date · open · last · high · low · volume · amount · turnover

技术指标也一致 —— technical 在 A 股 / 港股 / 美股返回同一套字段（MA / EMA / MACD / KDJ / RSI / BOLL 等 55 个），不因市场变化。

各市场不同的

公司资料 profile

市场	字段
A 股	最全（15 个）：business（主营）· issuePrice · regCapital · establishDate · chairman · 地址 · 电话 · 邮箱
美股	8 个：用 introduction（简介）和 exchange（交易所）替代了 A 股的 business
港股	实测返回空 —— 需要港股资料请用 quote 取行情，资料另找

⚠️ A 股有 business，美股有 introduction —— 字段名不同，别按同一个名字取。

分红 dividend

市场	字段
A 股	reportEndDate · dividendFlag · dividendType · procedure · proposalSn · rightRegDate · exDiviDate · bonusShareRatio（送股）· tranAddShareRatio（转增）· cashDiviRMB（现金分红）· dividendPlan
港股	reportEndDate · exDiviDate · cashPayDate · cashDivPerShare · specialDivPerShare · totalCashDivi · dividendPlan
美股	exDivDate · regDate · payDate · dividendCurrency · dividend · dividendPlan

⚠️ 三个市场的分红字段几乎不重名 —— A 股的 exDiviDate、港股的 exDiviDate、美股的 exDivDate 拼写还不一样（一个 i 之差）。

只覆盖部分市场的端点

端点	覆盖范围（实测）
snapshot	仅 A 股（含创业板 / 北交所）；港股、美股返回空
orderbook	A 股 + 港股 + 北交所；美股返回空
chip（筹码）	仅 A 股；港股、美股返回空数组
fund（资金流）	三个市场都返回，但字段填充度不同 —— 见下
events（事件标签）	仅 A 股有数据；港股、美股返回“数据为空”
shareholder（股东）	A 股 3 段 / 港股 3 段（两套段语义不同，见返回形态速查）；美股返回空

资金流 fund 的填充度

三个市场都会返回数据，但字段填充度逐市场递减（实测）：

市场	main_net（主力净流入）	main_rank（排名）
A 股	✅ 有值	✅ 有值
港股	✅ 有值	⚠️ 空
美股	⚠️ 空	⚠️ 空

⇒ 只有 close / date 这类基础字段是三市场通用的；拿 main_net 做跨市场排名时先判空。

北交所

代码前缀是 bj（如 bj920002）。K 线各周期都有数据，实测 bj920002：日 / 周 / 月 / 季 / 年线均有（snapshot 也支持）。

⚠️ 两个坑：

1. 分钟线为空 —— 北交所的 kline 分钟线（m1 ~ m120）实测返回空。
2. 老代码取不到数据 —— 北交所有代码迁移（如诺思兰德由 bj430047 迁到 bj920047）。用旧代码调 K 线会整列返回空，看起来像“不支持”，实际是代码过期。换新代码即恢复（实测 bj920047 各周期正常）。

想取北交所的分钟级数据，用 minute（分时）端点，不是 kline 的分钟线。

常见误用

• 拿 A 股的字段名去取美股资料 —— 美股没有 business，只有 introduction。
• 对港股调 snapshot —— 返回空（不是故障），港股用 quote。
• 对美股调 orderbook —— 返回空。
• 以为 fund 只有 A 股 —— 三个市场都返回，但美股的 main_net 是空值；只有 close / date 通用。
• 跨市场写同一段分红解析 —— 三个市场字段几乎不重名，exDiviDate（A/港）和 exDivDate（美）差一个字母。
• 用北交所旧代码报“不支持” —— 先换新代码（bj430047 → bj920047）复测；空结果有三种成因（真没数据 / 参数超窗 / 被限频），别急着下“不支持”的结论。