Quickstart

From zero to your first call in two minutes. RealFlow is a single REST API that returns Solana token data — metadata, prices, OHLCV, activity, holders stats, and a live SSE stream.

1. Get an API key

Sign up at dash.realflow.so, pick a plan, and generate a key in the dashboard. Keys are opaque strings starting with tt_.

2. Make your first call

Hit the SOL token detail endpoint to confirm everything works. Replace $REALFLOW_API_KEY with your key (or set it as an environment variable).

curl -H "X-API-Key: $REALFLOW_API_KEY" \
  "https://api.realflow.so/v1/tokens/So11111111111111111111111111111111111111112"

const res = await fetch(
  "https://api.realflow.so/v1/tokens/So11111111111111111111111111111111111111112",
  { headers: { "X-API-Key": process.env.REALFLOW_API_KEY } }
);
const data = await res.json();
console.log(data.price.usd, data.change.price_24h_pct);

import { setTimeout as wait } from "node:timers/promises";

const KEY = process.env.REALFLOW_API_KEY;
const BASE = "https://api.realflow.so";

const res = await fetch(`${BASE}/v1/tokens/So11111111111111111111111111111111111111112`, {
  headers: { "X-API-Key": KEY },
});
const data = await res.json();
console.log(data.symbol, data.price.usd);

3. Read the response

All endpoints return JSON with a consistent shape — see the per-endpoint pages in the sidebar for full schemas. Successful responses are 2xx; errors come back as { error: { code, message, request_id } } with a 4xx or 5xx status.

{
  "address": "So11111111111111111111111111111111111111112",
  "symbol": "SOL",
  "name": "Wrapped SOL",
  "decimals": 9,
  "price":      { "usd": "142.31", "updated_at": "2026-05-20T12:00:00Z" },
  "change":     { "price_1h_pct": "0.42", "price_24h_pct": "2.41" },
  "volume_24h": { "usd": "1820445112" },
  "activity_24h": {
    "total_swaps": 184221,
    "buys": 102001,
    "sells": 82220,
    "unique_buyers": 41203,
    "unique_sellers": 38117
  }
}

4. Next steps

Authentication — how to pass your key (header vs query).
Error codes — what each 4xx/5xx means.
Rate limits & quotas — credits, RPM, soft vs hard caps.
SSE — live prices — how to consume the streaming endpoint.
Endpoint reference — every endpoint, with credit costs.