市场排行¶
来源同步:
/Users/mac/Projects/chatgpt-codex/doc/api_Ranking.md所属接口集:
排行榜
请求 URL¶
GET /v1/api/rank/market
认证方式¶
Bearer Token(详见 认证与签名)
接口概述¶
市场排行榜,支持涨幅榜、跌幅榜、资金榜和板块榜四种类型,结果有 5 分钟缓存。
请求参数¶
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 排行类型:gainers(涨幅榜)、losers(跌幅榜)、capital(资金榜)、sectors(板块榜) |
| date | string | 是 | 查询日期,格式 YYYYMMDD |
| limit | int | 否 | 返回数量,默认 100,范围 1-500 |
| exclude_st | string | 否 | 排除 ST 股票,默认 1(排除),传 0/false/no 不排除 |
| metric | string | 否 | 资金榜指标,amount(成交额)或 vol_ffcap(换手率),默认 vol_ffcap。仅 type=capital 时生效 |
| min_amount | float | 否 | 资金榜最低成交额,默认 10000。仅 type=capital 时生效 |
| weight | string | 否 | 板块榜权重,equal(等权)、ffcap(流通市值加权)、amount(成交额加权),默认 equal。仅 type=sectors 时生效 |
| block_type | string | 否 | 板榜类型过滤。仅 type=sectors 时生效 |
接口说明¶
- 结果包含
as_of字段表示实际生效日期 - 缓存 300 秒(5 分钟)
响应格式示例¶
{
"code": 1,
"message": "success",
"data": {
"as_of": "20260113",
"items": [
{
"code": "600519.SH",
"name": "贵州茅台",
"pct_chg": 9.98
}
]
}
}
返回状态¶
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 参数错误(缺少 type/date、type 不支持、limit 非法等) |
| 401 | 未认证 |
| 403 | 无权限 |
| 404 | 无数据 |