# Raydium API
> Live data from Raydium, the largest automated-market-maker DEX on Solana, whose standard (AMM) and concentrated-liquidity (CLMM) pools route most of Solana's on-chain swap volume. The overview endpoint returns the protocol's total value locked and 24h volume. The pools endpoint returns the top pools by liquidity, volume, APR or fees — each with its pair, type, price, TVL, 24h volume, fee APR and fee rate. The pool endpoint returns one pool's full state by id, including weekly and monthly volume and the CLMM price range. The price endpoint returns the live USD price of one or more SPL tokens by mint address, with symbol shortcuts for SOL, RAY, USDC and more. Read live from Raydium, nothing stored. This is Raydium's own Solana AMM/CLMM pool, TVL/volume/APR and token-pricing layer — distinct from Ethereum AMM feeds (Balancer, Curve), order-book/perps DEX feeds and swap aggregators.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/raydium-api/..."
```

## Pricing
- **Free** (Free) — 2,000 calls/Mo, 3 req/s
- **Starter** ($10/Mo) — 55,000 calls/Mo, 15 req/s
- **Pro** ($27/Mo) — 300,000 calls/Mo, 40 req/s
- **Scale** ($62/Mo) — 1,900,000 calls/Mo, 120 req/s

## Endpoints

### Overview

#### `GET /v1/overview` — Protocol TVL and 24h volume

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/raydium-api/v1/overview"
```

**Response:**
```json
{
    "data": {
        "chain": "solana",
        "source": "Raydium",
        "tvl_usd": 1364804044.57,
        "protocol": "Raydium",
        "volume_24h_usd": 234154439.53
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:24.264Z",
        "request_id": "13ffb8e7-aa9f-4948-9261-ca78cac63bc7"
    },
    "status": "ok",
    "message": "Overview retrieved successfully",
    "success": true
}
```

### Pools

#### `GET /v1/pools` — Top pools by liquidity, volume, APR or fees

**Parameters:**
- `type` (query, optional, string) — all (default), standard or concentrated Example: `all`
- `sort` (query, optional, string) — liquidity, volume24h, apr24h or fee24h Example: `liquidity`
- `limit` (query, optional, string) — Max results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/raydium-api/v1/pools?type=all&sort=liquidity&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "liquidity",
        "type": "all",
        "count": 25,
        "pools": [
            {
                "id": "iM3qCD3h5x83bwdRVrWC1SV7mF261E9U6jsFyhCZhxi",
                "pair": "SAOS-USDC",
                "type": "Concentrated",
                "price": 0.00082391,
                "mint_a": "3eB8npQ18hPmEsAF3snBPYFSVyoTSAyTDwdEJCVpM96V",
                "mint_b": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "tvl_usd": 60969607.69,
                "fee_rate": 0.0001,
                "apr_24h_pct": 0,
                "fee_24h_usd": 0.12,
                "volume_24h_usd": 1209.34
            },
            {
                "id": "3gmHqt2dq6xeWatew3dxREagBs6Jut8fhwRsrCg9dfEQ",
                "pair": "USRUB-USDT",
                "type": "Concentrated",
                "price": 0.01000201,
                "mint_a": "9Audab7xtUtHS2B6Tr7xJQtpUyANT3wgB8idsveLydME",
                "mint_b": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
                "tvl_usd": 36979008.36,
                "fee_rate": 0.0001,
                "apr_24h_pct": 0,
                "fee_24h_usd": 0.04,
                "volume_24h_usd": 401.16
            },
            {
                "id": "AS5MV3ear4NZPMWXbCsEz3AdbCaXEnq4ChdaWsvLgkcM",
                "pair": "USDS-USDC",
                "type": "Concentrated",
                "price": 1.00005994,
                "mint_a": "USDSwr9ApdHk5bvJKMjzff41FfuX8bSxdKcR81vTwcA",
                "mint_
…(truncated, see openapi.json for full schema)
```

### Pool

#### `GET /v1/pool` — One pool's full state by id

**Parameters:**
- `id` (query, required, string) — Raydium pool id Example: `iM3qCD3h5x83bwdRVrWC1SV7mF261E9U6jsFyhCZhxi`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/raydium-api/v1/pool?id=iM3qCD3h5x83bwdRVrWC1SV7mF261E9U6jsFyhCZhxi"
```

**Response:**
```json
{
    "data": {
        "id": "iM3qCD3h5x83bwdRVrWC1SV7mF261E9U6jsFyhCZhxi",
        "pair": "SAOS-USDC",
        "type": "Concentrated",
        "price": 0.00082391,
        "mint_a": "3eB8npQ18hPmEsAF3snBPYFSVyoTSAyTDwdEJCVpM96V",
        "mint_b": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "source": "Raydium",
        "tvl_usd": 60969607.69,
        "fee_rate": 0.0001,
        "apr_7d_pct": 0,
        "apr_24h_pct": 0,
        "fee_24h_usd": 0.12,
        "tvl_amount_a": 73975457251.48228,
        "tvl_amount_b": 20223.159732,
        "price_max_24h": 0.00082409,
        "price_min_24h": 0.00082383,
        "volume_7d_usd": 20559.53,
        "volume_24h_usd": 1209.34,
        "volume_30d_usd": 20559.53
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:25.036Z",
        "request_id": "8df1b2df-b1d2-4bf6-963b-8c097834e8cc"
    },
    "status": "ok",
    "message": "Pool retrieved successfully",
    "success": true
}
```

### Price

#### `GET /v1/price` — Live USD price of SPL token(s)

**Parameters:**
- `mint` (query, required, string) — Mint address or symbol (comma-separated) Example: `SOL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/raydium-api/v1/price?mint=SOL"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "prices": [
            {
                "mint": "So11111111111111111111111111111111111111112",
                "input": "SOL",
                "price_usd": 62.81267105520237
            }
        ],
        "source": "Raydium"
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:25.415Z",
        "request_id": "f9d5275e-c1bf-470d-b4a8-d20633eee818"
    },
    "status": "ok",
    "message": "Price retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/raydium-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Raydium API v3 (api-v3.raydium.io, live)",
        "service": "raydium-api",
        "symbols": [
            "SOL",
            "WSOL",
            "RAY",
            "USDC",
            "USDT",
            "MSOL",
            "JITOSOL",
            "BONK",
            "JUP",
            "WIF"
        ],
        "tvl_usd": 1364804044.57,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/pool": "One pool's full state by id (id=…).",
            "GET /v1/pools": "Top pools by liquidity/volume/apr/fees (type=all, sort=liquidity, limit=25).",
            "GET /v1/price": "Live USD price of SPL token(s) by mint or symbol (mint=SOL or comma-separated).",
            "GET /v1/overview": "Protocol total value locked and 24h volume."
        },
        "description": "Live data from Raydium, the largest automated-market-maker DEX on Solana, whose standard (AMM) and concentrated-liquidity (CLMM) pools route most of Solana's on-chain swap volume. The overview endpoint returns the protocol's total value locked and 24h volume; the pools endpoint returns the top pools by liquidity, volume, APR or fees (pair, type, price, TVL, 24h volume, fee APR, fee rate); the pool endpoint returns one pool's full state by id (with weekly/monthly volume and the CLMM price range); the price endpoint returns the live USD price of one or more SPL tokens by mint address (with symbol shortcuts for SOL, RAY, USDC …). Live, no key, n
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/raydium-api
OpenAPI spec: https://www.oanor.com/api/raydium-api/openapi.json