# Orca Solana DEX (Whirlpools) API
> Live concentrated-liquidity DEX data from Orca, the leading Solana CLMM exchange, over its public Whirlpools API — no key, nothing stored. This is the Solana on-chain liquidity view: every Whirlpool with its value locked, trading volume, price and the yield earned by liquidity providers, distinct from the aggregator, AMM and other DeFi APIs in the catalogue — Orca is concentrated-liquidity (Uniswap-V3-style) on Solana. The pools endpoint lists Whirlpools, optionally filtered by token and ranked by value locked or 24h volume, each with its pair, price, fee tier, volume and APR. The pool endpoint returns one Whirlpool in full by its on-chain address — including 7-day and 30-day volume, weekly and monthly APR, the fee APR, tick spacing and token mints. The summary endpoint aggregates the DEX: total value locked, 24h volume, pool count and the top pools by liquidity and by volume. Build Solana DeFi dashboards, LP yield scanners, liquidity monitors and trading tools on top of real Orca data. Filter by token symbol (SOL, USDC); APR and fee rates are returned as percentages and only pools above $1k TVL are listed.

## 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/orca-api/..."
```

## Pricing
- **Free** (Free) — 13,200 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 198,000 calls/Mo, 10 req/s
- **Pro** ($25/Mo) — 810,000 calls/Mo, 28 req/s
- **Scale** ($56/Mo) — 2,920,000 calls/Mo, 60 req/s

## Endpoints

### Pools

#### `GET /v1/pools` — Whirlpools ranked by TVL or volume

**Parameters:**
- `token` (query, optional, string) — Filter by token symbol (SOL, USDC) Example: `SOL`
- `sort` (query, optional, string) — tvl (default) or volume Example: `volume`
- `limit` (query, optional, string) — Max pools (default 50, max 200) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/orca-api/v1/pools?token=SOL&sort=volume&limit=50"
```

**Response:**
```json
{
    "data": {
        "dex": "Orca",
        "sort": "volume_24h",
        "chain": "Solana",
        "count": 718,
        "pools": [
            {
                "pair": "SOL/USDC",
                "price": 127.49637274179749,
                "address": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
                "fee_pct": 0.04,
                "token_a": "SOL",
                "token_b": "USDC",
                "tvl_usd": 32526289.16,
                "apr_day_pct": 59.33,
                "volume_24h_usd": 230667978.94
            },
            {
                "pair": "SOL/Fartcoin ",
                "price": 289.60115842066847,
                "address": "C9U2Ksk6KKWvLEeo5yUQ7Xu46X7NzeBJtd9PBfuXaUSM",
                "fee_pct": 0.16,
                "token_a": "SOL",
                "token_b": "Fartcoin ",
                "tvl_usd": 3407153.62,
                "apr_day_pct": 495.73,
                "volume_24h_usd": 51209591.38
            },
            {
                "pair": "SOL/JitoSOL",
                "price": 0.8400490396166846,
                "address": "Hp53XEtt4S8SvPCXarsLSdGfZBuUr5mMmZmX2DRNXQKp",
                "fee_pct": 0.01,
                "token_a": "SOL",
                "token_b": "JitoSOL",
                "tvl_usd": 31439173.85,
                "apr_day_pct": 1.12,
                "volume_24h_usd": 20121510.23
            },
            {
                "pair": "SOL/WBTC",
                "price": 0.0015247534004551302,
                
…(truncated, see openapi.json for full schema)
```

### Pool

#### `GET /v1/pool` — One Whirlpool in full by address

**Parameters:**
- `address` (query, required, string) — On-chain Whirlpool address Example: `Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE`

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

**Response:**
```json
{
    "data": {
        "dex": "Orca",
        "pair": "SOL/USDC",
        "chain": "Solana",
        "price": 127.49637274179749,
        "source": "Orca",
        "address": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
        "fee_pct": 0.04,
        "token_a": "SOL",
        "token_b": "USDC",
        "tvl_usd": 32526289.16,
        "apr_day_pct": 59.33,
        "apr_week_pct": 45.77,
        "tick_spacing": 4,
        "token_a_mint": "So11111111111111111111111111111111111111112",
        "token_b_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "apr_month_pct": 95.06,
        "volume_7d_usd": 1500042571.68,
        "volume_24h_usd": 230667978.94,
        "volume_30d_usd": 12409384514.68,
        "fee_apr_day_pct": 59.33,
        "protocol_fee_pct": 13
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:21.929Z",
        "request_id": "5ef1e14d-5d58-4531-9778-d8fc80754ff9"
    },
    "status": "ok",
    "message": "Pool retrieved successfully",
    "success": true
}
```

### Summary

#### `GET /v1/summary` — DEX aggregate — TVL, volume, top pools

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

**Response:**
```json
{
    "data": {
        "dex": "Orca",
        "chain": "Solana",
        "source": "Orca",
        "pool_count": 1345,
        "top_by_tvl": [
            {
                "pair": "SOL/SOLX",
                "price": 82152.68870071108,
                "address": "ies9H9m19fZDxfDeMVRLHCvuTVM9WMTP5ViTcLmfgZc",
                "fee_pct": 0.01,
                "token_a": "SOL",
                "token_b": "SOLX",
                "tvl_usd": 228459312.85,
                "apr_day_pct": 0.03,
                "volume_24h_usd": 213943.35
            },
            {
                "pair": "SOL/GUNZ",
                "price": 12498.055357178217,
                "address": "EsHdGQHE9ehPpEeJkPYZBLqMWptAXHJtQcb91mLL1Ef7",
                "fee_pct": 0.01,
                "token_a": "SOL",
                "token_b": "GUNZ",
                "tvl_usd": 33844450.96,
                "apr_day_pct": 0.2,
                "volume_24h_usd": 56357.87
            },
            {
                "pair": "SOL/USDC",
                "price": 127.49637274179749,
                "address": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
                "fee_pct": 0.04,
                "token_a": "SOL",
                "token_b": "USDC",
                "tvl_usd": 32526289.16,
                "apr_day_pct": 59.33,
                "volume_24h_usd": 230667978.94
            },
            {
                "pair": "SOL/JitoSOL",
                "price": 0.8400490396166846,
                "address": "Hp53X
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Filter pools by token symbol (token=SOL, token=USDC) and sort by tvl (default) or volume. A pool is looked up by its on-chain Whirlpool address. APR and fee rates are percentages; only pools above $1k TVL are listed.",
        "source": "Orca public Whirlpools API (api.mainnet.orca.so/v1, live)",
        "service": "orca-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/pool": "One Whirlpool in full by address (address=...).",
            "GET /v1/pools": "Whirlpools ranked by TVL or volume (token=SOL, sort=tvl|volume, limit=50 — all optional).",
            "GET /v1/summary": "DEX aggregate — TVL, 24h volume, top pools by liquidity and volume."
        },
        "description": "Live concentrated-liquidity DEX data from Orca, the leading Solana CLMM exchange, over its public Whirlpools API. The Solana on-chain liquidity view — every Whirlpool with its value locked, trading volume, price and the yield earned by liquidity providers. pools = Whirlpools (optionally filtered by token) ranked by value locked or volume, each with pair, price, fee tier, 24h volume and APR; pool = one Whirlpool in full by address (incl. 7d/30d volume, weekly/monthly APR, fee APR, tick spacing, token mints); summary = the DEX aggregate (total value locked, 24h volume, pool count, top pools by liquidity and volume). Live, no key, nothing stored. Concentrated-liquidity (Uniswap-V3-style) on Solana — distinct from the 
…(truncated, see openapi.json for full schema)
```


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