Cambrian Pool Info API

By Cambrian Network solana

GET /api/v1/solana/raydium-clmm/pool

Raydium CLMM Pool Info

Overview

Returns detailed pool information for a specific Raydium CLMM (Concentrated Liquidity Market Maker) pool on Solana. The response includes pricing, tick/liquidity state, token metadata, TVL, volume, fees, and APR metrics for the requested pool.

Business Value

  • Pool Analysis: Get real-time metrics for specific Raydium CLMM pools including TVL, APR, and 24h volume
  • Trading Intelligence: Access current price, tick information, and liquidity utilization for informed trading decisions
  • Risk Assessment: Monitor pool volatility, fee tiers, and utilization rates to evaluate investment opportunities
  • Portfolio Management: Track performance metrics and fees generated by liquidity positions
  • Market Research: Analyze token pair dynamics and pool efficiency across different fee tiers

Endpoint Details

URL:

https://api.cambrian.org/solana/raydium-clmm/pool

Method: GET
Authentication: Required via X-API-Key header

Query Parameters

Parameter Type Required Default Description
pool_addresses string Yes - Comma-separated pool addresses within the same DEX. Example: addr1,addr2,addr3

Response Field Descriptions

Response Field Type Description
chainId UInt16 Chain identifier (900 = Solana)
dexAddress String On-chain program/DEX address for Raydium CLMM
dexName String Name of the DEX (Raydium CLMM)
poolAddress FixedString(44) Pool address
createdAt DateTime('UTC') Timestamp when the pool was created
token0Address FixedString(44) Mint address of token0
token0Symbol String Symbol of token0
token0Decimals UInt8 Decimal precision of token0
token1Address FixedString(44) Mint address of token1
token1Symbol String Symbol of token1
token1Decimals UInt8 Decimal precision of token1
feeTier UInt32 Pool fee tier
tickSpacing UInt16 Tick spacing configured for the pool
sqrtPriceX64 UInt128 Current square root price in X64 fixed-point format
tick Int32 Current tick index of the pool
price Nullable(Float64) Current pool price (token1 per token0)
lastSwapTime DateTime('UTC') Timestamp of the most recent swap
tokenVault0 FixedString(44) Vault address holding token0 reserves
tokenVault1 FixedString(44) Vault address holding token1 reserves
token0PriceUSD Float64 USD price of token0
token1PriceUSD Float64 USD price of token1
tvlToken0 Nullable(Float64) Total value locked denominated in token0
tvlToken1 Nullable(Float64) Total value locked denominated in token1
tvl Nullable(Float64) Total value locked in USD
volumeToken0 Nullable(Float64) Trading volume in token0 units
volumeToken1 Nullable(Float64) Trading volume in token1 units
volume24h Nullable(Float64) 24-hour trading volume in USD
fees24h Nullable(Float64) 24-hour fees generated in USD
apr24h Nullable(Float64) Annualized percentage rate based on 24h fees
priceVolatility Nullable(Float64) Price volatility measure for the pool
utilization24h Nullable(Float64) 24-hour liquidity utilization percentage
swaps24h UInt64 Number of swaps executed in the last 24 hours
ticksUsed24h UInt64 Number of distinct ticks used in the last 24 hours

Examples

1. Retrieve Pool Info for a Raydium CLMM Pool

Fetch comprehensive pool metrics for a single Raydium CLMM SOL/USDC pool, including price, TVL, volume, and APR.

