三、财务信息
3.12 涨跌统计
GET
/api/market_breadth一个国家全部股票的上涨、下跌、平盘只数和按涨跌幅分档的只数。
请求
请求头 Authorization：你的密钥（必填）。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家，如 america；全部取值见「国家与市场参数」 |
| type | 可选 | stock（默认）只统计股票 / stockdr 把存托凭证也算进去 |
| date | 可选 | 交易日，yyyy-MM-dd 或 Unix 秒；不传取最新交易日 |
说明
data是一个对象；这个国家那一天没有数据时data为 null。total=advancing上涨 +declining下跌 +unchanged平盘。- 分档：up10_plus 涨 10% 以上、up5_to10、up1_to5、up0_to1，down0_to1、down1_to5、down5_to10、down10_plus 跌 10% 以上。
markets是统计了哪些市场；trade_date是交易日（UTC 零点的 Unix 秒）；scope是 stock 或 stock+dr。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval}，数据在 data 里。出错时 HTTP 状态码仍是 200，status 为 500，message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
| 200 | status=500 Type(stock|stockdr) is invalid | type 写错 |
示例
GET
/market_breadth?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": "SUCCESS", // 成功为 SUCCESS，失败时是原因
"data": { // 数据
"country": "america", // 国家
"markets": "AMEX,NASDAQ,NYSE", // 统计了哪些市场
"scope": "stock", // stock 或 stock+dr
"trade_date": 1791158400, // 交易日，UTC 零点的 Unix 秒
"total": 5701, // 总只数 = 上涨 + 下跌 + 平盘
"advancing": 1965, // 上涨只数
"declining": 1533, // 下跌只数
"unchanged": 2203, // 平盘只数
"up10_plus": 65, // 涨 10% 以上
"up5_to10": 174, // 涨 5% ~ 10%
"up1_to5": 1096, // 涨 1% ~ 5%
"up0_to1": 630, // 涨 0 ~ 1%
"down0_to1": 507, // 跌 0 ~ 1%
"down1_to5": 798, // 跌 1% ~ 5%
"down5_to10": 163, // 跌 5% ~ 10%
"down10_plus": 65, // 跌 10% 以上
"ignored_stale": 36,
"updated_at": "2026-10-05 10:40:11" // 更新时间
},
"total": 0, // 总条数，分页的接口才有值
"page": 0, // 当前页，分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}