二、HTTP 行情与 K 线
2.3 单个 / 多个产品完整行情
GET
/api/mini_prices同一个市场里一个或多个产品的完整行情。
请求
请求头 Authorization:你的密钥(必填)。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| market | 必填 | 市场代码,如 NASDAQ;全部取值见「国家与市场参数」。不分大小写 |
| symbol | 必填 | 产品代码,多个用英文逗号隔开,如 AAPL 或 AAPL,TSLA。不分大小写;代码里有 & 时要写成 %26,见通用规则 |
返回
数组,每个查到的产品一条,行情在 data 里,字段含义见「行情字段说明」。
说明
- 一次请求只能查一个市场,全部产品都要属于这个市场;不同市场的分开请求。
- 一次最多 200 个产品,超过时返回
[{"status":500,…,"message":"Symbol too much!"}]。 - 查不到的产品不会出现在返回里(不报错),所以要逐个核对请求的产品有没有返回;全部查不到、或没传
symbol时返回空数组[]。 - 需要持续更新时用 WebSocket 订阅产品。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | status=500 The parameter 'market' is required | 缺少 market |
| 200 | [{"status":500,…,"message":"Symbol too much!"}] | 产品超过 200 个 |
示例
GET
/mini_prices?market=NASDAQ&symbol=AAPL,TSLA请求头 Authorization: 你的密钥 · HTTP 200
[
{
"status": 0, // 0 成功,500 失败
"interval": null, // K 线周期,只有 K 线接口有值
"market": "NASDAQ", // 市场代码
"code": "AAPL", // 产品代码
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 行情内容,字段含义见「行情字段说明」
"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 天可能已退市
}
},
{
"status": 0, // 0 成功,500 失败
"interval": null, // K 线周期,只有 K 线接口有值
"market": "NASDAQ", // 市场代码
"code": "TSLA", // 产品代码
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 行情内容,字段含义见「行情字段说明」
"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 天可能已退市
}
}
]