ohlcv_history —— 最近 K 线（一次性）

一次性请求：返回一个池最近的 N 根 1 秒 K 线。用它填充图表，然后升级到 subscribe_ohlcv 获取实时更新。传 mint 或 pool 二者之一，外加可选的 limit（1 – 500，默认 200）。

无需密钥

不带密钥时，每个 IP 地址每分钟应答一次；间隔更短时，ack 返回 rate_limited 并附 retryAfterMs。握手中带上你套餐的密钥后，每秒应答一次（Lite）或每秒五次（Developer）。

Free1 a minute

Lite1 req/s

Developer5 req/s

Hitting the Free limit? Lite and Developer raise it. See plans →

通道	带 ack 的 Socket.IO 事件
认证	每分钟一次无需密钥；更多次数用你套餐的密钥，auth: { api_key }
费用	Free：每分钟 1 次 · Lite：每秒 1 次 · Developer：每秒 5 次

示例

JavaScript

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}`);
  }
});

Python

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 流一致。

说明

• 无需密钥时，每个 IP 地址每分钟一次。在握手里带上你套餐的密钥 auth: { api_key: … }，Lite 每秒一次，Developer 每秒五次。比这更频繁时，ack 会返回 rate_limited 和 retryAfterMs。
• 最多返回 limit 根最近的 K 线。更早的内容，按小时的回放文件保存着每一笔交易。