全市场快照

snapshot

全市场行情快照（盘中 session）

竞价与盘口 15 个字段
数据窗口：不传日期时返回最新一个交易日；也可按代码或日期范围过滤。 请求需携带有效 Token，接口地址为 https://api.mquant.com.cn/data/v1。

请求参数 9 项

参数类型说明必填
code 字符串 与 ts_code 等价，支持纯数字代码 可选
end_date 日期 YYYYMMDD 或 YYYY-MM-DD，含当日 可选
fields 字符串 逗号分隔的字段名，缺省返回全部字段 可选
limit 整数 默认 1000，上限由账号单次返回行数决定 可选
offset 整数 用于分页，配合 has_more 使用 可选
session 字符串 竞价或盘中时段标识，缺省返回当日最新 可选
start_date 日期 YYYYMMDD 或 YYYY-MM-DD，含当日 可选
trade_date 日期 YYYYMMDD 或 YYYY-MM-DD；与开始/结束日期互斥 可选
ts_code 字符串 支持 600519.SH / 600519，多个用英文逗号分隔，上限 50 个 可选

请求示例

Python · MQData SDK 
from mq_data import MQData

client = MQData(token="你的 Token")
rows = client.snapshot(trade_date="20260105", session="close", limit=100)
print(rows)
cURL · HTTP 
curl -X POST https://api.mquant.com.cn/data/v1 \
  -H "X-API-Token: $MQ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"api_name": "snapshot", "params": {"trade_date": "20260105", "session": "close", "limit": 100}}'

返回字段 15 个

字段说明类型 / 单位
trade_date 交易日期 日期 YYYYMMDD
session session 原值
ts_code 股票代码 证券代码（带后缀）
name 名称 原值
price 价格 原值
pct 涨跌幅 原值
volume 成交量 原值
amount 成交额（千元） 原值
turnover_rate 换手率 原值
speed 涨速 原值
captured_at 快照时间 原值
open 开盘价 原值
high 最高价 原值
low 最低价 原值
pre_close 昨收价 原值

响应示例

JSON · 标准响应 
{
  "code": 0,
  "msg": null,
  "data": {
    "fields": [
      "trade_date",
      "session",
      "ts_code",
      "name"
    ],
    "items": [
      [
        "20260105",
        "示例值",
        "600519.SH",
        "示例值"
      ]
    ],
    "has_more": false
  }
}

错误码

HTTP / code含义处理建议
400参数错误检查参数名、日期格式与日期跨度
401Token 无效确认 Token 完整、未被删除
403Token 无权限或账号停用在控制台检查 Token 状态
429超过配额降低频率，或等待下一分钟 / 次日
503服务暂不可用稍后重试；持续出现请查看服务状态