Cambrian Pool Info API

By Cambrian Network solana

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

Raydium CLMM Pool Info

Overview

Retrieve detailed pool information for a specific Raydium CLMM (Concentrated Liquidity Market Maker) pool on Solana. Returns pricing, liquidity, and performance metrics including TVL, 24-hour volume, fees, and APR.

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_address String Yes - Program ID for raydium clmm pool

Response Field Descriptions

Response Field Type Description
chainId UInt16 Chain ID of the network (900 for Solana)
dexAddress String Program address of the Raydium CLMM DEX
dexName String Name of the DEX (Raydium CLMM)
poolAddress FixedString(44) Address of the pool
createdAt DateTime('UTC') Timestamp when the pool was created
token0Address FixedString(44) Mint address of token0
token0Symbol String Symbol of token0
token0Decimals UInt8 Number of decimal places for token0
token1Address FixedString(44) Mint address of token1
token1Symbol String Symbol of token1
token1Decimals UInt8 Number of decimal places for token1
feeTier UInt32 Fee tier of the pool
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 Float64 Current price of token0 denominated in token1
tvlToken0 Float64 Total value locked in token0 (native units)
tvlToken1 Float64 Total value locked in token1 (native units)
tvlToken0Usd Float64 USD value of token0 TVL
tvlToken1Usd Float64 USD value of token1 TVL
tvl Float64 Total value locked in the pool, in USD
volume24h Float64 Trading volume in USD over the last 24 hours
fees24h Float64 Fees generated in USD over the last 24 hours
apr24h Float64 Annualized percentage rate based on 24-hour fees
priceVolatility Float64 Price volatility metric for the pool
utilization24h Float64 Capital utilization percentage over the last 24 hours

Examples

1. Get Pool Info for a Raydium CLMM Pool

Retrieve pool metrics for the SOL/USDC Raydium CLMM pool by its pool address.

curl -X GET "https://api.cambrian.org/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,
        5007514919866041000,
        -26081,
        73.68940653485875,
        64128.60366252,
        1340710.78242,
        4729199.201131496,
        1340710.78242,
        6069909.983551496,
        14887521.413448513,
        5955.008565379405,
        35.80906689314238,
        0.0014831762375695026,
        100
      ]
    ],
    "rows": 1
  }
]

Note: Result collections are limited to 10 items.

This response describes the SOL/USDC Raydium CLMM pool created on 2024-08-07, with a current price of ~73.69 USDC per SOL, total TVL of ~$6.07M, 24-hour volume of ~$14.89M, and a 24-hour APR of ~35.81%.

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://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

Related Endpoints

  • /solana/raydium-clmm/pool-multi - Get comprehensive overview metrics for multiple Raydium CLMM pools simultaneously
  • /solana/raydium-clmm/pools - Lists basic pool information for Raydium CLMM
  • /solana/orca/pool - Retrieves detailed metrics and information for a specific Orca pool
  • /solana/meteora-dlmm/pool - Returns basic pool information for a Meteora pool
  • /solana/pool-transactions - Retrieve a paginated list of trades/transactions for a specified Solana pool