Cambrian Pool Info API

By Cambrian Network solana

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

Raydium CLMM Pool Details

This endpoint returns detailed information for a specific Raydium Concentrated Liquidity Market Maker (CLMM) pool on Solana. It provides comprehensive pool metrics including liquidity, trading volume, fees, and token details.

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://opabinia.cambrian.network/api/v1/solana/raydium-clmm/pool

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

Query Parameters

Parameter Type Required Default Description
pool_address string Yes - Program ID for raydium clmm pool (e.g., 3ucNos4NbumPLZNWztqGHNFFgkHeRMBQAVemeeomsUxv)

Response Field Descriptions

Response Field Type Description
chainId UInt16 Solana chain identifier (900)
dexAddress String DEX contract address for Raydium CLMM
dexName String Name of the DEX (Raydium CLMM)
poolAddress String Unique pool address identifier
createdAt DateTime Pool creation timestamp in UTC
token0Address String Address of the first token in the pair
token0Symbol String Symbol of the first token (e.g., SOL)
token0Decimals UInt8 Decimal places for token0
token1Address String Address of the second token in the pair
token1Symbol String Symbol of the second token (e.g., USDC)
token1Decimals UInt8 Decimal places for token1
feeTier UInt32 Fee tier in basis points (400 = 0.04%)
tickSpacing UInt16 Tick spacing for the pool
sqrtPriceX64 UInt128 Square root price encoded as X64
tick Int32 Current tick of the pool
price Float64 Current price of token0 in terms of token1
tvlToken0 Float64 Total value locked in token0
tvlToken1 Float64 Total value locked in token1
tvlToken0Usd Float64 USD value of token0 TVL
tvlToken1Usd Float64 USD value of token1 TVL
tvl Float64 Total value locked in USD
volume24h Float64 24-hour trading volume in USD
fees24h Float64 24-hour fees generated in USD
apr24h Float64 24-hour annualized percentage rate
priceVolatility Float64 Price volatility metric
utilization24h Float64 24-hour utilization percentage

Examples

1. Get SOL/USDC Pool Details

Retrieve detailed metrics for a popular SOL/USDC Raydium CLMM pool to analyze its performance and liquidity characteristics.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/raydium-clmm/pool?pool_address=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": "Float64"
    },
    {
      "name": "tvlToken0",
      "type": "Float64"
    },
    {
      "name": "tvlToken1",
      "type": "Float64"
    },
    {
      "name": "tvlToken0Usd",
      "type": "Float64"
    },
    {
      "name": "tvlToken1Usd",
      "type": "Float64"
    },
    {
      "name": "tvl",
      "type": "Float64"
    },
    {
      "name": "volume24h",
      "type": "Float64"
    },
    {
      "name": "fees24h",
      "type": "Float64"
    },
    {
      "name": "apr24h",
      "type": "Float64"
    },
    {
      "name": "priceVolatility",
      "type": "Float64"
    },
    {
      "name": "utilization24h",
      "type": "Float64"
    }
  ],
  "data": [
    [
      900,
      "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK",
      "Raydium CLMM",
      "3ucNos4NbumPLZNWztqGHNFFgkHeRMBQAVemeeomsUxv",
      "2024-08-07T13:33:36+00:00",
      "So11111111111111111111111111111111111111112",
      "SOL",
      9,
      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "USDC",
      6,
      400,
      1,
      6569193630558585018,
      -20651,
      126.81910422292906,
      60751.624493078,
      1705223.245765,
      7706574.359120288,
      1705223.245765,
      9411797.604885288,
      19638951.014971666,
      7855.580405988667,
      30.46481627162881,
      0.005128117610933924,
      100.0
    ]
  ],
  "rows": 1
}

This response shows a SOL/USDC pool with $9.4M TVL, 30.46% APR, and $19.6M in 24h volume, indicating high liquidity and active trading.

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2) — 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://deep42.cambrian.network/api/v1/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://deep42.cambrian.network/api/v1/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–5 automatically.

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


Related Endpoints

  • /api/v1/solana/pool-transactions - Get transaction history for Solana pools
  • /api/v1/solana/raydium-clmm/pool-multi - Get comprehensive overview metrics for multiple pools/pairs simultaneously within the same DEX