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 currently available for all tokens. They will be set to null if not available.

Token PnL Statistics​

Returns aggregated token profit and loss statistics.

Request units: 20

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

Success Response​

{
    "break_even_price": 0.025972564277416243 | null,
    "realized_pnl_total": 4334995.914932932,
    "unrealized_pnl_total": -11614834.870521689
}

Notes: PnL stats are not currently available for all tokens. break_even_price, realized_pnl_total, and unrealized_pnl_total are denominated in USD.

Token Wallet Categories​

Returns aggregated breakdown of the top 1000 holders' category.

Request units: 20

GET /v0/{chain_id}/tokens/{contract_address}/stats/wallet-categories

Success Response​

{
    "diamond": 694,
    "gold": 65,
    "silver": 95,
    "bronze": 29,
    "wood": 8,
    "new_holders": 4
}

Notes: Token holder wallet categories are not currently available for all tokens.