从东方财富接口迁移到 ashareapi
东财 push2 与我们不是一套参数,但数据同源。下面是逐项对照、字段映射、可运行的改写示例,以及两边必然不一样的 6 处 —— 先看完这 6 条,能省掉大半排查。
K 线 / 快照能对上,代码改 3 处即可(代码格式、周期参数、f53 对应 last);涨跌幅 / 涨跌额 / 振幅属派生量,我们不提供、也不代算,要按涨幅筛请用 /v1/screen 的 ChangePCT 因子;全市场实时列表(clist)没有同形态端点 —— 收盘后全市场用 /v1/market-kline,盘中多只用 /v1/quote-batch,条件筛选用 /v1/screen。
能迁 / 不能迁
- 日 / 周 / 月 / 季 / 年 K 线,以及 m1 ~ m120 分钟线
- 单只行情快照(现价 / 开高低 / 成交量额 / 换手)
- 多只批量行情(
ulist.np→/v1/quote-batch,单次 200 只) - 多只批量 K 线(
/v1/kline-batch,单次 200 只 × 多根) - 某一天的全市场行情(
clist收盘后场景 →/v1/market-kline) - 条件选股 / 排行 / 标签 / 事件(
clist+ 前端过滤 →/v1/screen) - 今日无需注册就能调(免费端点连 Key 都不要)
- 盘中全市场实时列表:我们按「代码列表」或「日期」驱动,没有「全市场 × 任意字段 × 服务端排序」的实时列表端点
- 派生量:涨跌幅(f59)/ 涨跌额(f60)/ 振幅(f58)—— 属计算字段,本服务不返回
- 盘口深度历史:五档盘口只给当前,没有历史回放
- 逐笔成交:只在大单成交(L2)维度提供,不是全量逐笔
- 东财板块编码:
90.BK0475与我们的pt01801081是两套编码,不能互转
三步改完
东财用「市场号.代码」(1.600519),我们用「市场前缀 + 代码」(sh600519)。⚠️ 北交所在东财的市场号也是 0,不能按「0 = 深市」硬拼 —— 要按代码段判断,否则 0.920047 会拼成 sz920047 取不到数。
# 东财 secid -> 我们的 code
# 1.600519 -> sh600519
# 0.000001 -> sz000001
# 0.920047 -> bj920047 <- 市场号 0,但不是深市
def secid_to_code(secid: str) -> str:
mkt, num = secid.split(".")
num = num.zfill(6)
if num[:2] == "92" or num[0] in ("4", "8"):
return "bj" + num
return ("sh" if mkt == "1" else "sz") + num周期 klt → period;条数 lmt → count;区间 beg / end(YYYYMMDD)→ start / end(YYYY-MM-DD)。复权 fqt 在免费端点上没有对应参数,见下一节。
# 东财
# push2his.eastmoney.com/api/qt/stock/kline/get
# ?secid=1.600519&klt=101&fqt=1&lmt=30
# 我们
curl "https://api.ashareapi.com/v1/kline?code=sh600519&period=day&count=30"
# klt 101/102/103 -> day/week/month
# klt 1/5/15/30/60 -> m1/m5/m15/m30/m60东财 fields2 的 11 列里,8 列能对上,只有收盘价的名字不同:f53 我们叫 last,不叫 close。剩下 3 列(振幅 / 涨跌幅 / 涨跌额)我们不返回。
{
"ok": true, "endpoint": "kline", "tier": "free",
"data": [
{"date": "2026-11-06", "open": "1450", "last": "1453",
"high": "1457.72", "low": "1436",
"volume": "42848", // 手,与东财 f56 同单位
"amount": "6199530000", // 元(万元取整)
"turnover": "0.34"} // 换手率 %,对应 f61
]
}参数对照
左边是东财 push2 的写法,右边是等价调用。表格里没有的东财参数(ut / fltt / invt / fields1)是它内部的格式开关,我们不需要。
| 用途 | 东方财富 push2 | 我们 |
|---|---|---|
| 标的 | secid=1.600519 | code=sh600519(裸 600519 也收) |
| 周期 | klt=101 / 102 / 103 / 1 / 5 / 15 / 30 / 60 | period=day / week / month / m1 / m5 / m15 / m30 / m60 |
| 复权 | fqt=0 不复权 / 1 前复权 / 2 后复权 | 免费 kline 固定前复权,无 fq 参数;要 nofq / hfq 用 /v1/kline-full 或 /v1/kline-batch |
| 条数 | lmt=30 | count=30(上限 1212) |
| 区间 | beg=20260101&end=20261106(YYYYMMDD) | start=2026-01-01&end=2026-11-06(YYYY-MM-DD,须成对) |
| 选字段 | fields2=f51,f52,...(按需挑列) | 固定 8 列,不能挑列 |
| 单只快照 | stock/get?secid=1.600519 | quote?code=sh600519 |
| 批量 | ulist.np/get?secids=1.600519,0.000001 | quote-batch?codes=sh600519,sz000001 |
| 全市场列表 | clist/get?fs=m:1+t:2&fields=...&fid=f3&po=1 | 无同形态 —— 见「全市场扫描」一节 |
| 排序分页 | fid=排序字段 & po=0/1 & pn / pz | screen 的 orderby / desc / limit / offset |
K 线字段映射(11 列 → 8 列)
下面是东财 fields2=f51,...,f61 的逐列对照。2026-11-06 贵州茅台实测:开 1450 / 收 1453 / 高 1457.72 / 低 1436 / 量 42848 手 / 额 6199528289 元 / 振幅 1.50% / 涨跌幅 0.07% / 涨跌额 1.00 / 换手 0.34%。
| 东财字段 | 我们字段 | 说明 |
|---|---|---|
| f51 日期 | date | 格式一致(YYYY-MM-DD) |
| f52 开盘 | open | 一致 |
| f53 收盘 | last | 名字不同,这是唯一必改的字段名 |
| f54 最高 | high | 一致 |
| f55 最低 | low | 一致 |
| f56 成交量 | volume | 一致,单位都是手 |
| f57 成交额 | amount | 都是元,但我们按万元取整(尾数差 ≤ 5000 元) |
| f58 振幅 | — | 不返回(派生量) |
| f59 涨跌幅 | — | 不返回(派生量) |
| f60 涨跌额 | — | 不返回(派生量) |
| f61 换手率 | turnover | 一致,单位 % |
两边必然不一样的 6 处
这几条是结构性的,不是故障。先看一遍,撞上时就不会当成数据错。
我们按万元取整(600519 在 2026-11-06 返回 6199530000),东财精确到元(6199528289)。量级与排序不受影响。
/v1/kline、/v1/kline-batch 是手(与东财 f56 一致);/v1/market-kline、/v1/kline-full 是股。混用两个端点做对比就会差 100 倍。
免费 /v1/kline 固定前复权(分钟线固定不复权),传 fq 会直接报参数错误,不会静默降级。东财 fqt=1 的前复权在长历史里会出现负价(600519 2001 年约 -312),我们的不会 —— 两边长期历史价格不可直接对齐。
涨跌幅 / 涨跌额 / 振幅不返回,也不代算。自己用相邻两根收盘价除一下,换周期就会错(周线算出来和日线滚动完全不同)。
m1 / m5 等分钟线由数据源分批落库,最新一根通常滞后 1 ~ 13 分钟。拿它和东财实时分时逐根比对,尾部会对不上。
/v1/quote 返回的是日线序列:data[0] 最新,data[1] 是前一交易日。要「昨收」取 data[1].last,不要用现价减涨跌额反推。
全市场扫描怎么换
如果你原来的扫描是「clist 拉全市场 + 本地过滤」,我们按场景拆成三条路。三条都不需要翻页拉 5000 次。
| 你的场景 | 用这个 | 说明 |
|---|---|---|
| 收盘后取全市场当天行情 | /v1/market-kline?date=2026-11-06 | 一次返回 5000+ 只,字段 code / time / open / high / low / close / volume / amount(不复权原始价,volume 单位是股) |
| 盘中取多只(有代码列表) | /v1/quote-batch?codes=... | 单次 200 只,逐只标明成功与否;5000 只分 25 次跑完 |
| 按条件筛(不需要全部) | /v1/screen?mode=condition&expr=...&limit=9999 | 因子表达式一次返回全市场命中结果,支持 ChangePCT / TurnoverRate / MainNetFlow 等;limit 无 200 上限 |
| 按排行 / 标签 / 策略 / 事件 | /v1/screen?mode=ranking / label / strategy / event | 不知道有哪些取值时加 list=true,会列出全部可用项 |
改写前后对照
左边是东财 push2 的取数,右边是等价调用。注意 close → last。
import requests
url = "https://push2his.eastmoney.com/api/qt/stock/kline/get"
params = {
"secid": "1.600519", # 1=沪 0=深
"klt": 101, # 101=日线
"fqt": 1, # 1=前复权
"beg": 0,
"end": 20500101,
"lmt": 30,
"fields1": "f1,f2,f3,f4,f5,f6",
"fields2": "f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61",
}
r = requests.get(url, params=params).json()
for line in r["data"]["klines"]:
date, o, c, h, l, vol, amt, amp, pct, chg, tor = line.split(",")
print(date, c, vol)import requests
r = requests.get(
"https://api.ashareapi.com/v1/kline",
params={"code": "sh600519", "period": "day", "count": 30},
timeout=30,
).json()
for bar in r["data"]:
print(bar["date"], bar["last"], bar["volume"]) # close -> last
# 没有 amp / pct / chg 三列:需要就用 /v1/screen 的 ChangePCT 因子筛,
# 不要在本地用相邻收盘价自己算(换周期会错)常见问题
不能,参数体系不同(secid / klt / fqt / fields 是 push2 私有的)。但映射关系是固定的,按上面三步换一遍即可;或者把这三个转换包成一个适配函数,调用处继续传东财参数。
涨跌幅是派生量,本服务只返回原始值,不代算。要按涨幅筛,用 /v1/screen?mode=condition&expr=intersect([ChangePCT > 5]),一次返回全市场命中结果。
看「两边必然不一样的 6 处」。最常见是成交额万元取整、成交量手 / 股混用、以及分钟线尾部时效差。前两条是取整与单位,第三条是落库节奏。
多源自动切换:某个数据源失败会自动换下一个,失败的那次不扣次数。返回里 source 字段会标明这次实际用的通道。
免费 /v1/kline 固定前复权。要 nofq / hfq 用 /v1/kline-full?fq=nofq(标准版起,仅 A 股)或 /v1/kline-batch?fq=nofq(专业版起,可批量)。
两套编码不通用:东财是 90.BK0475,我们是 pt01801081。请用 /v1/sector 或 /v1/search 按板块名查我们的代码。
最后更新: 2026-11-08
东财侧的参数与字段取自 push2 真实返回(2026-11-08 实测 600519,逐列核对:f58 振幅 1.50%、f59 涨跌幅 0.07%、f60 涨跌额 1.00、f61 换手 0.34%)。我们侧的字段取自线上真实返回(同一天同一只逐字段比对)。两边都可能调整,以各自官方页面为准。