Files
pytdxdata/docs/api/models.md
T
openbot-coder 3e0beb27a6 release: v0.6.0(统一对外接口重构)
按「数据类型」合并同类查询接口:一个数据类型 = 一个方法,跨市场自动选路。

- 28 个统一接口(get_universe/get_quotes/get_bars/get_indicators/get_ticks/
  get_minutes/get_f10/get_file/get_boards/get_board_of/get_snapshot 等),
  标的统一字符串写法(sz000001 / hk00700 / usAAPL / cffex:IFL0);
  同名旧方法不再兼容 (market, code) 元组。
- 旧 51 个按通道/市场分裂的接口:33 个保留为 deprecated 别名(1.0 移除),
  18 个同名升级为统一接口。公开方法共 63 个。
- 新增库层标的解析 pytdxdata.symbols;数据模型追加 symbol/name/fields 兜底字段。
- 修复:分页器连接泄漏、日期区间 K线返回 0 条(偏移方向探测)、池子全冷却死等。
- 文档/README/SKILL/llms.txt 全量同步;新增 docs/refactor-audit.md 审查报告。
- 测试 127 个用例全绿(含 tests/test_all_interfaces.py 全 63 方法回归)。
2026-09-17 11:34:52 +08:00

3.3 KiB
Raw Blame History

数据模型

全部数据模型位于 pytdxdata.models,统一为 @dataclass(slots=True)。

选择 dataclass 而不是 pandas DataFrame 是刻意的:零依赖 + 零转换开销, 需要 DataFrame 时你自己转(一行的事,见 场景示例 → 转成 pandas)。

导入方式

包级只导出 4 个枚举 + 6 个核心模型:

from pytdxdata import Market, ExMarket, KlinePeriod, Adjust
from pytdxdata import (
    SecurityBar, SecurityQuote, TransactionRecord,
    MinuteBar, XdxrRecord, FinanceRecord,
)

其余模型需要从子模块导入:

from pytdxdata.models import TdxBlock, IndustryInfo, FinancialFileInfo, FinancialRecord
from pytdxdata.models import BoardInfo, MemberQuote, AuctionItem, CapitalFlow

模型地图

模型 代表什么 从哪来
SecurityBar 一根 K 线 get_bars / get_indicators
IndexBar 指数 K 线(继承 SecurityBar) get_bars
SecurityQuote 五档报价快照 get_quotes / get_board_members
SecurityInfo 证券列表条目(代码 / 名称 / 前收) get_universe
TransactionRecord 一笔成交 get_ticks
MinuteBar 一分钟分时点 get_minutes
XdxrRecord 一次除权除息事件 get_xdxr
FinanceRecord 财务快照(最新一期,36 字段) get_finance
FinancialRecord 历史专业财报(gpcw*.zip,多报告期) get_financial_records_parsed
FinancialFileInfo 财报文件索引条目 get_financial_file_infos
TdxBlock 一个板块及其成分股 get_block_parsed
IndustryInfo 一只股票的行业归属 get_industry_map
BoardInfo 板块列表条目(含领涨股) get_boards
MemberQuote 成分股报价(MAC 原始字段) 旧 get_stock_quotes / get_stock_quotes_list
BelongBoard 个股所属板块 get_board_of
AuctionItem 集合竞价撮合点 get_auction
UnusualItem 一笔市场异动 get_unusual
SymbolSnapshot 个股特征快照 get_snapshot
GoodsItem 扩展市场商品 旧 get_goods_list
ServerInfo 服务器交易时段 get_server_info
CapitalFlow 个股资金流向 get_capital_flow
MarketStat 全市场统计 get_market_stat
FileMeta 远程文件元信息 get_file_meta

!!! warning "FinanceRecord vs FinancialRecord 只差一个字母" 但它们完全不同:

| | `FinanceRecord` | `FinancialRecord` |
|---|---|---|
| 来源 | `get_finance()` — 标准通道 | `get_financial_records_parsed()` — 服务器文件 |
| 内容 | **最新一期**财务快照 | **历史多报告期**专业财报 |
| 结构 | 具名属性(`zongguben`、`jingzichan` ...) | `fields: list[float]`,原始字段数组 |
| 单位 | 万元 / 万股 | 原始 float,需自行按字段语义换算 |

完整字段定义

以下由 mkdocstrings 从源码实时渲染(以源码为准):

::: pytdxdata.models options: members_order: source show_root_heading: false show_root_toc_entry: false filters: - "!^_"

下一步