GET /v1/tokens/list 3 credits per call

List tokens

Pricing note: Add ?withPrice=true → 6 credits

Request

Query parameters

limitintegeroptionaldefault 50
Page size, 1..100. Default 50.
cursorstringoptional
Opaque pagination cursor returned as `next_cursor` from the previous page. Omit on the first request.
withPricebooleanoptionaldefault false
When true, include `price`, `change`, `volume_24h`, `liquidity` (joined from prices_current). Costs 2× the base credit price.

Example

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

const res = await fetch("https://api.realflow.so/v1/tokens/list", {
  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/list", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.REALFLOW_API_KEY,
  },
});
const data = await res.json();
console.log(data);

Response 200

{
  "tokens": [
    {
      "address": "string",
      "symbol": "string",
      "name": "string",
      "image_url": "string",
      "description": "string",
      "decimals": 0,
      "token_program_address": "string",
      "first_seen_at": "2026-05-20T12:00:00Z",
      "first_seen_slot": 0,
      "supply": "string",
      "mint_at": "2026-05-20T12:00:00Z",
      "mint_signature": "string",
      "created_via": "string",
      "marketcap_usd": "string",
      "metadata_protocol": "string",
      "metadata_uri": "string",
      "links": {
        "website": "string",
        "twitter": "string",
        "telegram": "string",
        "discord": "string",
        "github": "string",
        "medium": "string"
      },
      "authorities": {
        "mint_authority": "string",
        "freeze_authority": "string",
        "update_authority": "string",
        "is_mutable": false
      },
      "holders": {
        "stats": {
          "top5_pct": "string",
          "top10_pct": "string",
          "top20_pct": "string",
          "updated_at": "2026-05-20T12:00:00Z"
        }
      },
      "price": {
        "usd": "string",
        "updated_at": "2026-05-20T12:00:00Z",
        "last_priced_swap_at": "2026-05-20T12:00:00Z"
      },
      "change": {
        "price_1h_pct": "string",
        "price_24h_pct": "string",
        "volume_24h_pct": "string"
      },
      "volume_24h": {
        "usd": "string",
        "prev_usd": "string",
        "token": "string"
      },
      "liquidity": {
        "usd": "string",
        "updated_at": "2026-05-20T12:00:00Z"
      },
      "activity_24h": {
        "total_swaps": 0,
        "unique_swappers": 0,
        "unique_fee_payers": 0,
        "buys": 0,
        "sells": 0,
        "buy_volume_usd": "string",
        "sell_volume_usd": "string",
        "unique_buyers": 0,
        "unique_sellers": 0,
        "last_swap_at": "2026-05-20T12:00:00Z"
      }
    }
  ],
  "next_cursor": "string"
}

Error responses

All errors follow the standard envelope — see error codes.

401