curl -X GET "https://api.cambrian.org/solana/raydium-clmm/pool?pool_addresses=3ucNos4NbumPLZNWztqGHNFFgkHeRMBQAVemeeomsUxv" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "columns": [
      {
        "name": "chainId",
        "type": "UInt16"
      },
      {
        "name": "dexAddress",
        "type": "String"
      },
      {
        "name": "dexName",
        "type": "String"
      },
      {
        "name": "poolAddress",
        "type": "FixedString(44)"
      },
      {
        "name": "createdAt",
        "type": "DateTime('UTC')"
      },
      {
        "name": "token0Address",
        "type": "FixedString(44)"
      },
      {
        "name": "token0Symbol",
        "type": "String"
      },
      {
        "name": "token0Decimals",
        "type": "UInt8"
      },
      {
        "name": "token1Address",
        "type": "FixedString(44)"
      },
      {
        "name": "token1Symbol",
        "type": "String"
      },
      {
        "name": "token1Decimals",
        "type": "UInt8"
      },
      {
        "name": "feeTier",
        "type": "UInt32"
      },
      {
        "name": "tickSpacing",
        "type": "UInt16"
      },
      {
        "name": "sqrtPriceX64",
        "type": "UInt128"
      },
      {
        "name": "tick",
        "type": "Int32"
      },
      {
        "name": "price",
        "type": "Nullable(Float64)"
      },
      {
        "name": "lastSwapTime",
        "type": "DateTime('UTC')"
      },
      {
        "name": "tokenVault0",
        "type": "FixedString(44)"
      },
      {
        "name": "tokenVault1",
        "type": "FixedString(44)"
      },
      {
        "name": "token0PriceUSD",
        "type": "Float64"
      },
      {
        "name": "token1PriceUSD",
        "type": "Float64"
      },
      {
        "name": "tvlToken0",
        "type": "Nullable(Float64)"
      },
      {
        "name": "tvlToken1",
        "type": "Nullable(Float64)"
      },
      {
        "name": "tvl",
        "type": "Nullable(Float64)"
      },
      {
        "name": "volumeToken0",
        "type": "Nullable(Float64)"
      },
      {
        "name": "volumeToken1",
        "type": "Nullable(Float64)"
      },
      {
        "name": "volume24h",
        "type": "Nullable(Float64)"
      },
      {
        "name": "fees24h",
        "type": "Nullable(Float64)"
      },
      {
        "name": "apr24h",
        "type": "Nullable(Float64)"
      },
      {
        "name": "priceVolatility",
        "type": "Nullable(Float64)"
      },
      {
        "name": "utilization24h",
        "type": "Nullable(Float64)"
      },
      {
        "name": "swaps24h",
        "type": "UInt64"
      },
      {
        "name": "ticksUsed24h",
        "type": "UInt64"
      }
    ],
    "data": [
      [
        900,
        "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK",
        "Raydium CLMM",
        "3ucNos4NbumPLZNWztqGHNFFgkHeRMBQAVemeeomsUxv",
        "2024-08-07T13:33:36+00:00",
        "So11111111111111111111111111111111111111112",
        "SOL",
        9,
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "USDC",
        6,
        400,
        1,
        5851998955156811000,
        -22964,
        100.63963078966454,
        "2026-08-25T08:46:46+00:00",
        "4ct7br2vTPzfdmY3S5HLtTxcGSBfn6pnw98hsS6v359A",
        "5it83u57VRrVgc51oNV19TTmAJuffPx5GtGwQr7gQNUo",
        100.65902924569463,
        1,
        32307.84666239,
        3053965.95657,
        6306042.438624932,
        563506.102761191,
        55269131.471122,
        56721977.27796612,
        22688.790911186446,
        131.3249754213335,
        0.01358530454169533,
        100,
        69590,
        923
      ]
    ],
    "rows": 1
  }
]

Result collections are limited to 10 items. This example returns a single row for the requested pool address, showing the SOL/USDC Raydium CLMM pool with a current price of ~100.64 USDC per SOL, ~$6.3M TVL, ~$56.7M in 24h volume, and a 24h APR of ~0.0136%.

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2), letting you pay $0.05 USDC per request using blockchain micropayments. No API key required.

Quick Start (TypeScript)

npm install @x402/fetch @x402/evm viem
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));

const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const response = await fetchWithPayment(
  "https://x402.cambrian.org/solana/raydium-clmm/pool"
);
const data = await response.json();

Quick Start (Python)

pip install "x402[httpx]"
import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client()
    account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
    register_exact_evm_client(client, EthAccountSigner(account))

    async with x402HttpxClient(client) as http:
        response = await http.get("https://x402.cambrian.org/solana/raydium-clmm/pool")
        print(response.json())

asyncio.run(main())

Payment Flow

  1. Send a normal request to the endpoint (no API key needed)
  2. Server returns 402 Payment Required with payment details
  3. The x402 SDK automatically signs a payment authorization with your wallet
  4. The SDK resubmits the request with the signed payment
  5. Server verifies payment and returns the API response

The x402 SDK handles steps 2 through 5 automatically.

Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request