> ## 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.

# Raydium API v3

> REST API for querying Raydium pools, mints, farms, and chain data on Solana

## 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

| Environment | URL                                |
| ----------- | ---------------------------------- |
| **Mainnet** | `https://api-v3.raydium.io`        |
| **Devnet**  | `https://api-v3-devnet.raydium.io` |

## Response envelope

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

### Success response

```json theme={null}
{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-specific data
  }
}
```

### Error response

```json theme={null}
{
  "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`](/api-reference/temp-api-v1/overview).

## Related documentation

* [REST API overview](/sdk-api/rest-api)
* [API reference](/api-reference)
* [Integration guide for aggregators](/integration-guides/aggregator)

## Example usage

**Get main statistics:**

```bash theme={null}
curl -s https://api-v3.raydium.io/main/info | jq .
```

**List top 10 pools by TVL:**

```bash theme={null}
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:**

```bash theme={null}
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:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
```

**Get farm pools for an LP token:**

```bash theme={null}
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](https://x.com/Raydium).