证券主表
stock_basic证券主表(代码、名称、交易所、板块、上市退市日)
数据窗口:全量维表,建议配合 limit / offset 或过滤条件使用。
请求需携带有效 Token,接口地址为
https://api.mquant.com.cn/data/v1。
请求参数 12 项
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
board |
字符串 | 主板 / 创业板 / 科创板 / 北交所 | 可选 |
code |
字符串 | 与 ts_code 等价,支持纯数字代码 | 可选 |
end_date |
日期 | YYYYMMDD 或 YYYY-MM-DD,含当日 | 可选 |
exchange |
字符串 | SSE / SZSE / BSE 或 SH / SZ / BJ | 可选 |
fields |
字符串 | 逗号分隔的字段名,缺省返回全部字段 | 可选 |
industry |
字符串 | 按行业名称过滤 | 可选 |
limit |
整数 | 默认 1000,上限由账号单次返回行数决定 | 可选 |
list_status |
字符串 | L 上市 / D 退市 / P 暂停上市 | 可选 |
offset |
整数 | 用于分页,配合 has_more 使用 | 可选 |
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.stock_basic(list_status="L", limit=10)
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": "stock_basic", "params": {"list_status": "L", "limit": 10}}'
返回字段 10 个
| 字段 | 说明 | 类型 / 单位 |
|---|---|---|
ts_code |
股票代码 | 证券代码(带后缀) |
symbol |
证券代码 | 原值 |
name |
名称 | 原值 |
exchange |
交易所 | 原值 |
board |
板块 | 原值 |
market |
市场 | 原值 |
industry |
行业 | 原值 |
list_date |
上市日期 | 日期 YYYYMMDD |
delist_date |
退市日期 | 日期 YYYYMMDD |
list_status |
上市状态 | 原值 |
响应示例
JSON · 标准响应
{
"code": 0,
"msg": null,
"data": {
"fields": [
"ts_code",
"symbol",
"name",
"exchange"
],
"items": [
[
"600519.SH",
"示例值",
"示例值",
"示例值"
]
],
"has_more": false
}
}
错误码
| HTTP / code | 含义 | 处理建议 |
|---|---|---|
| 400 | 参数错误 | 检查参数名、日期格式与日期跨度 |
| 401 | Token 无效 | 确认 Token 完整、未被删除 |
| 403 | Token 无权限或账号停用 | 在控制台检查 Token 状态 |
| 429 | 超过配额 | 降低频率,或等待下一分钟 / 次日 |
| 503 | 服务暂不可用 | 稍后重试;持续出现请查看服务状态 |