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

Get token

Request

Path parameters

addrstringrequired

Query parameters

include_holdersbooleanoptionaldefault false
When true, populate `holders.list` with up to 20 entries (rank, account_address, amount). When false/omitted, only `holders.stats` is returned and no extra query is run.

Example

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", {
  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", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.REALFLOW_API_KEY,
  },
});
const data = await res.json();
console.log(data);

Response 200

{
  "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
  },
  "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"
  },
  "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"
  },
  "liquidity": {
    "usd": "string",
    "updated_at": "2026-05-20T12:00:00Z"
  },
  "holders": {
    "stats": {
      "top5_pct": "string",
      "top10_pct": "string",
      "top20_pct": "string",
      "updated_at": "2026-05-20T12:00:00Z"
    },
    "list": [
      {
        "rank": 0,
        "account_address": "string",
        "amount": "string"
      }
    ]
  }
}

Error responses

All errors follow the standard envelope — see error codes.

401

404