FAQ

Q: Where should I start if I am new?

Start with the product that matches your job: - Use Quick Start RPC if you need Solana RPC access. - Use Carbium Swap API if you need quotes or executable swap transactions for an app, wallet, or bot. - Use Quick Start DEX if you want to try the browser swap flow. - Use Carbium Data Overview if you need token search, token lookup, batch hydration, or cached logo URLs.

Find current answers about Carbium RPC, Swap API, DEX, Data, SPDR, official links, support, pricing, and safe onboarding paths.

Use this page for short answers and routing. If a question needs exact request shapes, rate-limit behavior, security steps, pricing terms, or support context, follow the linked canonical page instead of treating this FAQ as the full source of truth.

Part of the Carbium full-stack Solana infrastructure platform.

Start Here

If you need to...	Go to
Verify official domains, social links, Discord, status, or product portals	Official Links
Open a useful support request	Support
Understand the full Carbium product map	Carbium Ecosystem
Get a Swap API key	Get your API key
Get an RPC key and endpoint	Get Your RPC API Key and Get Your Endpoint
Try the browser DEX	Quick Start DEX

General

What is Carbium?

Carbium is Solana infrastructure for teams that need RPC, Swap API, DEX, Data, and SPDR documentation in one stack. The public product surfaces are available through carbium.io, app.carbium.io, api.carbium.io, rpc.carbium.io, and tokens.carbium.io.

Where should I start if I am new?

Start with the product that matches your job:

Use Quick Start RPC if you need Solana RPC access.
Use Carbium Swap API if you need quotes or executable swap transactions for an app, wallet, or bot.
Use Quick Start DEX if you want to try the browser swap flow.
Use Carbium Data Overview if you need token search, token lookup, batch hydration, or cached logo URLs.

Which Carbium links are official?

Use Official Links as the verification page. It lists the current official product portals, docs, status page, social accounts, Discord invite, and community links. If a link conflicts with that page, pause before connecting a wallet, entering a key, or following instructions.

How do I get support?

Use Support. It explains what to include in a support request and links to the official Carbium Discord. Include the product surface, endpoint or page URL, time of failure, relevant status or error body, and what changed on your side.

Security note: Never post seed phrases, private keys, API keys, auth headers, cookies, or unpublished customer data in public support channels.

RPC

What is Carbium RPC for?

Carbium RPC is the Solana JSON-RPC surface for reading chain state, sending transactions, confirming signatures, and building production applications on standard Solana tooling. Start with In-Depth RPC for the product overview, then use Your First Test Call once you have an endpoint.

How do I get my RPC endpoint?

Create or copy your RPC key through the RPC portal, then use Get Your RPC API Key and Get Your Endpoint. Keep the RPC key separate from your Swap API key.

Where are RPC pricing and rate limits documented?

Use RPC Pricing and Usage Tiers for plan fit and Solana RPC Rate Limits Explained for HTTP 429 behavior, retry policy, and traffic-shaping guidance.

What should I do when an RPC request fails?

Use RPC Errors Reference. It separates HTTP errors, JSON-RPC failures, transaction/preflight failures, and support payloads. If many unrelated requests fail at once, check status.carbium.io before debugging only your code.

When should I use gRPC instead of polling?

Use gRPC when a backend needs transaction-centric real-time feeds and polling is creating latency or request-volume pressure. Start with GRPC and GRPC Use Cases. Do not use the unpublished WebSocket drafts until the WSS endpoint blocker is resolved.

Swap API

What is Carbium Swap API for?

Carbium Swap API is the trading API surface for quote, routing, and executable transaction workflows. New integrations should start from Carbium Swap API, then move to Q1 for the current GET /api/v2/quote request shape.

How is Swap API different from the browser DEX?

The browser DEX is for a user connecting a wallet and signing a swap in the UI. Swap API is for apps, wallets, bots, and backend services that need API-keyed quote or transaction construction. Use Swap on Carbium DEX for the browser flow and Carbium Swap API for integration work.

How do I get a Swap API key?

Use Get your API key. Swap API requests use the X-API-KEY header on api.carbium.io. Do not use an RPC key as a Swap API key, and do not expose the key in browser or mobile client code.

Which quote endpoint should I use?

For most new builds, use Q1 on GET https://api.carbium.io/api/v2/quote with src_mint, dst_mint, amount_in, and slippage_bps. If you maintain an older v1 flow, use API Commands to keep the endpoint family and parameter names together.

