ohlcv_history:最近 K 线(一次性)
一次性请求:返回一个池子最近的 N 根 1 秒 K 线。用它先把图表填满,再用 subscribe_ohlcv 保持实时。传 mint 或 pool 之一,外加可选的 limit(1 – 500,默认 200)。
免费密钥,按需领取
这个事件需要一个免费数据密钥。加入 Telegram 群开口要一个即可;它只是让拉取 K 线的人有个名字对应,不计量、不收费。数据 API 上其他所有东西都无需密钥。
| 通道 | 带 ack 的 Socket.IO 事件 |
| 认证 | 握手里的免费密钥,auth: { api_key },到 Telegram 群领取 |
| 费用 | 免费 |
示例
- JavaScript
- Python
socket.emit("ohlcv_history", { pool: "4mBL…", limit: 200 }, (ack) => {
if (!ack.ok) return console.error(ack);
for (const [t, o, h, l, c, v] of ack.data) {
console.log(new Date(t), `o=${o} h=${h} l=${l} c=${c} v=${v}`);
}
});
from datetime import datetime
# sio.call 会阻塞到服务端对这个一次性请求返回 ack。
ack = sio.call("ohlcv_history", {"pool": "4mBL…", "limit": 200})
if ack["ok"]:
for t, o, h, l, c, v in ack["data"]:
print(datetime.fromtimestamp(t / 1000), f"o={o} h={h} l={l} c={c} v={v}")
响应(ack)
{
"ok": true,
"pool": "4mBL…",
"data": [
[1779812627000, 0.000000033, 0.000000034, 0.000000033, 0.000000034, 5.12],
[1779812628000, 0.000000034, 0.000000035, 0.000000034, 0.000000035, 7.40]
]
}
元组是 [ timestamp_ms, open, high, low, close, volume ],从旧到新排序。格式与实时的 ohlcv 流一致。
说明
- 需要一个免费密钥,和
subscribe_ohlcv用同一个;API 上其他所有东西都无需密钥。在无密钥连接上调用会在 ack 里返回api_key_required;用auth: { api_key: … }连接即可。 - 返回滚动 Redis 窗口里现有的内容(通常是刷入 ClickHouse 之前最近约 2 分钟的 1 秒 K 线)。更深的历史请看历史回放。