MAC-EX 返回模型¶

模型为 Python dataclass（动态报价字段为 dict），不依赖 pandas。下表列出当前实际字段；同名字段在不同协议中的单位不保证相同。示例 JSON 序列化可用 eltdx.to_jsonable，日期/时间应保留所选市场和请求日期。

MacQuoteField¶

字段	Python 类型	含义与口径
`market`	`int`	市场编号，按当前协议的市场表解释。
`code`	`str`	证券/合约代码字符串，保留前导零。
`name`	`str`	名称文本；GoodsItem 的特殊语义见该模型。
`fields`	`dict[str, Any]`	按请求位图解析的动态字典；键名为 FieldBit.field_name。

MacSymbolInfo¶

字段	Python 类型	含义与口径
`market`	`int`	市场编号，按当前协议的市场表解释。
`code`	`str`	证券/合约代码字符串，保留前导零。
`name`	`str`	名称文本；GoodsItem 的特殊语义见该模型。
`time`	`datetime \\| None`	服务器完整日期时间或 None，无时区。
`activity`	`int`	服务端活跃度。
`pre_close`	`float`	前收/前参考值；基金及宏观指标按各自业务口径。
`open`	`float`	开盘/周期起值。
`high`	`float`	区间最高值。
`low`	`float`	区间最低值。
`close`	`float`	最新/周期结束值；宏观为报告值、基金可能为净值。
`momentum`	`float`	服务端涨跌/动量字段，未作统一百分比换算。
`vol`	`int`	服务端数量原值；不同市场和品种的数量单位需单独核对。
`amount`	`float`	服务端金额字段；EX K 线的特殊映射见对应页面。
`inside_volume`	`int`	内盘原始量。
`outside_volume`	`int`	外盘原始量。
`turnover`	`float`	服务端换手字段，保留原值。
`avg`	`float`	服务端平均价。

MacBar¶

字段	Python 类型	含义与口径
`datetime`	`datetime`	服务器日期时间，无时区；时间起止口径见调用参数。
`open`	`float`	开盘/周期起值。
`high`	`float`	区间最高值。
`low`	`float`	区间最低值。
`close`	`float`	最新/周期结束值；宏观为报告值、基金可能为净值。
`vol`	`float`	服务端数量原值；不同市场和品种的数量单位需单独核对。
`amount`	`float`	服务端金额字段；EX K 线的特殊映射见对应页面。
`float_shares`	`float`	协议流通量字段，保持原值，未统一股/万股口径。

MacTick¶

字段	Python 类型	含义与口径
`time`	`time`	当日时间，无日期与时区；MacSymbolInfo 为完整 datetime。
`price`	`float`	当前解析得到的价格；EX 成交 price 是整数原值，MAC price 是浮点值。
`avg`	`float`	服务端平均价。
`vol`	`int`	服务端数量原值；不同市场和品种的数量单位需单独核对。
`momentum`	`float`	服务端涨跌/动量字段，未作统一百分比换算。

MacTickChart¶

字段	Python 类型	含义与口径
`market`	`int`	市场编号，按当前协议的市场表解释。
`code`	`str`	证券/合约代码字符串，保留前导零。
`name`	`str`	名称文本；GoodsItem 的特殊语义见该模型。
`pre_close`	`float`	前收/前参考值；基金及宏观指标按各自业务口径。
`open`	`float`	开盘/周期起值。
`high`	`float`	区间最高值。
`low`	`float`	区间最低值。
`close`	`float`	最新/周期结束值；宏观为报告值、基金可能为净值。
`vol`	`int`	服务端数量原值；不同市场和品种的数量单位需单独核对。
`amount`	`float`	服务端金额字段；EX K 线的特殊映射见对应页面。
`turnover`	`float`	服务端换手字段，保留原值。
`avg`	`float`	服务端平均价。
`charts`	`list[MacTick]`	曲线列表；单日为 MacTick，多日为 MacMultiTickDay。

MacMultiTickDay¶

