Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​
What is Raydium API v3?

Raydium API v3 provides a REST interface to query liquidity pools, token metadata, farms, and chain statistics across Raydium’s trading venues on Solana. It’s used by wallets, aggregators, DEX routers, and traders to source canonical pool data, price feeds, and historical analytics. The API is designed for high throughput — responses are typically 1–5 minutes stale depending on endpoint sensitivity. All responses are wrapped in a consistent envelope with metadata.

​
Base hosts

EnvironmentURL
Mainnethttps://api-v3.raydium.io
Devnethttps://api-v3-devnet.raydium.io

​
Response envelope

All endpoints return a JSON envelope with request metadata and the response payload:

​
Success response

{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-specific data
  }
}

​
Error response

{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
The id field is a unique request identifier (UUID). Always inspect success before processing data.

​
Common gotchas

​
Mint pair ordering on /pools/info/mint

When you query /pools/info/mint?mint1=ABC&mint2=XYZ, the endpoint internally normalizes the pair by sorting mints alphabetically. If you need to search for a single mint, omit mint2 entirely — the API will find all pools containing that mint.

​
Pool type filter values

The poolType query parameter accepts specific enum values:
  • all — all pool types
  • concentrated — CLMM pools only
  • standard — AMM (constant-product) pools only
  • allFarm — pools with at least one active farm
  • concentratedFarm — concentrated pools with farms
  • standardFarm — standard pools with farms
Typos or case sensitivity mismatches will be rejected.

​
Pool sort field values

Valid poolSortField values are:
  • default (sorts by 24h volume)
  • liquidity (TVL)
  • volume24h, volume7d, volume30d
  • fee24h, fee7d, fee30d
  • apr24h, apr7d, apr30d

​
Pagination with /pools/info/list-v2

The v2 endpoint uses cursor-based pagination via nextPageId. The opaque token is returned in the response and must be passed back verbatim. Do not attempt to construct your own cursor — it encodes Elasticsearch state.

​
Page size defaults and limits

  • /pools/info/list and /pools/info/mint cap pageSize at 1000.
  • /farms/info/lp caps pageSize at 100.
  • /pools/info/list-v2 caps size at 1000.
Requests exceeding limits are rejected with an error.

​
CLMM dynamic-fee and limit-order configs

Two new endpoints expose calibration data for the CLMM CreateCustomizablePool flow:
  • GET /main/clmm-dynamic-config — list of DynamicFeeConfig tiers (filter period, decay period, reduction factor, max numerator, dynamic-fee control). Pass the id of one of these into createCustomizablePool when enableDynamicFee=true.
  • GET /main/clmm-limit-order-config — per-pool limit-order configuration: whether limit orders are enabled, the minimum input amount, and the off-chain limit_order_admin keeper authorized to settle filled orders.
Per-wallet limit-order data (open / filled / closed) lives on Temp API; see api-reference/temp-api-v1/overview.

​
Example usage

Get main statistics: 
curl -s https://api-v3.raydium.io/main/info | jq .
List top 10 pools by TVL: 
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
Get SOL-USDC pools: 
curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .
Get mint prices: 
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
Get farm pools for an LP token: 
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .

​
Status and availability

The Raydium API v3 is live on mainnet. For availability and incidents, follow @Raydium.