二、HTTP 行情与 K 线
2.2 全市场报价
GET
/api/prices一个市场全部产品的完整行情，可以排序、只取前若干条。
请求
请求头 Authorization：你的密钥（必填）。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| market | 必填 | 市场代码，如 NASDAQ；全部取值见「国家与市场参数」。不分大小写 |
| sort | 可选 | 排序字段：volume 成交量、symbol 代码、up 涨跌幅；不传按代码从小到大 |
| order | 可选 | desc 从大到小 / asc 从小到大；不传时 volume、up 从大到小，symbol 从小到大 |
| limit | 可选 | 只取前多少条，正整数；不传返回全部 |
返回
数组，每个产品一条完整的行情消息 {State, Msg, Code, Cmd}，行情内容在 Msg 里，字段含义见「行情字段说明」。
说明
- 一次只能取一个市场。
- 按
up排序时，涨跌幅超过 ±100 的（一般是除息除权）不会排在最前面，所以sort=up&limit=20可以直接当涨幅榜用，sort=up&order=asc&limit=20当跌幅榜，sort=volume&limit=20当活跃榜。 - 不带
limit时整个市场的内容很大，不要高频调用；只关心少数产品时用「单个 / 多个产品完整行情」，需要持续更新时用 WebSocket。 - 市场代码不存在时返回空数组
[]。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | status=500 The parameter 'market' is required | 缺少 market |
| 200 | status=500 The parameter 'sort' must be one of volume,symbol,up | sort 写错 |
| 200 | status=500 The parameter 'order' must be desc or asc | order 写错 |
| 200 | status=500 The parameter 'limit' must be a positive integer | limit 不是正整数 |
示例
GET
/prices?market=NASDAQ请求头 Authorization: 你的密钥 · HTTP 200
[
{
"State": 1,
"Msg": { // 行情内容，字段含义见「行情字段说明」
"code": "AAPL", // 产品代码
"name": "Apple Inc.", // 名称
"Market": "NASDAQ", // 市场代码
"varieties": "XNAS_CS", // 品种
"price": 333.69, // 最新价
"open": 333.26, // 今开
"high": 334.54, // 今高
"low": 330.61, // 今低
"volume": 68359.326131, // 成交量，当日累计
"close": 330.32, // 昨收：昨日收盘价，而非当前收盘价
"average": 332.7092, // 均价
"amount": "22743776.7096", // 成交额，当日累计
"up": "1.020", // 涨跌幅（%）
"change": "3.370", // 涨跌
"LP": 332.6, // 盘前、盘中、盘后最新价
"odd": 332.5332, // 碎股交易
"NV": 0.203149, // 现量，最近一笔成交的量
"MT": "2",
"MRTA": "2", // 交易方向：1 买，2 卖
"dealTransaction": "1791196790,332.5332,0.203149,2,", // 逐笔交易：时间(秒),价格,量,方向,序号,时间(毫秒)
"B1": 332.53, // 买一价
"B1V": 240, // 买一量
"S1": 332.66, // 卖一价
"S1V": 40, // 卖一量
"ticks": 1791196790429, // 时间，毫秒
"tick": 1791196790, // 时间，Unix 秒
"a": "12,37",
"T": "2026-10-05" // 是否正常交易：日期，和当前时间相差 7 天可能已退市
},
"Code": "AAPL", // 产品代码
"Cmd": "rm" // rm 表示行情
},
{
"State": 1,
"Msg": { // 行情内容，字段含义见「行情字段说明」
"code": "TSLA", // 产品代码
"name": "Tesla, Inc. Common Stock", // 名称
"Market": "NASDAQ", // 市场代码
"varieties": "XNAS_CS", // 品种
"price": 370.59, // 最新价
"open": 360.08, // 今开
"high": 374.6, // 今高
"low": 359.411, // 今低
"volume": 238802.135094, // 成交量，当日累计
"close": 354.11, // 昨收：昨日收盘价，而非当前收盘价
"average": 371.256, // 均价
"amount": "88656725.4665", // 成交额，当日累计
"up": "4.654", // 涨跌幅（%）
"change": "16.480", // 涨跌
"LP": 369.63, // 盘前、盘中、盘后最新价
"odd": 369.68, // 碎股交易
"NV": 3, // 现量，最近一笔成交的量
"MT": "2",
"MRTA": "2", // 交易方向：1 买，2 卖
"dealTransaction": "1791196803,369.68,3,2,", // 逐笔交易：时间(秒),价格,量,方向,序号,时间(毫秒)
"B1": 369.63, // 买一价
"B1V": 40, // 买一量
"S1": 369.86, // 卖一价
"S1V": 40, // 卖一量
"ticks": 1791196803317, // 时间，毫秒
"tick": 1791196803, // 时间，Unix 秒
"a": "14,12,37,41",
"T": "2026-10-05" // 是否正常交易：日期，和当前时间相差 7 天可能已退市
},
"Code": "TSLA", // 产品代码
"Cmd": "rm" // rm 表示行情
}
]共 5532 条，示例只列出其中 AAPL、TSLA 这 2 条。