easy-tdx/docs/field_mapping.md

easy_tdx 字段映射表

模型字段名 ↔ 中文含义 ↔ 数据类型对照

---

SecurityInfo（证券列表条目）

来源：get_security_list() / get_security_list_all()

字段名	中文	类型	说明
market	市场	Market	SZ=深圳, SH=上海, BJ=北京
code	证券代码	str	6 位代码，如 "600000"
name	证券名称	str	GBK 解码
volunit	成交量单位	int	1 手 = volunit 股
decimal_point	价格小数位	int	通常为 2
pre_close	昨收价	float	通达信自定义浮点
industry_tdx	通达信行业	str	如 "T1001"，需 get_security_list_all()
industry_sw	申万行业	str	如 "X500102"，需 get_security_list_all()

---

SecurityQuote（实时五档行情）

来源：get_security_quotes()

字段名	中文	类型	说明
market	市场	Market
code	证券代码	str
price	现价	float	当前最新成交价
pre_close	昨收价	float	昨日收盘价
open	今开	float	今日开盘价
high	最高	float	今日最高价
low	最低	float	今日最低价
vol	总成交量	float	单位：手
cur_vol	当前成交量	float
amount	成交额	float	单位：元
s_vol	内盘	float	主动卖出成交量
b_vol	外盘	float	主动买入成交量
active1	活跃度1	int	含义待确认
active2	活跃度2	int	含义待确认
bid1 ~ bid5	买一~买五价	float
bid_vol1 ~ bid_vol5	买一~买五量	float
ask1 ~ ask5	卖一~卖五价	float
ask_vol1 ~ ask_vol5	卖一~卖五量	float
rise_speed	涨速	float
limit_up	涨停价	float | None	需 get_price_limits() 计算
limit_down	跌停价	float | None	需 get_price_limits() 计算
server_time	服务器时间	str	格式 HH:MM:SS.mmm

---

SecurityBar（K 线数据）

来源：get_security_bars() / get_index_bars()

字段名	中文	类型	说明
open	开盘价	float
close	收盘价	float
high	最高价	float
low	最低价	float
vol	成交量	float	单位：股
amount	成交额	float	单位：元
year	年	int
month	月	int
day	日	int
hour	时	int	日线为 0
minute	分	int	日线为 0
datetime_str	时间字符串	str	属性，格式 YYYY-MM-DD HH:MM

---

MinuteBar（分时数据）

来源：get_minute_time_data() / get_history_minute_time_data()

字段名	中文	类型	说明
price	价格	float
vol	成交量	int

---

TransactionRecord（逐笔成交）

来源：get_transaction_data() / get_history_transaction_data()

字段名	中文	类型	说明
hour	时	int
minute	分	int
price	成交价	float
vol	成交量	int
buyorsell	买卖方向	int	0=买, 1=卖, 2=中性, 8=集合竞价

---

XdxrRecord（除权除息记录）

来源：get_xdxr_info()

字段名	中文	类型	说明
market	市场	Market
code	证券代码	str
year	年	int
month	月	int
day	日	int
category	事件类型	int	见 XDXR_CATEGORY_NAMES
name	事件名称	str
fenhong	每股分红	float | None	元，category=1
peigujia	配股价	float | None	元/股，category=1
songzhuangu	每股送转股比例	float | None	category=1
peigu	每股配股比例	float | None	category=1
suogu	缩股比例	float | None	category=11,12
xingquanjia	行权价	float | None	category=13,14
fenshu	分数	float | None	category=13,14
panqian_liutong	盘前流通股本	float | None	万股，category=2~10
panhou_liutong	盘后流通股本	float | None	万股，category=2~10
qian_zongguben	前总股本	float | None	万股，category=2~10
hou_zongguben	后总股本	float | None	万股，category=2~10

XDXR_CATEGORY_NAMES（事件类型映射）

