Token API Calls

The Carbium Token Index API is plain REST over HTTPS.

Base URL: https://tokens.carbium.io
Auth: none
CORS: permissive
POST content type: application/json

Use the live endpoint page at tokens.carbium.io/endpoints when you want interactive request examples.

GET /tokens

Search or list tokens.

curl 'https://tokens.carbium.io/tokens?q=USDC&limit=3'

Query parameters

Name	Type	Required	Description
`q`	string	No	Text query: mint, symbol, or partial name. Ranking prefers exact mint, exact symbol, symbol prefix, name prefix, then fuzzy matches.
`limit`	integer	No	1–200, default 50.
`page`	integer	No	1-indexed, default 1.
`include_token22`	boolean	No	Default `true`. Set `false` to hide Token-2022 mints.

Response

{
  "items": [
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "logo_url": "https://...",
      "logo_status": "ok",
      "is_token22": false,
      "daily_volume_usd": null,
      "first_seen_at": 1778506622843,
      "last_seen_at": 1778578957677
    }
  ],
  "page": 1,
  "limit": 3,
  "total": null
}

Use this endpoint for search boxes, token selectors, import-token flows, and admin tools where the user might type a symbol, partial name, or mint.

GET /tokens/:mint

Resolve one mint address into a token record.

curl 'https://tokens.carbium.io/tokens/So11111111111111111111111111111111111111112'

Path parameter

Name	Type	Required	Description
`mint`	base58 pubkey	Yes	SPL or Token-2022 mint address.

Response

{
  "mint": "So11111111111111111111111111111111111111112",
  "symbol": "SOL",
  "name": "Wrapped SOL",
  "decimals": 9,
  "logo_url": "https://...",
  "logo_status": "ok",
  "is_token22": false,
  "daily_volume_usd": null,
  "first_seen_at": 1778506622843,
  "last_seen_at": 1778578957676,
  "supply": "0",
  "mint_authority": null,
  "freeze_authority": null,
  "metaplex_uri": null,
  "update_authority": "AqH29mZfQFgRpfwaPoTMWSKJ5kqauoc1FwVBRksZyQrt",
  "seller_fee_basis_points": 0,
  "token_standard": null,
  "description": null,
  "external_url": null,
  "extensions": null,
  "tags": null
}

Use this endpoint when your app has a canonical mint and only needs one token object.

POST /tokens/batch

Resolve up to 500 mint addresses in one request.

curl -X POST 'https://tokens.carbium.io/tokens/batch' \
  -H 'content-type: application/json' \
  -d '{
    "mints": [
      "So11111111111111111111111111111111111111112",
      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    ]
  }'

Request body

Field	Type	Required	Description
`mints`	array	Yes	Up to 500 base58 mint addresses.

Response

{
  "items": [
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "logo_status": "ok",
      "is_token22": false
    }
  ],
  "unknown": []
}

Use this endpoint for portfolios, token-list hydration, swap UIs, backend jobs, and agents that already have mint addresses.

GET /img/:mint

Fetch a cached token logo image by mint address.

curl 'https://tokens.carbium.io/img/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' -o usdc.png

Path parameter

Name	Type	Required	Description
`mint`	base58 pubkey	Yes	Mint address. Response is cached server-side after the first hit.

Use this endpoint for <img> tags, token lists, dashboards, and generated assets. Still keep an application fallback for unknown, missing, or broken logos.

Token record fields

A token record can include:

Field	Notes
`mint`	SPL or Token-2022 mint address
`symbol`, `name`, `decimals`	Basic display fields
`logo_url`, `logo_status`	Original logo URL and Carbium status: `ok`, `unchecked`, `broken`, or `missing`
`is_token22`	Whether the mint is Token-2022
`daily_volume_usd`	Nullable volume field when available
`first_seen_at`, `last_seen_at`	Index timing fields
`supply`	String supply value when captured
`mint_authority`, `freeze_authority`, `update_authority`	Nullable authority fields
`metaplex_uri`, `seller_fee_basis_points`, `token_standard`	Metaplex-related enrichment fields
`description`, `external_url`, `extensions`, `tags`	Nullable metadata fields

Do not assume every field exists for every token. Handle null values and missing metadata as normal index behavior.