免费版
开放注册¥0 / 永久
适合个人研究、课程作业与策略原型。
- 每分钟 30 次请求
- 每日 5,000 次请求
- 单次最多返回 2,000 行
- 最多创建 10 个 Token
- 全部 51 个语义化接口
- 控制台配额与调用记录
Getting Started
接入指南
幂·量化使用统一的请求与响应协议。已有接入代码只需替换接口地址与 Token；新项目可以直接使用零依赖 Python SDK。
Quick Start
四步完成第一次调用
01
02
创建 Token
登录后在「控制台 → Token 管理」创建 Token。完整 Token 只在创建成功时显示一次，请立即保存；之后只能看到前缀。
03
04
发起请求
向 https://api.mquant.com.cn/data/v1 发送 POST JSON 或 GET 查询。请求头、请求体与响应格式如下。
POST /data/v1
curl -X POST https://api.mquant.com.cn/data/v1 \
-H "X-API-Token: $MQ_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_name": "limit_list_d", "params": {"trade_date": "20261106", "limit": 100}}'Python 用户可下载零依赖 SDK mq_data.py，保存到项目目录后按文档示例调用。SDK 默认自动翻页；安装 pandas 时返回 DataFrame，未安装时返回包含 fields、items、has_more 的字典。
Protocol
请求与响应协议
所有语义化接口共用同一套协议；返回的 fields 顺序固定，items 为二维数组，一行为一条记录。
请求方式
POST JSON 或 GET 查询参数二选一。
鉴权方式
以下三种任选其一，推荐使用请求头。
三种 Token 传递方式
X-API-Token: mq_xxxxxxxxxxxxxxxx
Authorization: Bearer mq_xxxxxxxxxxxxxxxx
{"token": "mq_xxxxxxxxxxxxxxxx", "api_name": "..."}请求体示例
JSON
{
"api_name": "daily",
"token": "mq_xxxxxxxxxxxxxxxx",
"params": {
"ts_code": "600519.SH",
"start_date": "20260101",
"end_date": "20260131",
"adjust": "qfq"
},
"fields": "ts_code,trade_date,close,pct_chg"
}响应结构
JSON
{
"code": 0,
"msg": null,
"data": {
"fields": ["ts_code", "trade_date", "close", "pct_chg"],
"items": [["600519.SH", "20260105", 1688.0, 1.25]],
"has_more": false
}
}code 为 0 表示成功；非 0 时 msg 为错误原因，data 为 null。HTTP 状态码与 code 一致。
Conventions
数据口径约定
为了避免不同接口之间出现隐式差异，以下口径在接口层统一处理。
| 项目 | 约定 | 示例 |
|---|---|---|
| 证券代码 | 统一返回 ts_code，带交易所后缀 | 600519.SH / 000001.SZ / 920001.BJ |
| 日期 | 请求支持 YYYYMMDD 或 YYYY-MM-DD，返回统一 YYYYMMDD | 20260105 |
| 日 / 周 / 月 K | vol 单位为手，amount 单位为千元 | vol=12340 表示 1,234,000 股 |
| 复权 | 库内不复权存储，adjust=qfq/hfq 现算复权价 | adjust=qfq |
| 当日数据 | 不传日期时按接口窗口返回最新交易日或最近 7 天 | latest / days |
| 分页 | 使用 limit 与 offset，返回 has_more 提示是否还有下一页 | limit=1000&offset=1000 |
| 字段裁剪 | fields 只接受接口已声明的字段名，返回顺序按接口定义 | fields=ts_code,trade_date,close |
| 空数据 | 非交易日、尚未更新或过滤无结果时返回空数组，不视为错误 | items=[] |
Limits
配额与套餐
配额按账号计量，同一账号下的所有 Token 共享额度；停用或删除 Token 不会重置已用额度。
定制配额
按需 / 联系管理员
适合团队研究、批量回测与更高频的盘中任务。
- 更高的分钟 / 每日配额
- 更大的单次返回行数
- 按账号配置的独立额度
- 批量历史数据导出协商
- 优先的数据问题响应
说明：免费额度用于研究与学习。请勿将接口用于商业转售、批量爬取或对服务造成压力的高频轮询；
超出配额会返回
429，连续触发可能被临时限制。
Errors
错误码与处理
| HTTP / code | 含义 | 常见原因 | 处理建议 |
|---|---|---|---|
| 400 | 参数错误 | 未知参数、日期格式错误、日期跨度超限、缺少必要窗口 | 对照接口文档检查参数名与格式 |
| 401 | Token 无效 | Token 为空、复制不完整、已被删除 | 重新创建 Token 并更新配置 |
| 403 | 无权限 | Token 已停用、账号被停用 | 在控制台检查状态或联系管理员 |
| 429 | 超过配额 | 分钟或每日请求次数超限 | 降低频率，等待下一分钟或次日重试 |
| 503 | 服务不可用 | 账号服务或数据库暂时不可达 | 指数退避重试；持续出现请联系管理员 |
FAQ
常见问题
大部分可以。请求结构、fields / items 响应、ts_code 与日期格式保持稳定。需要把接口地址改为 https://api.mquant.com.cn/data/v1，并把 token 换成幂·量化的 Token。个别接口的可用字段以本页文档为准。
不同数据域有各自的更新时间。盘中快照按 session 生成，日 K 与榜单在收盘后逐步更新；非交易日不会产生新数据。空数组本身不是错误，可以稍后重试。
服务端只保存 Token 的哈希，无法找回原值。请在控制台删除旧 Token 并创建一个新的，然后更新调用方配置。删除后旧 Token 立即失效。
按账号计量可以避免通过创建多个 Token 绕过限额。所有 Token 共享同一份额度，但每个 Token 的调用记录会分别记录，便于排查问题。
默认授权仅限研究与学习用途。如需用于商业产品、对外分发或批量导出，请先联系管理员获得书面许可。数据不构成任何投资建议。