字段	Python 类型	含义与口径
`date`	`date`	交易日期；CapitalFlowData 当前固定为空字符串。
`pre_close`	`float`	前收/前参考值；基金及宏观指标按各自业务口径。
`ticks`	`list[MacTick]`	该日的 MacTick 采样点列表。

MacMultiTickChart¶

字段	Python 类型	含义与口径
`market`	`int`	市场编号，按当前协议的市场表解释。
`code`	`str`	证券/合约代码字符串，保留前导零。
`name`	`str`	名称文本；GoodsItem 的特殊语义见该模型。
`pre_close`	`float`	前收/前参考值；基金及宏观指标按各自业务口径。
`open`	`float`	开盘/周期起值。
`high`	`float`	区间最高值。
`low`	`float`	区间最低值。
`close`	`float`	最新/周期结束值；宏观为报告值、基金可能为净值。
`vol`	`int`	服务端数量原值；不同市场和品种的数量单位需单独核对。
`amount`	`float`	服务端金额字段；EX K 线的特殊映射见对应页面。
`turnover`	`float`	服务端换手字段，保留原值。
`avg`	`float`	服务端平均价。
`charts`	`list[MacMultiTickDay]`	曲线列表；单日为 MacTick，多日为 MacMultiTickDay。

MacTransaction¶

字段	Python 类型	含义与口径
`time`	`time`	当日时间，无日期与时区；MacSymbolInfo 为完整 datetime。
`price`	`float`	当前解析得到的价格；EX 成交 price 是整数原值，MAC price 是浮点值。
`vol`	`int`	服务端数量原值；不同市场和品种的数量单位需单独核对。
`trade_count`	`int`	服务端成交笔数；聚合记录可 >1，港股 EX 转换模型固定为 0（未提供）。
`bs_flag`	`int`	原始买卖/状态值；MAC 常见 0=买、1=卖、2=中性、5=盘后；跨市场需核对。

BoardInfo¶

字段	Python 类型	含义与口径
`market`	`int`	市场编号，按当前协议的市场表解释。
`code`	`str`	证券/合约代码字符串，保留前导零。
`name`	`str`	名称文本；GoodsItem 的特殊语义见该模型。
`price`	`float`	当前解析得到的价格；EX 成交 price 是整数原值，MAC price 是浮点值。
`rise_speed`	`float`	板块涨速原值，不是计算后的日涨幅。
`pre_close`	`float`	前收/前参考值；基金及宏观指标按各自业务口径。
`symbol_market`	`int`	领涨证券的市场。
`symbol_code`	`str`	领涨证券代码。
`symbol_name`	`str`	领涨证券名称。
`symbol_price`	`float`	领涨证券最新价格。
`symbol_rise_speed`	`float`	领涨证券涨速。
`symbol_pre_close`	`float`	领涨证券前收。

AuctionItem¶

字段	Python 类型	含义与口径
`time`	`time`	当日时间，无日期与时区；MacSymbolInfo 为完整 datetime。
`price`	`float`	当前解析得到的价格；EX 成交 price 是整数原值，MAC price 是浮点值。
`matched`	`int`	虚拟匹配量原值，不代表已完成成交。
`unmatched`	`int`	带符号的未匹配量原值；保留符号。

UnusualItem¶

字段	Python 类型	含义与口径
`index`	`int`	协议序号/索引；商品索引不是永久证券 ID。
`market`	`int`	市场编号，按当前协议的市场表解释。
`code`	`str`	证券/合约代码字符串，保留前导零。
`name`	`str`	名称文本；GoodsItem 的特殊语义见该模型。
`time`	`time`	当日时间，无日期与时区；MacSymbolInfo 为完整 datetime。
`desc`	`str`	描述文本。
`value`	`str`	已格式化异动值，可能含 %、倍数或组合文本。
`unusual_type`	`int`	异动类型原始编号。

CapitalFlowData¶

