> Source: https://ashareapi.com/docs/migrate-from-eastmoney/  ·  Markdown version for LLMs / AI agents

迁移指南

# 从东方财富接口迁移到 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 secid 换成 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`）是它内部的格式开关，我们不需要。
 |
| | 用途 | 东方财富 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

 标的
 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 | 一致，单位 %

 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，会列出全部可用项

 收盘后取全市场当天行情
 /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 线和行情可以直接调。跑通了再把脚本搬过来。

 [快速开始](/docs)[端点清单](/endpoints)[档位与额度](/pricing)
