FreeScript
tdxdata
by liu1561089752 · version 2026.11.12 · updated 3 days ago
No reviews yet
- Downloads
- 0
- Reviews
- 0
- Size
- 1.5 MB
- Code check
- Clean
- Licence
- MIT
- Released
- Nov 2026
A 股行情与数据中心 Python 客户端:K 线 / 分时 / 逐笔 / 报价 + 421 个数据产品,纯标准库、零依赖
tdxdata
A 股行情与数据中心,一行 import 就能用。纯标准库,零第三方依赖。
不需要安装任何客户端,不需要账号或 API Key,不需要 pandas / numpy / requests。
这个库能做什么
一句话:把 A 股的 K 线、分时、逐笔、报价,以及龙虎榜 / 财报 / 资金流等 424 个数据产品,
变成一个
三个"不需要"
你不需要…, 因为…
安装通达信客户端, 库直连公开行情服务器
注册账号 / 申请 Key, 无需鉴权
装第三方包, 只用
能取什么
想取什么, 用这个
日 / 周 / 月 / 季 K 线,前复权后复权,
1 / 5 / 15 / 30 / 60 分钟线,
当日分时(最多 240 点,含均价),
逐笔成交(自动翻页),
按代码批量报价(含量额),
全市场代码枚举,
代码 → 名称,
板块清单(6 类)与成分股,
技术指标(EMA / RSI…),
涨跌停价,
龙虎榜 / 财报 / 资金流 / 分红 / 大盘统计…(424 个产品),
F10 / 财务报表 / 分红融资,
取不到的(会明确抛异常,不返回假数据)
不能取, 原因
五档盘口(买一卖一…), 该通道没有买卖盘字段
行业板块成分股, 只有概念板块支持按板块取成分股
年线 / 3 分钟线, 服务端返回 0 行
历史逐笔, 只能取当日
期货 / 期权 / 国债期货 / 外汇的合约 K 线/分时/五档, 这些合约代码不在本数据源的证券表里 —— 库会抛
港股, 港股实时报价服务端是有的(
安装
或本地开发:
要求 Python ≥ 3.9,Windows / Linux / macOS 均可(纯 socket,无编译依赖)。
三十秒上手
返回类型
调用, 返回, 字段 / 公开成员
**每个对象都带
**
字段, 含义, 有值?, 依据 / 口径
反过来给它填
「笔数」字段。那不是「暂不可用」,是这个概念在这里不存在 —— 留着只有当摆设
(旧代码还填过
买卖方向目前不提供,但原始列在
**
换算不四舍五入(1,139,872 股 →
品类 × 周期, 库返回的
日线 / 分钟线 · 股票、ETF, 手(服务端给的是股,库已÷100)
周线 / 月线 · 所有品类, 手
日线 · 可转债, 手(1 手 = 10 张)
日线 · 逆回购, 手(1 手 = 1000 元)
日线 · 指数 / 板块指数, 手
分钟线 · 指数 / 板块指数, **
需要「手 → 股」自行乘 100。
复权
值, 含义, 协议
```python
c.get_bars("600519") # 自动推断市场(推荐)
c.get_bars("sh600
…
A 股行情与数据中心,一行 import 就能用。纯标准库,零第三方依赖。
import tdxdata
with tdxdata.Client() as c:
bars = c.get_bars("600519", period="day", count=5, adjust=tdxdata.Adjust.QFQ)
print(len(bars), bars[-1].date, bars[-1].close)
# 5 20261026 1349.98不需要安装任何客户端,不需要账号或 API Key,不需要 pandas / numpy / requests。
这个库能做什么
一句话:把 A 股的 K 线、分时、逐笔、报价,以及龙虎榜 / 财报 / 资金流等 424 个数据产品,
变成一个
import 就能调的 Python 对象。三个"不需要"
你不需要…, 因为…
安装通达信客户端, 库直连公开行情服务器
注册账号 / 申请 Key, 无需鉴权
装第三方包, 只用
socket / struct / zlib / json能取什么
想取什么, 用这个
日 / 周 / 月 / 季 K 线,前复权后复权,
get_bars()1 / 5 / 15 / 30 / 60 分钟线,
get_bars(period="1m")当日分时(最多 240 点,含均价),
get_minutes()逐笔成交(自动翻页),
get_ticks()按代码批量报价(含量额),
get_quotes()全市场代码枚举,
get_market_page() / get_universe()代码 → 名称,
get_name()板块清单(6 类)与成分股,
get_boards() / get_board_members()技术指标(EMA / RSI…),
get_indicators()涨跌停价,
get_price_limits()龙虎榜 / 财报 / 资金流 / 分红 / 大盘统计…(424 个产品),
get("产品名")F10 / 财务报表 / 分红融资,
get_f10() / get_finance() / get_xdxr()取不到的(会明确抛异常,不返回假数据)
不能取, 原因
五档盘口(买一卖一…), 该通道没有买卖盘字段
行业板块成分股, 只有概念板块支持按板块取成分股
年线 / 3 分钟线, 服务端返回 0 行
历史逐笔, 只能取当日
期货 / 期权 / 国债期货 / 外汇的合约 K 线/分时/五档, 这些合约代码不在本数据源的证券表里 —— 库会抛
OutOfScope。⚠️ 注意归因:这不是「服务端不支持某个市场码」。已实证 PBFXT 的 field3 对已知代码是宽松的(600519 在 field3=1/99/30 三种下返回逐位相同的 K 线)。⚠️ 但也别读成「期货什么都没有」:合约清单 / 会员持仓榜单 / 主力连续最新价快照在数据中心侧实测可用(见「已知限制」第 17 条)。港股, 港股实时报价服务端是有的(
PBCombHQ + setcode=31),但本库尚未实现;港股 K 线/分时没有通道,港股清单也无法枚举。本库目前只覆盖 A 股 / 北交所 / 指数 / 板块 / 债券。安装
pip install git+https://github.com/liu1561089752/tdxdata.git或本地开发:
git clone https://github.com/liu1561089752/tdxdata.git
cd tdxdata
pip install -e ".[dev]"要求 Python ≥ 3.9,Windows / Linux / macOS 均可(纯 socket,无编译依赖)。
三十秒上手
import tdxdata
with tdxdata.Client() as c:
# ① 日线(前复权,服务端算好给)
bars = c.get_bars("600519", period="day", count=120, adjust=tdxdata.Adjust.QFQ)
# ② 当日分时(最多 240 点,盘中逐步给出)
mins = c.get_minutes("000001")
# ③ 逐笔成交(自动翻页,按时间升序)
ticks = c.get_ticks("600519", count=300)
# ④ 批量报价(含成交量/成交额)
qs = c.get_quotes(["600519", "000001", "399001", "881007"])
# ⑤ 数据中心产品(424 个之一)
d = c.get("holiday")
print(d.table.shape, d.table.cols[:3])
print(d.rows[0]) # Row 是 dict 语义,可按列名取值
# (58, 6) ['N001', 'N002', 'N003']
# Row{'N001': '2026-05-01', 'N002': '星期五', 'N003': '中国', ...}返回类型
调用, 返回, 字段 / 公开成员
get_bars(), list[Bar], market code date open high low close vol amount period time raw adjust provisional symbol vol_unitget_minutes(), list[MinutePoint], code time price avg_price vol market raw symbolget_ticks(), list[Tick], market code time price vol trade_count bs_flag raw as_markdown_table symbolget_quotes() / get_market_page(), list[Quote], market code price pre_close open high low vol amount bid ask server_time name raw symbolget(), Dataset, name table params cols data_date rows to_dict() to_dicts() to_json()get_f10() / get_finance() / get_xdxr(), Table, cols rows cmd domain provenance ragged as_of column() inherit_provenance() is_ragged row() set_cols() shape status to_dict() to_dicts() to_json()**每个对象都带
.raw** —— 原始行原值,字段没覆盖到的部分可以自己从里面取。**
Tick 的字段表(get_ticks 返回的元素)**字段, 含义, 有值?, 依据 / 口径
market, 市场号, 有, 0=深 1=沪 2=北(与 Quote/Tick.symbol 同口径)code, 股票代码, 有, 6 位字符串time, 成交时刻, 有, HH:MM:SS;服务端给当日秒数(如 40978 → 11:22:58)price, 成交价, 有, 元;与 raw[Now] 逐笔相等(300/300 实测)vol, 成交量, 有, 手;与 Bar.vol/Quote.vol/MinutePoint.vol 同单位trade_count, 笔数, 不提供(声明式不可用), 原因见 models.UNPROVIDED_TICK_FIELDS:PBTickEx 一行就是一笔,协议里没有「笔数」字段;要数笔数请 len(ticks)bs_flag, 买卖方向, 不提供(声明式不可用), 原因见 models.UNPROVIDED_TICK_FIELDS:服务端无可判定字段,raw[InOutFlag] 0/1 与涨跌只有 65.9%/76.8% 相关,映射会整批搞反raw, 原始行, 有, 服务端原列:Second/Now/NowVol/VolInStockDiff/InOutFlag/HKTTFlag/HKInOutFlag,本库不解释bs_flag **恒为 None 是设计(声明式不可用**:原因写在机器可读的tdxdata.models.UNPROVIDED_TICK_FIELDS 里,测试会对真实样本复核它确实恒 None)。反过来给它填
2 才是编数据 —— 2 会被下游读成「卖」。trade_count 已在阶段 4 删除:PBTickEx 一行就是一笔成交,协议里根本没有「笔数」字段。那不是「暂不可用」,是这个概念在这里不存在 —— 留着只有当摆设
(旧代码还填过
0,会被 sum() 当真)。买卖方向目前不提供,但原始列在
tick.raw["InOutFlag"] 里,2026-10-27 实网 1200 笔的实测分布是:0 像主动买(相对上一笔涨 65.9%)、1 像主动卖(跌 76.8%)、5 全在 15:05–15:30 且成交在收盘价(盘后固定价格交易)、2 零星(含 15:00:01 收盘集合竞价那一笔)。相关不等于实证,所以库不替你映射。**
vol 的单位:对外恒为「手」**Bar / Quote / MinutePoint / Tick 四者同单位,可以直接比较、相加、相除。
c.get_quotes(["600519"])[0].vol # 手
c.get_bars("600519")[-1].vol # 手
c.get_ticks("600519", 100)[0].vol # 手
c.get_minutes("600519")[0].vol # 手换算不四舍五入(1,139,872 股 →
11398.72 手),所以 vol 可能带小数。品类 × 周期, 库返回的
vol日线 / 分钟线 · 股票、ETF, 手(服务端给的是股,库已÷100)
周线 / 月线 · 所有品类, 手
日线 · 可转债, 手(1 手 = 10 张)
日线 · 逆回购, 手(1 手 = 1000 元)
日线 · 指数 / 板块指数, 手
分钟线 · 指数 / 板块指数, **
None**(原因见下)
⚠️ **指数/板块分钟线的vol是None,不是 0,也不是手。**
服务端那一列填的是"成交额÷100"的派生值,不是真实成交量。库不拿派生值冒充数据,
所以给None;原值仍在raw["Volume"]。**该品类的日线vol是真值**,照常返回。
⚠️ **直接读**raw时要小心**:raw里保留的是服务端原值,单位随品类和周期变。
amount(成交额,单位元)** 在所有周期口径一致,可直接用;Quote.amount 与 Bar.amount 同口径。需要「手 → 股」自行乘 100。
复权
adjust 由服务端计算,不是本地乘系数:值, 含义, 协议
field8tdxdata.Adjust.NONE, 不复权, 1tdxdata.Adjust.QFQ, 前复权, 3tdxdata.Adjust.HFQ, 后复权, 2
c.get_bars("600519", "day", 200, adjust=tdxdata.Adjust.NONE)[-1].close # 1349.98
c.get_bars("600519", "day", 200, adjust=tdxdata.Adjust.QFQ)[-1].close # 1349.98(最新一根相同)
c.get_bars("600519", "day", 200, adjust=tdxdata.Adjust.HFQ)[-1].close # 9395.53
后复权与通达信客户端一致。不同软件的后复权绝对值不可比 —— 基准不同,代码写法
例如同期东方财富给另一组数,差一个恒定倍数。
```python
c.get_bars("600519") # 自动推断市场(推荐)
c.get_bars("sh600
…