7709-指定日期历史分时¶

作用¶

按日期查询某天的历史分时价格和分钟成交量，适合补单日历史分时。

项目	内容
主要调用 · 单只	`client.minutes.history(code, trading_date)` → `MinuteSeries`
代码列表	`client.minutes.history([code1, code2], trading_date, batch_size=...)` → `dict[str, MinuteSeries]`
底层接口	`0x0fb4`

这个接口按明确日期查询。另一个“近期历史分时”接口覆盖窗口更短，但会多返回今开和均价字段。

示例¶

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    series = client.minutes.history("sz000001", "2026-05-20")
    series_by_code = client.minutes.history(
        ["sz000001", "sh600000"], "2026-05-20", batch_size=8
    )

参数¶

参数	含义
`code`	单个证券代码或代码列表；支持完整代码或六位代码
`trading_date`	交易日期
`include_raw`	是否保留原始 payload，默认 `False`
`batch_size`	代码列表输入时的同时查询数，默认自动跟随连接池大小

真实返回样本¶

Python 实际返回 MinuteSeries。下面从 to_jsonable(series) 中选取开盘后两分钟和 15:00 三个分时点；完整结果为 240 个点。

真实返回 JSON · MinuteSeries（3 个分时点节选）

采样标的sz000001

交易日期2026-08-14

返回类型MinuteSeries

真实采样；完整返回 240 个分时点，JSON 仅作结构展示。

{
  "exchange": "sz",
  "market_id": 0,
  "code": "000001",
  "trading_date": "2026-08-14",
  "prev_close": 11.25,
  "points": [
    {
      "index": 0,
      "time_label": "09:31",
      "time": "2026-08-14T09:31:00+08:00",
      "price": 11.21,
      "price_milli": 11210,
      "volume": 19938
    },
    {
      "index": 1,
      "time_label": "09:32",
      "time": "2026-08-14T09:32:00+08:00",
      "price": 11.2,
      "price_milli": 11200,
      "volume": 8863
    },
    {
      "index": 239,
      "time_label": "15:00",
      "time": "2026-08-14T15:00:00+08:00",
      "price": 11.11,
      "price_milli": 11110,
      "volume": 11639
    }
  ]
}

参数¶

参数	含义
`code`	单个证券代码或代码列表；支持完整代码或六位代码
`trading_date`	交易日，支持 `YYYY-MM-DD`、`YYYYMMDD`、`date` / `datetime`
`include_raw`	是否保留原始 payload，默认 `False`
`batch_size`	代码列表输入时的同时查询数，默认自动跟随连接池大小

解析字段¶

`MinuteSeries` 字段	含义
`exchange` / `market_id` / `code` / `full_code`	市场和代码
`trading_date`	交易日
`prev_close`	昨收
`open_price`	今开；历史接口可能为 `None`
`reserved_zero`	响应头保留字段；可能为 `None`
`date_selector_raw`	日期选择器原始值；历史接口可能为 `None`
`points`	分时点列表
`count`	分时点数量
`volume_sum`	分时成交量合计
`raw_payload`	原始 payload

`MinutePoint` 字段	含义
`index`	分时序号
`time_label` / `time`	时间文本 / 带日期时间
`price` / `price_milli`	当前价格 / 毫厘价
`volume`	该分钟成交量，单位手
`avg_price`	均价；历史接口可能为 `None`
`price_field` / `avg_field`	协议原始价格 / 均价字段；缺失时为 `None`
`avg_raw`	均价原始口径；缺失时为 `None`
`price_delta_raw` / `aux_delta_raw`	协议差分原始字段
`price_raw`	价格差分累计后的原始价格口径
`record_hex`	单条原始十六进制

使用建议¶

场景	建议
要指定很早的某一天	优先用这个接口
只查近期交易日且想要均价 / 今开	可以用 7709-近期历史分时.md
不传日期查主站当日数据	用 7709-当日分时.md