三、财务信息
3.11 活跃榜、涨幅榜、跌幅榜
GET
/api/active_listGET
/api/gainer_listGET
/api/loser_list一个国家成交最活跃、涨幅最大、跌幅最大的股票，按名次排列，每个榜单 20 条。
请求
请求头 Authorization：你的密钥（必填）。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家，如 america；全部取值见「国家与市场参数」 |
说明
- 三个接口参数相同：
active_list活跃榜、gainer_list涨幅榜、loser_list跌幅榜；返回里的type分别是 ACTIVE、GAINER、LOSER。 - price、change、volume 都是文本：price 带币种，如 "39.42 USD"；change 带正负号和百分号，如 "+68.25%"，下跌用的负号是 U+2212（"−20.00%"），不是普通减号；volume 带单位，如 "78.58 K"、"5.28 M"。
original是 交易所:代码 的写法；sector可能为 null。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval}，数据在 data 里。出错时 HTTP 状态码仍是 200，status 为 500，message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
示例：gainer_list
GET
/gainer_list?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": "SUCCESS", // 成功为 SUCCESS，失败时是原因
"data": [ // 按名次排列，每个榜单 20 条
{
"market": "america", // 国家
"volume": "93.36 K", // 成交量，文本，带单位
"country": "america", // 国家
"symbol": "XRPN", // 产品代码
"original": "NASDAQ:XRPN", // 交易所:代码 的写法
"price": "39.42 USD", // 价格，文本，带币种
"change": "+68.25%", // 涨跌幅，文本，带正负号和百分号
"name": "Armada Acquisition Corp. II Class A Ordinary Shares", // 名称
"exchange": "NASDAQ", // 交易所
"type": "GAINER", // 榜单：ACTIVE 活跃榜，GAINER 涨幅榜，LOSER 跌幅榜
"sector": "Finance" // 板块，可能为 null
},
{
"market": "america", // 国家
"volume": "572.64 K", // 成交量，文本，带单位
"country": "america", // 国家
"symbol": "FLUX", // 产品代码
"original": "NASDAQ:FLUX", // 交易所:代码 的写法
"price": "0.6400 USD", // 价格，文本，带币种
"change": "+57.40%", // 涨跌幅，文本，带正负号和百分号
"name": "Flux Power Holdings, Inc. Common Stock", // 名称
"exchange": "NASDAQ", // 交易所
"type": "GAINER", // 榜单：ACTIVE 活跃榜，GAINER 涨幅榜，LOSER 跌幅榜
"sector": "Producer manufacturing" // 板块，可能为 null
}
],
"total": 0, // 总条数，分页的接口才有值
"page": 0, // 当前页，分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}data 共 20 条，示例只列出前 2 条。
示例：active_list
GET
/active_list?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": "SUCCESS", // 成功为 SUCCESS，失败时是原因
"data": [ // 按名次排列，每个榜单 20 条
{
"market": "america", // 国家
"volume": "33.1 M", // 成交量，文本，带单位
"country": "america", // 国家
"symbol": "QTEX", // 产品代码
"original": "NASDAQ:QTEX", // 交易所:代码 的写法
"price": "1.1000 USD", // 价格，文本，带币种
"change": "+40.20%", // 涨跌幅，文本，带正负号和百分号
"name": "QTREX Quantum Ltd. Ordinary Shares", // 名称
"exchange": "NASDAQ", // 交易所
"type": "ACTIVE", // 榜单：ACTIVE 活跃榜，GAINER 涨幅榜，LOSER 跌幅榜
"sector": "Health technology" // 板块，可能为 null
},
{
"market": "america", // 国家
"volume": "19.22 M", // 成交量，文本，带单位
"country": "america", // 国家
"symbol": "SAIQ", // 产品代码
"original": "NASDAQ:SAIQ", // 交易所:代码 的写法
"price": "1.85 USD", // 价格，文本，带币种
"change": "−27.45%", // 涨跌幅，文本，带正负号和百分号
"name": "WISeSat.Space Holdings Corp. Ordinary Shares", // 名称
"exchange": "NASDAQ", // 交易所
"type": "ACTIVE", // 榜单：ACTIVE 活跃榜，GAINER 涨幅榜，LOSER 跌幅榜
"sector": "Finance" // 板块，可能为 null
}
],
"total": 0, // 总条数，分页的接口才有值
"page": 0, // 当前页，分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}data 共 20 条，示例只列出前 2 条。
示例：loser_list
GET
/loser_list?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": "SUCCESS", // 成功为 SUCCESS，失败时是原因
"data": [ // 按名次排列，每个榜单 20 条
{
"market": "america", // 国家
"volume": "36.95 K", // 成交量，文本，带单位
"country": "america", // 国家
"symbol": "SMX", // 产品代码
"original": "NASDAQ:SMX", // 交易所:代码 的写法
"price": "3.82 USD", // 价格，文本，带币种
"change": "−37.99%", // 涨跌幅，文本，带正负号和百分号
"name": "SMX (Security Matters) Public Limited Company Ordinary Shares", // 名称
"exchange": "NASDAQ", // 交易所
"type": "LOSER", // 榜单：ACTIVE 活跃榜，GAINER 涨幅榜，LOSER 跌幅榜
"sector": "Technology services" // 板块，可能为 null
},
{
"market": "america", // 国家
"volume": "11.32 K", // 成交量，文本，带单位
"country": "america", // 国家
"symbol": "FHTX", // 产品代码
"original": "NASDAQ:FHTX", // 交易所:代码 的写法
"price": "2.02 USD", // 价格，文本，带币种
"change": "−30.82%", // 涨跌幅，文本，带正负号和百分号
"name": "Foghorn Therapeutics Inc. Common Stock", // 名称
"exchange": "NASDAQ", // 交易所
"type": "LOSER", // 榜单：ACTIVE 活跃榜，GAINER 涨幅榜，LOSER 跌幅榜
"sector": "Health technology" // 板块，可能为 null
}
],
"total": 0, // 总条数，分页的接口才有值
"page": 0, // 当前页，分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}data 共 20 条，示例只列出前 2 条。