东方财富板块行情数据源

通过 curl tool 调用东方财富行情接口，获取 A 股板块级和市场级的聚合行情：板块涨跌排行、个股涨跌幅榜、板块热力图原料。

职责边界：本数据源负责「整体/板块/榜单」这类聚合视图。单只股票的具体数值、K 线、分时、逐笔，请用 stock-market-datasource 数据源，不要用本源查个股明细。

鉴权

东方财富行情接口无需鉴权，直接发请求即可，不要传任何 token 或 API key。

通用约定

• Base URL：https://push2.eastmoney.com/api/qt/clist/get
  • 全市场个股榜可能 302 跳转到 https://push2delay.eastmoney.com/...（行情延迟约 15 分钟）。如主域请求失败，可直接改用 push2delay 域名。
• 请求方法：GET
• 响应格式：JSON，结构为 { "rc": 0, "data": { "total": 总数, "diff": [ {字段...}, ... ] } }
• 建议带 Referer 头提升稳定性：Referer: https://quote.eastmoney.com/
• 数值约定：所有请求都带 fltt=2，返回的数值已经是最终小数，无需再做单位换算：
  • f3（涨跌幅）：10.0 表示 +10.00%，-3.21 表示 -3.21%
  • f2（最新价 / 板块指数）：直接是元 / 点位
  • f20（总市值）、f21（流通市值）：单位是元，展示为「亿」需 ÷ 1e8
• 分页：pn = 页码（从 1 开始），pz = 每页条数（最大约 100）。响应里的 data.total 是总条数。
• 排序：fid = 排序字段（涨跌幅用 f3），po = 排序方向（1 降序＝涨幅榜，0 升序＝跌幅榜）
• ⚠️ 响应体积上限：curl 工具单次响应最多约 50KB，超出会被截断导致 JSON 不完整、无法解析。因此：(1) fields 只取需要的字段；(2) pz 不要超过 30~40；需要更多数据时分页串行取，每页同样 ≤ 40 条。

通用查询参数

fs 市场选择器

注意：fs 里的 + 是接口要求的分隔符，请原样保留，不要替换成空格或编码。

常用字段（fields）

⚠️ 速率限制策略（必须遵守）

东方财富接口有反爬限制，请控制请求频率：

1. 串行请求：同一时间只发 1 个 curl 请求，等返回后再发下一个。严禁并行发送多个请求
2. 请求间隔：每两个请求之间至少间隔 1 秒
3. 控制单页大小：受 10KB 响应上限约束，pz 取 30~40、fields 只取必要字段；想看「涨了哪些 / 跌了哪些」用涨幅榜（po=1）+ 跌幅榜（po=0）两次小请求即可，不要一次拉全部板块
4. 个股全市场分页要克制：沪深 A 股有 5000+ 只，需要榜单时取前 3040 名即可；做热力图最多串行翻 35 页（每页 ≤40），不要试图拉完整 5000 只
5. 429 / 空响应重试：收到 429 或空结果后等待 30 秒再重试，严禁立即重试
6. 数据复用：同一轮对话里已取到的板块列表、榜单结果应缓存复用，不要重复请求

常用接口

本数据源只有一个 endpoint（clist/get），通过不同 fs / 排序参数实现不同查询。

1. 行业板块涨跌排行（含热力图原料）

GET https://push2.eastmoney.com/api/qt/clist/get?pn=1&pz=30&po=1&np=1&fltt=2&invt=2&fid=f3&fs=m:90+t:2+f:!50&fields=f12,f14,f3,f104,f105,f128,f136

参数：

关键返回字段：

2. 沪深个股涨幅 / 跌幅榜（含市值）

GET https://push2.eastmoney.com/api/qt/clist/get?pn=1&pz=20&po=1&np=1&fltt=2&invt=2&fid=f3&fs=m:0+t:6,m:0+t:80,m:1+t:2,m:1+t:23&fields=f12,f13,f14,f2,f3,f20,f21

参数：

关键返回字段：

拼完整代码：f13=1 → sh{f12}，f13=0 → sz{f12}。需要查某只票的明细时，把代码交给 stock-market-datasource 数据源。

3. 指定板块的成分股

GET https://push2.eastmoney.com/api/qt/clist/get?pn=1&pz=50&po=1&np=1&fltt=2&invt=2&fid=f3&fs=b:BK1623+f:!50&fields=f12,f13,f14,f2,f3

参数：

关键返回字段：同接口 2 的个股字段（f12 f13 f14 f2 f3）。

调用示例

场景："今天有哪些板块涨了，哪些跌了？"

1. 查涨幅榜前几名：

curl(url = "https://push2.eastmoney.com/api/qt/clist/get?pn=1&pz=15&po=1&np=1&fltt=2&invt=2&fid=f3&fs=m:90+t:2+f:!50&fields=f12,f14,f3,f128,f136", X = "GET", H = ["Referer: https://quote.eastmoney.com/"])

2. 再发一次跌幅榜（把 po=1 改为 po=0），合并得到「领涨板块」和「领跌板块」。每个板块展示：名称 f14、涨跌幅 f3%、领涨股 f128。

场景："今日涨幅榜前 10"

curl(url = "https://push2.eastmoney.com/api/qt/clist/get?pn=1&pz=10&po=1&np=1&fltt=2&invt=2&fid=f3&fs=m:0+t:6,m:0+t:80,m:1+t:2,m:1+t:23&fields=f12,f13,f14,f2,f3", X = "GET", H = ["Referer: https://quote.eastmoney.com/"])

跌幅榜把 po=1 改为 po=0 即可。

场景："今日股市热力图 / 风云图"

推荐板块级热力图（轻量）：用接口 1 取行业板块的 f14 + f3，用 treemap 渲染——每个方块＝一个板块，颜色按 f3 涨跌幅（红涨绿跌）。受 10KB 上限约束，单次取 30~40 个板块；要覆盖更多就按 po=1 取涨幅前 N、再按 po=0 取跌幅前 N 合并，足够呈现市场冷热。

如需个股级热力图，用接口 2 的 f20（市值）做方块大小、f3 做颜色，按 pz=40 串行翻 3~5 页取主要个股（遵守速率与体积限制，不要拉满全市场）。

错误处理

注意事项

• 接口为非官方公开行情接口，字段和可用性可能随东方财富调整而变化；遇到字段缺失时如实告知用户。
• 非交易时间返回的是最近收盘 / 延迟数据。
• 涨跌停板：主板 ±10%、创业板/科创板 ±20%、ST ±5%，f3 已反映真实涨跌幅。
• 再次强调职责边界：板块/榜单/热力图走本源；个股的实时价、盘口、K 线、分时、逐笔走 stock-market-datasource 数据源。