Quote

Use this page when you are maintaining or testing Carbium's older provider-specific quote surface:

GET https://api.carbium.io/api/v1/quote

This endpoint returns quote data for one requested provider. It does not build or submit a transaction.

For most new executable quote flows, start with Q1 instead. Q1 uses GET /api/v2/quote and can return a txn payload when user_account is included.

Part of the Carbium Solana infrastructure stack.

What this endpoint is for

GET /api/v1/quote is useful when your integration needs a quote from a specific documented provider before deciding whether to build a transaction.

Use v1 Quote when you need to...	Use another page when you need to...
inspect one provider-specific quote	compare all documented providers
read output amount, minimum received, and price impact	request an executable Q1 transaction payload
keep an older `fromMint` / `toMint` integration working	sign, submit, or confirm a transaction

This page is a reference companion. It keeps the older v1 quote request understandable without replacing the Q1, All Quote, or Swap guides.

Request shape

Method: GET

URL:

https://api.carbium.io/api/v1/quote

Headers:

X-API-KEY: YOUR_API_KEY
accept: text/plain

Parameter	Required	Meaning
`fromMint`	Yes	Input token mint
`toMint`	Yes	Output token mint
`amount`	Yes	Raw input amount in smallest units
`slippage`	Yes	Slippage tolerance in basis points
`provider`	Yes	Provider route to quote

📘
Quote belongs to the older v1 request family. Use fromMint, toMint, amount, slippage, and provider here. Do not send Q1 fields like src_mint, dst_mint, amount_in, or slippage_bps to this endpoint.

Minimal request

curl --request GET \
  --url 'https://api.carbium.io/api/v1/quote?fromMint=So11111111111111111111111111111111111111112&toMint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=1000000&slippage=100&provider=raydium' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'accept: text/plain'

This example requests a provider-specific SOL -> USDC quote with 100 basis points of slippage.

If you want to compare multiple providers for the same pair and amount, use All Quote.

How to read the response

The guide examples for this surface show a successful quote response with a success flag and a data object.

{
  "success": true,
  "data": {
    "inputMint": "So11111111111111111111111111111111111111112",
    "inAmount": "1000000",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "outAmount": "1257091",
    "minimumReceived": "1244520",
    "slippage": 100,
    "priceImpactPercent": "0.0131272710219024683117714326"
  }
}

Field	How to use it
`inputMint` / `outputMint`	Confirm the quote is for the pair you requested
`inAmount`	Confirm the raw input amount
`outAmount`	Read the expected output amount before slippage
`minimumReceived`	Check the slippage-bounded minimum output
`slippage`	Confirm the basis-point tolerance applied to the quote
`priceImpactPercent`	Flag routes that may be too expensive for the trade size

Treat the response as quote data only. It is not a signed transaction, and it is not proof that a swap has landed on-chain.

Where Quote fits in the swap path

Use this endpoint as an early decision step:

get a Swap API key
request a quote for a specific provider
check output amount, minimum received, and price impact
decide whether to compare more providers or build a transaction
move to Q1 or Swap when you need an executable payload

Next need	Go to
Current quote -> transaction flow	Q1
Provider-by-provider comparison	All Quote
Older provider-specific transaction build	Swap
Auth, route, or request-shape failure triage	Swap API Errors Reference

Common mistakes

Symptom	Likely cause	First fix
`401` or missing-key error	The request did not include a Swap API key	Send `X-API-KEY` from your backend
`400` with route or pool failure	The selected provider cannot quote that pair, size, or path	Try All Quote or change provider, pair, or amount
Empty or unexpected response fields	Request family mismatch	Keep `fromMint`, `toMint`, `amount`, `slippage`, and `provider` on the `v1` path
Quote succeeds but no transaction appears	This endpoint only quotes	Move to Q1 with `user_account` or use the documented `v1` Swap endpoint

Use API Commands when you are unsure which request family owns the command you need.

🔶
Use Quote for provider-specific v1 pricing checks, then move into All Quote, Q1, or Swap when the integration needs comparison or execution. Platform access starts at carbium.io.