K 线（蜡烛图）

描述

以 Binance 风格的数组嵌套数组格式返回预聚合的 OHLCV K 线数据。K 线聚合器在每次成交时增量更新 K 线，并每隔 60 秒执行一次衰减扫描，以清除超出时间窗口的成交记录。

HTTP 请求

GET /spot/klines (公开 (无需鉴权))

权重

0 — 当前公开行情接口对单个 IP 不设权重限制 (MVP)。

请求参数

名称	类型	必填	描述
symbol	STRING	必填	交易对标识符（如 DFUSDT）。区分大小写。参见 GET /spot/markets。
interval	STRING	必填	K 线周期。参见 K 线周期枚举：1m / 5m / 15m / 1h / 4h / 1d。
limit	NUMBER	可选	返回的 K 线条数。默认 500，范围 1–1000。
start_time	NUMBER	可选	Unix 秒。过滤条件：open_time >= start_time。
end_time	NUMBER	可选	Unix 秒。过滤条件：open_time <= end_time。

响应示例

200 OK

[
  [1778313600, "0.48", "0.51", "0.47", "0.50", "10000", 1778313659, "4900", 234],
  [1778313660, "0.50", "0.52", "0.49", "0.51", "8500",  1778313719, "4335", 187]
]

基于位置的字段（所有价格和成交量均为字符串；trade_count 为数字）：

索引	字段	说明
0	open_time	Unix 秒。K 线开始时间。
1	open_price	K 线内首笔成交价（若无成交则延用上一根 K 线收盘价）。
2	high_price	K 线内最高成交价。
3	low_price	K 线内最低成交价。
4	close_price	K 线内最新成交价。
5	volume	K 线内基础代币成交量。
6	close_time	Unix 秒。open_time + interval_seconds - 1。
7	quote_volume	K 线内报价代币成交额（名义价值）。
8	trade_count	K 线内独立成交笔数。

错误响应

HTTP	error
400	invalid interval — interval 不在支持的字符串列表中。
500	DB_ERROR

完整列表：错误代码。

代码示例

cURL

# Last 10 one-minute bars
curl -s "https://api-sepolia.p99.world/api/v1/spot/klines?symbol=DFUSDT&interval=1m&limit=10"

# Bars in a specific time window
curl -s "https://api-sepolia.p99.world/api/v1/spot/klines?symbol=DFUSDT&interval=1h&start_time=1778313600&end_time=1778400000"

Python

import requests

BASE = "https://api-sepolia.p99.world/api/v1"

bars = requests.get(f"{BASE}/spot/klines", params={
    "symbol":   "DFUSDT",
    "interval": "1m",
    "limit":    10,
}).json()

for bar in bars:
    open_time, open_p, high, low, close, vol, close_time, quote_vol, trades = bar
    print(f"t={open_time}  O={open_p} H={high} L={low} C={close}  vol={vol}  n={trades}")