字段	Python 类型	含义与口径
`date`	`str`	交易日期；CapitalFlowData 当前固定为空字符串。
`main_in`	`float`	当日主力流入原值。
`main_out`	`float`	当日主力流出原值。
`main_net`	`float`	main_in-main_out。
`small_in`	`float`	当日散户流入原值。
`small_out`	`float`	当日散户流出原值。
`small_net`	`float`	small_in-small_out。
`mid_in`	`float`	当前映射固定 0，未提供此字段。
`mid_out`	`float`	当前映射固定 0，未提供此字段。
`mid_net`	`float`	当前从第二组数据取五日值，不是当日中单净额。
`large_in`	`float`	当前映射固定 0，未提供此字段。
`large_out`	`float`	当前映射固定 0，未提供此字段。
`large_net`	`float`	当前从第二组数据取五日值，不是当日大单净额。

BelongBoardInfo¶

字段	Python 类型	含义与口径
`board_type`	`int`	板块类型编号。
`market`	`int`	市场编号，按当前协议的市场表解释。
`board_code`	`str`	板块展示代码。
`board_name`	`str`	板块中文名称。
`close`	`float`	最新/周期结束值；宏观为报告值、基金可能为净值。
`pre_close`	`float`	前收/前参考值；基金及宏观指标按各自业务口径。

ServerSession¶

字段	Python 类型	含义与口径
`today`	`str`	服务器当日日期文本。
`last_trading_day`	`str`	服务器最近交易日文本。
`sessions_1`	`list[dict[str, Any]]`	第一组四个交易时段字典，每项只含 open、close，时间格式为 H:MM。
`sessions_2`	`list[dict[str, Any]]`	第二组四个交易时段字典，每项只含 open、close，时间格式为 H:MM。
`market_param_1`	`int`	原始市场参数 1，尚未赋予统一业务语义。
`market_param_2`	`int`	原始市场参数 2，尚未赋予统一业务语义。

KlineOffsetInfo¶

字段	Python 类型	含义与口径
`total`	`int`	协议报告的总量。
`returned`	`int`	当前响应的返回数量。

GoodsItem¶

字段	Python 类型	含义与口径
`name`	`str`	本协议通常存代码，如 1_GDP / IFL0；不是保证的中文名称。
`category`	`int`	商品/市场类别原始编号，与 K 线周期 category 并非同一概念。
`u`	`int`	保留的原始协议字段 u，未建立稳定业务语义。
`index`	`int`	协议序号/索引；商品索引不是永久证券 ID。
`switch`	`int`	保留的原始协议开关值。
`code`	`list[float]`	三个浮点协议槽位，非证券代码字符串；回退路径也可能填浮点占位。
`c1`	`int`	保留的原始协议字段 c1。
`c2`	`int`	保留的原始协议字段 c2。

FileMeta¶

字段	Python 类型	含义与口径
`offset`	`int`	文件偏移原值，单位字节。
`size`	`int`	文件大小，单位字节。
`flag`	`int`	原始标志位。
`hash`	`str`	服务器哈希文本，不承诺具体算法。

ExMarketInfo¶

字段	Python 类型	含义与口径
`market`	`int`	市场编号，按当前协议的市场表解释。
`category`	`int`	商品/市场类别原始编号，与 K 线周期 category 并非同一概念。
`name`	`str`	名称文本；GoodsItem 的特殊语义见该模型。
`short_name`	`str`	市场简称。
`_raw`	`bytes`	本条原始记录字节，供复核；JSON 展示时需自行编码。

ExInstrumentInfo¶

字段	Python 类型	含义与口径
`category`	`int`	商品/市场类别原始编号，与 K 线周期 category 并非同一概念。
`market`	`int`	市场编号，按当前协议的市场表解释。
`code`	`str`	证券/合约代码字符串，保留前导零。
`name`	`str`	名称文本；GoodsItem 的特殊语义见该模型。
`desc`	`str`	描述文本。
`_raw`	`bytes`	本条原始记录字节，供复核；JSON 展示时需自行编码。

ExInstrumentQuote¶

