Skip to main content

Tokens

List Tokens​

Returns a paginated list of all supported tokens for the provided chain.

Request units: 10

GET /v0/{chain_id}/tokens

Query Parameters​

  • limit: Number of results per page (default: 50, max: 100)
  • offset: Pagination offset

Success Response​

{
  "total": 2782,
  "tokens": [
    {
      "address": "8HjiRvPNwFT9jpzAAsYF4rE9y576CKdTkQZXaxibpump",
      "name": "Nova Dova",
      "ticker": "DOVA",
      "network": "SOL",
      "decimals": 6,
      "supply": "999986952255790"
    },
    {
      "address": "BABLUMPMh6QxfmVDGsAa6iUhf8Dhd3TxX9PavrHSpump",
      "name": "XNomadAI",
      "ticker": "XNOMAD",
      "network": "SOL",
      "decimals": 6,
      "supply": "1000000000000000"
    }
  ]
}

Token Details​

Returns the details of a provided token

Request units: 10

GET /v0/{chain_id}/tokens/{contract_address}

Success Response​

{
    "address": "8HjiRvPNwFT9jpzAAsYF4rE9y576CKdTkQZXaxibpump",
    "name": "Nova Dova",
    "ticker": "DOVA",
    "network": "SOL",
    "decimals": 6,
    "supply": "999986952255790"
}

Token Statistics​

Returns aggregated token statistics including concentration and distribution metrics.

Request units: 20

GET /v0/{chain_id}/tokens/{contract_address}/stats

Success Response​

{
    "hhi": 0.12,
    "gini": 0.92,
    "median_holder_position": 1000,
    "avg_time_held": 5172333 | null,
    "retention_rate": 0.85 | null
}

Notes: avg_time_held and retention_rate are not available for all tokens. They will be set to null if not available.