双十一机构版年付 ¥1,699/年查看年付
迁移指南

从东方财富接口迁移到 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 是两套编码,不能互转

三步改完

1secid 换成 code

东财用「市场号.代码」(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
2参数名换一遍

周期 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
3字段名换一遍(只有 1 个必改)

东财 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)是它内部的格式开关,我们不需要。

标的
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)。量级与排序不受影响。

成交量跨端点差 100 倍

/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 分钟。拿它和东财实时分时逐根比对,尾部会对不上。

quote 不是实时 tick

/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)
现在(ashareapi)
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%)。我们侧的字段取自线上真实返回(同一天同一只逐字段比对)。两边都可能调整,以各自官方页面为准。

先跑一条 curl 再决定

免费端点不需要 Key,K 线和行情可以直接调。跑通了再把脚本搬过来。