字段	Python 类型	含义与口径
`market`	`int`	市场编号，按当前协议的市场表解释。
`code`	`str`	证券/合约代码字符串，保留前导零。
`pre_close`	`float`	前收/前参考值；基金及宏观指标按各自业务口径。
`open`	`float`	开盘/周期起值。
`high`	`float`	区间最高值。
`low`	`float`	区间最低值。
`price`	`float`	当前解析得到的价格；EX 成交 price 是整数原值，MAC price 是浮点值。
`kaicang`	`int`	开仓原始值。
`zongliang`	`int`	总量原始值。
`xianliang`	`int`	现量原始值。
`neipan`	`int`	内盘原始值。
`waipan`	`int`	外盘原始值。
`chicang`	`int`	持仓原始值。
`bid1`	`float`	买1档价格。
`bid2`	`float`	买2档价格。
`bid3`	`float`	买3档价格。
`bid4`	`float`	买4档价格。
`bid5`	`float`	买5档价格。
`bid_vol1`	`int`	买1档数量原值。
`bid_vol2`	`int`	买2档数量原值。
`bid_vol3`	`int`	买3档数量原值。
`bid_vol4`	`int`	买4档数量原值。
`bid_vol5`	`int`	买5档数量原值。
`ask1`	`float`	卖1档价格。
`ask2`	`float`	卖2档价格。
`ask3`	`float`	卖3档价格。
`ask4`	`float`	卖4档价格。
`ask5`	`float`	卖5档价格。
`ask_vol1`	`int`	卖1档数量原值。
`ask_vol2`	`int`	卖2档数量原值。
`ask_vol3`	`int`	卖3档数量原值。
`ask_vol4`	`int`	卖4档数量原值。
`ask_vol5`	`int`	卖5档数量原值。
`_raw`	`bytes`	本条原始记录字节，供复核；JSON 展示时需自行编码。

ExInstrumentBar¶

字段	Python 类型	含义与口径
`open`	`float`	开盘/周期起值。
`high`	`float`	区间最高值。
`low`	`float`	区间最低值。
`close`	`float`	最新/周期结束值；宏观为报告值、基金可能为净值。
`position`	`int`	持仓/位置原始字段；不同 EX K 线命令的相邻字段语义需单独核对。
`trade`	`int`	成交数量原始字段，不自动转换手数。
`amount`	`float`	普通 EX bar 对 position 的相同字节作 float 解释；范围 bar 映射 settlement，均不可直接当统一成交额。
`year`	`int`	年份。
`month`	`int`	月份。
`day`	`int`	月内日期。
`hour`	`int`	时。
`minute`	`int`	分。
`_raw`	`bytes`	本条原始记录字节，供复核；JSON 展示时需自行编码。

ExMinuteBar¶

字段	Python 类型	含义与口径
`hour`	`int`	时。
`minute`	`int`	分。
`price`	`float`	当前解析得到的价格；EX 成交 price 是整数原值，MAC price 是浮点值。
`avg_price`	`float`	服务端分时平均价。
`volume`	`int`	成交/分时数量原值，未统一股数或手数。
`open_interest`	`int`	EX 分时最后一个 uint32 的映射名，业务语义按市场核对。
`_raw`	`bytes`	本条原始记录字节，供复核；JSON 展示时需自行编码。

ExTransactionRecord¶

字段	Python 类型	含义与口径
`hour`	`int`	时。
`minute`	`int`	分。
`second`	`int`	秒；传统 EX 解析遇非法秒会置 0。
`price`	`int`	整数原始价；港股统一封装另做 /1000，直接 EX 调用不换算。
`volume`	`int`	成交/分时数量原值，未统一股数或手数。
`zengcang`	`int`	增仓原始带符号整数。
`nature`	`int`	direction//10000 得到的方向/性质编号。
`_raw`	`bytes`	本条原始记录字节，供复核；JSON 展示时需自行编码。

ExHostProbe¶

EX 连接健康探测结果，定义在 src/eltdx/ex/transport/sync.py。

字段	Python 类型	含义
`host`	`str`	候选主机地址。
`ok`	`bool`	本次业务探活是否成功，不保证所有命令可用。
`latency_ms`	`float \\| None`	业务探活延迟，单位毫秒；失败等情形可为 None。
`error`	`str \\| None`	失败原因文本；成功可为 None。

返回完整索引