Why is my Q1 response missing txn?

If the quote succeeds but txn is empty, check whether you included user_account. The current Q1 docs describe user_account as the field that lets the quote response include an executable transaction payload. Use Swap API Errors Reference for this failure path.

Where are Swap API pricing and quotas documented?

Use Swap API Pricing, Limits, and Quotas. It is the owner for published request ceilings, public pricing signals, and the point where custom terms should be validated directly with Carbium.

DEX

What is Carbium DEX?

Carbium DEX is the browser trading interface at app.carbium.io. Use it to connect a Solana wallet, choose a pair, review a route, and sign a swap in-wallet. Start with In-Depth DEX or Quick Start DEX.

What should I check before signing a DEX swap?

Check the token mint, expected output, connected wallet account, route shown in the UI, and wallet prompt before signing. The rendered quote is the source of truth for the trade in front of you. Use Swap on Carbium DEX for the full browser-swap checklist.

What are Gasless Swaps?

Gasless Swaps are for flows where a Solana user has a token to trade but does not already hold SOL for the network fee. They do not remove wallet consent. Use Gasless Swaps for the product explanation and Gasless Token Swap for implementation guidance.

What are New Pairs?

New Pairs is the DEX discovery lane for inspecting newly visible Solana trading opportunities before signing. Use New Pairs to keep discovery tied to mint, route, output, and wallet-prompt checks.

Carbium Data

What is Carbium Data?

Carbium Data currently exposes Token Index documentation for token search, single-token lookup, batch hydration, and cached logo URLs. Start with Carbium Data Overview and Carbium Data API Calls.

Does Carbium Data require an API key?

The current public Token Index API docs describe public calls on https://tokens.carbium.io. For example, token search uses GET /tokens?q=..., and logos use /img/[mint]. Use Carbium Data API Calls for exact shapes.

How should wallets use Carbium Data?

Use Data for token display, token search, mint lookup, batch hydration, and cached logos. Do not treat token display data as swap truth. For wallet architecture, use Carbium for Wallet Developers.

SPDR

What is SPDR in the docs?

SPDR covers Carbium's staking, tokenomics, and ecosystem pages. Start with SPDR Tokenomics for token economics and Stake SPDR Token for staking.

Where should tokenomics questions go?

Use SPDR Tokenomics. Avoid relying on archived or duplicate tokenomics pages when a canonical SPDR tokenomics page exists.

Security And Safe Usage

Where should API keys live?

Keep Carbium API and RPC keys on backend infrastructure, environment variables, or a secret manager. Do not ship them in browser bundles, mobile apps, public repos, screenshots, support chats, prompts, or shared notebooks. Use API Key Security Best Practices for the full checklist.

What should I do if a key is exposed?

Rotate the key first, then check logs for abuse, separate affected services, and open a support request with timing and the affected product surface. The canonical response checklist is API Key Security Best Practices.

Is it safe to paste private keys into examples?

No. Wallet seed phrases and private keys should never be pasted into docs examples, public chats, AI prompts, or support threads. For swap execution, use the wallet or backend signing boundary described in Executing Swaps and Carbium for Wallet Developers.

Migration And Building

How do I migrate from another provider?

Start with Migrating to Carbium. It routes to provider-specific playbooks such as Helius, QuickNode, and Jupiter where the migration has different endpoint, auth, or execution assumptions.

Where should wallet teams start?

Use Carbium for Wallet Developers. It owns token display, quote construction, user signing, backend relay, Data usage, and API-key boundaries for wallet flows.

Where should trading-bot teams start?

Use Carbium for Trading Bots. It splits reader, decision, quote, signing, RPC submission, and optional gRPC streaming responsibilities.

Where should Solana developers start if they are still learning?

Use Solana Development for fundamentals and Developing with Carbium for Carbium-specific implementation guides.

Quick Troubleshooting

Symptom	First place to check
Swap API returns 401 or 403	Get your API key and Swap API Errors Reference
Q1 quote succeeds but txn is empty	Swap API Errors Reference
RPC returns 429	Solana RPC Rate Limits Explained
RPC request fails but rate limits are not the issue	RPC Errors Reference
Transaction expires or duplicate-send risk appears	Blockhash Expiry Recovery Playbook
You are not sure which link is official	Official Links

Next step: If this FAQ does not answer the question, move to the canonical page linked in the answer. For product access and the full platform path, start at carbium.io.