Carbium Data
Carbium Data is the public token data layer for Solana builders: search, mint lookup, batch resolves, metadata enrichment, and cached token logos through a free rate-limited REST API.
Carbium Data
Carbium Data is the public token data layer for Solana builders.
The first live surface is the Carbium Token Index API at tokens.carbium.io. It exposes plain REST endpoints for token search, single-mint lookup, 500-mint batch resolves, and cached logo delivery. The service is free to start, rate-limited by route, and callable without an API key.
Use this section when your app, bot, wallet, agent, or backend needs token metadata close to the rest of the Carbium stack.
What is live today
| Surface | Base URL | Status | Use it for |
|---|---|---|---|
| Token Index API | https://tokens.carbium.io | Live | Search, mint lookup, batch resolves, token logos |
| Token API reference page | https://tokens.carbium.io/endpoints | Live | Interactive endpoint docs and examples |
| Swap API quote data | https://api.carbium.io | Live | Route and swap quote data |
| Carbium gRPC | grpc.carbium.io | Live | Real-time Solana activity streams |
| CQ1 Data Layer | Docs | Live docs | Architecture behind Carbium route freshness |
This page focuses on the public token data surface. Swap quotes, gRPC streams, and CQ1 internals remain separate docs areas.
What the Token Index API gives you
The Token Index API is designed for the basic token-data jobs builders hit constantly:
- find tokens by mint, symbol, or partial name
- resolve one mint into a full token record
- resolve up to 500 mints in one batch request
- load token logos through a cached proxy instead of depending directly on upstream image URLs
- distinguish SPL and Token-2022 mints when needed
- inspect enrichment fields such as supply, authorities, Metaplex URI, external links, tags, and logo status when available
The index is kept fresh through Carbium infrastructure using Solana RPC, Yellowstone, and Metaplex / Token-2022 enrichment. Records can contain nullable fields when older rows or low-signal tokens have not yet produced complete metadata.
Treat nullable fields as normal token-index behavior. Your integration should handle missing logos, missing descriptions, unknown tags, or incomplete authority fields gracefully.
Endpoints at a glance
| Method | Path | Use |
|---|---|---|
GET | /tokens | Search or list tokens by text query, page, and limit |
GET | /tokens/:mint | Resolve one SPL or Token-2022 mint address |
POST | /tokens/batch | Resolve up to 500 mint addresses in one request |
GET | /img/:mint | Return a cached token logo image for a mint |
The API is plain REST over HTTPS. POST /tokens/batch expects application/json. Authentication is not required. CORS is permissive, so browser clients can call the API directly when the rate limits fit the use case.
Where to start
If you want the shortest path, go to Quick Start Data.
If you already know the endpoint you need, go to Token API Calls.
If you are building a wallet, swap UI, dashboard, or token table, use Build a Token Selector With Carbium Data for debounced search, batch hydration, logo fallback, and nullable metadata handling.
If you are planning production usage, read Rate Limits before shipping.
Related Carbium docs
- Quick Start API for Swap API quote and execution flows
- Carbium gRPC for real-time stream use cases
- CQ1 Data Layer for the state model behind routing freshness
- AI Assistant Context File when you want an agent or coding assistant to understand the Carbium stack
Updated 3 days ago