GET /v1/tokens/{addr}/ohlcv 2 credits per call

OHLCV candles

Request

Path parameters

addrstringrequired

Query parameters

bucket"1m" | "5m" | "30m" | "1h" | "6h" | "12h" | "1d" | "1w"required
"1m""5m""30m""1h""6h""12h""1d""1w"
fromstring<date-time>required
tostring<date-time>required

Example

curl \
  -H "X-API-Key: $REALFLOW_API_KEY" \
  "https://api.realflow.so/v1/tokens/So11111111111111111111111111111111111111112/ohlcv?bucket=1m&from=2026-05-20T00%3A00%3A00Z&to=2026-05-20T00%3A00%3A00Z"

const res = await fetch("https://api.realflow.so/v1/tokens/So11111111111111111111111111111111111111112/ohlcv?bucket=1m&from=2026-05-20T00%3A00%3A00Z&to=2026-05-20T00%3A00%3A00Z", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.REALFLOW_API_KEY,
  },
});
const data = await res.json();
console.log(data);

const res = await fetch("https://api.realflow.so/v1/tokens/So11111111111111111111111111111111111111112/ohlcv?bucket=1m&from=2026-05-20T00%3A00%3A00Z&to=2026-05-20T00%3A00%3A00Z", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.REALFLOW_API_KEY,
  },
});
const data = await res.json();
console.log(data);

Response 200

{
  "token_address": "string",
  "bucket": "1m",
  "candles": [
    {
      "ts": "2026-05-20T12:00:00Z",
      "open": "string",
      "high": "string",
      "low": "string",
      "close": "string",
      "volume_usd": "string",
      "tx_count": 0
    }
  ]
}

Error responses

All errors follow the standard envelope — see error codes.

400

401