K 线数据
某美股标的在给定时间范围与周期内的 K 线（OHLCV）数据。
接口
GET /stock/v1/klines
鉴权： 标准套餐。需携带与有效标准套餐（或更高）订阅绑定的平台 API 密钥（X-Primit-API-Key）。详见鉴权。
查询参数
| 名称 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
symbol | string | 是 | — | 股票代码，例如 AAPL。 |
interval | string | 否 | 1d | 取值：1m、5m、15m、30m、1h、1d、1w、1M。 |
limit | integer | 否 | 100 | 返回的 K 线数量。 |
startTime | integer | 否 | — | 起始时间（含），Unix 毫秒。 |
endTime | integer | 否 | — | 结束时间（含），Unix 毫秒。 |
adjusted | boolean | 否 | true | 价格是否经过拆股/分红复权。 |
若未提供 startTime 与 endTime，则返回最近 limit 条 K 线，按 open_time 升序排列。
响应 —— 200 OK
二维数组，每行按位置排列（标准 Binance K 线格式）：
[
[
1773705600000,
"5013.59",
"5043.75",
"4978.40",
"5003.54",
"145553.554",
1773791999999,
"729468735.70852",
431830,
"72156.345",
"361615976.65469",
"0"
]
]
| 位置 | 字段 | 类型 | 说明 |
|---|---|---|---|
| 0 | open_time | integer (ms) | K 线开始时间。 |
| 1 | open | string (decimal) | 开盘价。 |
| 2 | high | string (decimal) | 最高价。 |
| 3 | low | string (decimal) | 最低价。 |
| 4 | close | string (decimal) | 收盘价。 |
| 5 | volume | string (decimal) | 基础资产成交量。 |
| 6 | close_time | integer (ms) | K 线结束时间。 |
| 7 | quote_volume | string (decimal) | 计价资产成交量。 |
| 8 | trades | integer | 成交笔数。 |
| 9 | taker_buy_volume | string (decimal) | 主动买入的基础资产成交量。 |
| 10 | taker_buy_quote_volume | string (decimal) | 主动买入的计价资产成交量。 |
| 11 | ignore | string | Binance 保留字段。 |
错误
| HTTP | 原因 |
|---|---|
401 | 缺少或无效的 X-Primit-API-Key。 |
403 | 无有效标准套餐（订阅已过期或未购买）。 |
404 | symbol 不存在。 |
422 | interval 不在允许集合内。 |
示例
curl -s "https://api-dev.pipai.org/stock/v1/klines?symbol=AAPL&interval=1d&limit=250" \
-H "X-Primit-API-Key: $PRIMIT_API_KEY"