category	名称
1	除权除息
2	送配股上市
3	非流通股上市
4	未知股本变动
5	股本变化
6	增发新股
7	股份回购
8	增发新股上市
9	转配股上市
10	可转债上市
11	扩缩股
12	非流通股缩股
13	送认购权证
14	送认沽权证

---

FinanceInfo（最新财务数据）

来源：get_finance_info()

股本结构（单位：万股）

字段名	中文
liutong_guben	流通股本
zong_guben	总股本
guojia_gu	国家股
faqiren_faren_gu	发起人法人股
faren_gu	法人股
b_gu	B股
h_gu	H股
zhigong_gu	职工股

基本信息

字段名	中文	类型
province	省份代码	int
industry	行业代码	int
updated_date	财务更新日期	int
ipo_date	上市日期	int
gudong_renshu	股东人数	float

资产负债（单位：元）

字段名	中文
zong_zichan	总资产
liudong_zichan	流动资产
guding_zichan	固定资产
wuxing_zichan	无形资产
liudong_fuzhai	流动负债
changqi_fuzhai	长期负债
ziben_gongjijin	资本公积金
jing_zichan	净资产

利润指标（单位：元）

字段名	中文
zhuying_shouru	主营收入
zhuying_lirun	主营利润
yingshou_zhangkuan	应收账款
yingye_lirun	营业利润
touzi_shouyu	投资收益
jingying_xianjinliu	经营现金流
zong_xianjinliu	总现金流
cunhuo	存货
lirun_zonghe	利润总额
shuihou_lirun	税后利润
jing_lirun	净利润
weifen_lirun	未分配利润

每股指标

字段名	中文	说明
meigujing_zichan	每股净资产	原协议字段 baoliu1

---

CompanyInfoCategory（公司信息目录）

来源：get_company_info_category()

字段名	中文	类型	说明
name	目录名	str	如 "最新提示"
filename	文件名	str	如 "600000.txt"
start	起始偏移	int	字节偏移
length	内容长度	int	字节数

---

TdxBlock（板块信息）

来源：get_block_info()

字段名	中文	类型	说明
name	板块名称	str	如 "房地产"
category	板块分类	int	0=行业, 1=地域, 2=概念, 3=风格
count	成分股数	int
codes	成分股代码	list[str]	6 位代码列表

---

MarketStat（市场统计）

来源：get_market_stat()

字段名	中文	类型	说明
up_count	上涨家数	int
down_count	下跌家数	int
neutral_count	平盘家数	int
suspended_count	停牌(估算)	int	残差：total - up - down - neutral
total_count	总计	int
total_amount	总成交额	float	元
total_volume	总成交量	float
total_market_cap	总市值	float	元，880001 price × 1e10
limit_up_count	涨停家数	int	880006 price
limit_down_count	跌停家数	int	880006 open

---

FundFlow（资金流向）

来源：get_fund_flow()

字段名	中文	类型	说明
super_in	超大单流入	float	单笔 >100 万
super_out	超大单流出	float
large_in	大单流入	float	20~100 万
large_out	大单流出	float
medium_in	中单流入	float	4~20 万
medium_out	中单流出	float
small_in	小单流入	float	≤4 万
small_out	小单流出	float
main_net_inflow	主力净流入	float	属性：超大+大
total_net_inflow	全单净流入	float	属性：全部

---

HistoricalFundFlow（历史资金流向）

来源：get_history_fund_flow()

字段同 FundFlow，额外包含：

字段名	中文	类型
year	年	int
month	月	int
day	日	int

---

枚举

Market（市场）

值	名称	说明
0	SZ	深圳
1	SH	上海
2	BJ	北京

KlineCategory（K 线周期）

值	名称	说明
0	MIN_5	5 分钟
1	MIN_15	15 分钟
2	MIN_30	30 分钟
3	MIN_60	60 分钟
4	DAY	日线
5	WEEK	周线
6	MONTH	月线
7	MIN_1	1 分钟
8	MIN_3	3 分钟（内部用）
9	YEAR	年线
10	SEASON	季线
11	YEAR_ALT	年线（备用）