二、HTTP 行情与 K 线
2.4 多个产品最新 K 线
GET
/api/mini_lists同一个市场、同一个周期,一次取多个产品最近的若干根 K 线。
请求
请求头 Authorization:你的密钥(必填)。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| market | 必填 | 市场代码,如 NASDAQ;全部取值见「国家与市场参数」。不分大小写 |
| symbol | 必填 | 产品代码,多个用英文逗号隔开;代码里有 & 时要写成 %26 |
| interval | 必填 | K 线周期:1min、5min、10min、15min、30min、1h、1day、1week、1month |
返回
数组,每个产品一条,K 线在 data 里,是一个字符串。多根 K 线用英文分号 ; 隔开,一根里面用英文逗号 , 隔开,最新的在前。一根里面的 7 项顺序固定:
| 位置 | 内容 | 说明 |
|---|---|---|
| 1 | 时间 | Unix 秒,这根 K 线的开始时间;日线、周线、月线是那一天的 UTC 零点 |
| 2 | 收盘价 | 还没走完的那一根是最新价 |
| 3 | 开盘价 | |
| 4 | 最高价 | |
| 5 | 最低价 | |
| 6 | 备用 | |
| 7 | 成交量 |
说明
- 每个产品最多返回最近 30 根,实际根数随周期和时段而不同,可能只有几根(实测美股各周期实际返回:1min 30 根、5min 11 根、1h 3 根、1day 5 根)。要完整的历史用「单个产品实时 / 历史 K 线」。
- 最新的一根如果周期还没走完,后面还会变。
- 一次最多 200 个产品,超过时返回
[{"status":500,…,"message":"Symbol too much!"}]。 - 查不到的产品也会有一条,
data是空字符串。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | status=500 The parameter 'market' is required | 缺少 market |
| 200 | status=500 The parameter 'interval' must be one of 1min,5min,10min,15min,30min,1h,1day,1week,1month | interval 不在支持的周期里 |
示例
GET
/mini_lists?market=NASDAQ&symbol=AAPL,TSLA&interval=1day请求头 Authorization: 你的密钥 · HTTP 200
[
{
"status": 0, // 0 成功,500 失败
"interval": "1day", // K 线周期
"market": "NASDAQ", // 市场代码
"code": "AAPL", // 产品代码
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
// K 线,每根是 时间,收盘价,开盘价,最高价,最低价,备用,成交量;最新的在前
"data": "1790899200,333.69,333.26,334.54,330.61,0,31474957.285404;1790812800,332.86,330,332.4816,325.81,0,34897053.582827;1790726400,329.59,330.8,339.5,330.1401,0,47874522;…"
},
{
"status": 0, // 0 成功,500 失败
"interval": "1day", // K 线周期
"market": "NASDAQ", // 市场代码
"code": "TSLA", // 产品代码
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
// K 线,每根是 时间,收盘价,开盘价,最高价,最低价,备用,成交量;最新的在前
"data": "1790899200,370.59,360.08,374.6,359.411,0,53629130.508323;1790812800,359.8,356.81,359.79,353.8,0,30091626.123278;1790726400,355.95,352.11,355.219,345.88,0,37716656;…"
}
]data 共 5 根 K 线,示例只列出前 3 根。