Quick Start Data

Use this page when you want the fastest path from zero to one working Carbium Data request.

The live Carbium Data surface is the Token Index API at https://tokens.carbium.io. It is a public REST API for Solana token search, mint lookup, batch resolves, metadata enrichment, and cached token logos. No API key is required for the current free rate-limited surface.

The 5-minute path

For most builders, start in this order:

1. Search for a token with GET /tokens.
2. Pick a mint address from the result.
3. Resolve the mint with GET /tokens/:mint.
4. Batch resolve known mints with POST /tokens/batch.
5. Use GET /img/:mint when you need a cached logo URL for an <img> tag or backend asset flow.

Base URL:

https://tokens.carbium.io

1. Search tokens

Search by mint, symbol, or partial name. Results are ranked toward exact mint, exact symbol, symbol prefix, name prefix, then fuzzy matches.

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

Common query parameters:

Minimal response shape:

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

2. Resolve one mint

Use a mint address when your app already knows the token and needs the current Carbium token record.

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

This returns one token object. Fields can include basic identity, logo state, Token-2022 status, supply, authorities, Metaplex URI, external links, extensions, and tags. Some fields are nullable when metadata is missing or still being enriched.

3. Batch resolve mints

Use the batch endpoint when your UI or backend already has a list of mint addresses and needs token records in one request.

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

mints accepts up to 500 base58 mint addresses per request.

The response contains:

• items: records the API resolved
• unknown: mint addresses that were not found

4. Load a cached logo

Use the image endpoint when your app wants a token logo without depending directly on the original upstream asset URL.

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

In a browser:

<img
  src="https://tokens.carbium.io/img/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  alt="USDC logo"
/>

The response is cached server-side after the first hit. Your app should still provide a local fallback for unknown or missing logos.

Before production

Read Rate Limits before you ship a public frontend or high-traffic backend. The public surface is free and rate-limited; production apps should cache responses, batch where possible, and avoid repeatedly resolving the same mint in hot render paths.

📘

The current Carbium Data token API does not require an API key. If your product needs higher throughput or custom datasets, contact Carbium instead of trying to bypass the public limits.