Cambrian V3 - Pool Info API

By Cambrian Network pancake

GET /api/v1/evm/pancake/v3/pool

PancakeSwap V3 Pool Info

Overview

Returns current pool metrics for a specific PancakeSwap V3 pool, including TVL (Total Value Locked), Swap Volume, Fees APR (Annual Percentage Rate), Price Tick Utilization, Number of Swaps, and Unique Users. Data is provided across multiple recent time ranges: 5 minutes, 1 hour, 1 day, 1 week, 1 month, and 1 year.

Business Value

  • Pool Performance Monitoring: Track key metrics like TVL, volume, and fees to assess pool health and profitability
  • Liquidity Analysis: Monitor price tick utilization to understand how efficiently liquidity is being used
  • User Activity Insights: Analyze swap counts and unique user metrics across different time periods for activity trends
  • APR Calculations: Access fees APR data for yield farming and liquidity provision decision making
  • Historical Context: Compare performance across multiple time ranges from 5 minutes to 1 year for trend analysis

Endpoint Details

URL: 

https://opabinia.cambrian.network/api/v1/evm/pancake/v3/pool

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

Query Parameters

Parameter Type Required Default Description
pool_address string Yes - Pool contract address with 0x prefix (pattern: ^0x[a-fA-F0-9]{40}$)

Response Field Descriptions

Response Field Type Description
createdAt DateTime (UTC) Timestamp when the pool was created
token0Address String Contract address of token0 in the pool
token0Symbol String Ticker symbol of token0
token0Decimals UInt8 Decimal places for token0
token1Address String Contract address of token1 in the pool
token1Symbol String Ticker symbol of token1
token1Decimals UInt8 Decimal places for token1
feeTier UInt32 Pool fee tier in basis points (e.g., 100 = 0.01%)
tickSpacing Int32 Tick spacing for the pool's price range granularity
currentLiquidity UInt128 Current active liquidity in the pool
currentSqrtPriceX96 UInt256 Current square root price in Q64.96 fixed-point format
currentTick Int32 Current price tick index
currentPoolPrice Float64 Current pool price as a floating point number
poolTvlUSD Float64 Total Value Locked in USD
swapVolumeUSD Map(String, Float64) Swap volume in USD keyed by time range ('5 minute', '1 hour', '1 day', '1 week', '1 month', '1 year')
feeApr Map(String, Float64) Annualized fee APR (%) keyed by time range
tickUtilization Map(String, Float64) Percentage of time price was in the active tick range, keyed by time range
swapCount Map(String, UInt64) Number of swaps keyed by time range
uniqueUserCount Map(String, UInt64) Number of unique users/traders keyed by time range

Examples

1. WETH/cbBTC Pool Metrics on PancakeSwap V3

Retrieve comprehensive performance metrics for the WETH/cbBTC pool (0.01% fee tier) on PancakeSwap V3, including TVL, volume, APR, and activity across all time ranges.

curl -X GET "https://opabinia.cambrian.network/api/v1/evm/pancake/v3/pool?pool_address=0xC211e1f853A898Bd1302385CCdE55f33a8C4B3f3" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {"name": "createdAt", "type": "DateTime('UTC')"},
    {"name": "token0Address", "type": "LowCardinality(FixedString(42))"},
    {"name": "token0Symbol", "type": "String"},
    {"name": "token0Decimals", "type": "UInt8"},
    {"name": "token1Address", "type": "LowCardinality(FixedString(42))"},
    {"name": "token1Symbol", "type": "String"},
    {"name": "token1Decimals", "type": "UInt8"},
    {"name": "feeTier", "type": "UInt32"},
    {"name": "tickSpacing", "type": "Int32"},
    {"name": "currentLiquidity", "type": "UInt128"},
    {"name": "currentSqrtPriceX96", "type": "UInt256"},
    {"name": "currentTick", "type": "Int32"},
    {"name": "currentPoolPrice", "type": "Float64"},
    {"name": "poolTvlUSD", "type": "Float64"},
    {"name": "swapVolumeUSD", "type": "Map(String,Float64)"},
    {"name": "feeApr", "type": "Map(String,Float64)"},
    {"name": "tickUtilization", "type": "Map(String,Float64)"},
    {"name": "swapCount", "type": "Map(String,UInt64)"},
    {"name": "uniqueUserCount", "type": "Map(String,UInt64)"}
  ],
  "data": [
    [
      "2024-09-13T06:45:47+00:00",
      "0x4200000000000000000000000000000000000006",
      "WETH",
      18,
      "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
      "cbBTC",
      8,
      100,
      1,
      66586177611016310,
      "129785419381743070306556",
      -266453,
      2.6834446523523316e-12,
      4420626.676417347,
      {
        "'1 day'": 46845471.24657561,
        "'1 hour'": 3314570.997243589,
        "'1 month'": 1117535710.321227,
        "'1 week'": 215651949.91932017,
        "'1 year'": 15144310133.462294,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 38.679124605150975,
        "'1 hour'": 65.68218504120662,
        "'1 month'": 30.336034923272624,
        "'1 week'": 25.367221022366092,
        "'1 year'": 34.258287889932944,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 91.84166666666667,
        "'1 hour'": 100.0,
        "'1 month'": 88.13777777777779,
        "'1 week'": 69.2452380952381,
        "'1 year'": 100.0,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 36159,
        "'1 hour'": 2463,
        "'1 month'": 764785,
        "'1 week'": 166555,
        "'1 year'": 10936380,
        "'5 minute'": 0
      },
      {
        "'1 day'": 36159,
        "'1 hour'": 960,
        "'1 month'": 24749,
        "'1 week'": 9968,
        "'1 year'": 347295,
        "'5 minute'": 0
      }
    ]
  ],
  "rows": 1
}

This response shows the WETH/cbBTC pool on PancakeSwap V3 with a TVL of ~$4.42M. The pool has a 1-hour fee APR of ~65.7% and 100% tick utilization, indicating highly concentrated active trading. Daily swap volume is ~$46.8M with 36,159 swaps from 960 unique users in the past hour.

2. Query a Different PancakeSwap V3 Pool

Use the same endpoint with any valid pool address to retrieve metrics for any PancakeSwap V3 pool. Simply substitute the pool_address parameter with your target pool's contract address.

curl -X GET "https://opabinia.cambrian.network/api/v1/evm/pancake/v3/pool?pool_address=0xC211e1f853A898Bd1302385CCdE55f33a8C4B3f3" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {"name": "createdAt", "type": "DateTime('UTC')"},
    {"name": "token0Address", "type": "LowCardinality(FixedString(42))"},
    {"name": "token0Symbol", "type": "String"},
    {"name": "token0Decimals", "type": "UInt8"},
    {"name": "token1Address", "type": "LowCardinality(FixedString(42))"},
    {"name": "token1Symbol", "type": "String"},
    {"name": "token1Decimals", "type": "UInt8"},
    {"name": "feeTier", "type": "UInt32"},
    {"name": "tickSpacing", "type": "Int32"},
    {"name": "currentLiquidity", "type": "UInt128"},
    {"name": "currentSqrtPriceX96", "type": "UInt256"},
    {"name": "currentTick", "type": "Int32"},
    {"name": "currentPoolPrice", "type": "Float64"},
    {"name": "poolTvlUSD", "type": "Float64"},
    {"name": "swapVolumeUSD", "type": "Map(String,Float64)"},
    {"name": "feeApr", "type": "Map(String,Float64)"},
    {"name": "tickUtilization", "type": "Map(String,Float64)"},
    {"name": "swapCount", "type": "Map(String,UInt64)"},
    {"name": "uniqueUserCount", "type": "Map(String,UInt64)"}
  ],
  "data": [
    [
      "2024-09-13T06:45:47+00:00",
      "0x4200000000000000000000000000000000000006",
      "WETH",
      18,
      "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
      "cbBTC",
      8,
      100,
      1,
      66586177611016310,
      "129785419381743070306556",
      -266453,
      2.6834446523523316e-12,
      4420626.676417347,
      {
        "'1 day'": 46845471.24657561,
        "'1 hour'": 3314570.997243589,
        "'1 month'": 1117535710.321227,
        "'1 week'": 215651949.91932017,
        "'1 year'": 15144310133.462294,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 38.679124605150975,
        "'1 hour'": 65.68218504120662,
        "'1 month'": 30.336034923272624,
        "'1 week'": 25.367221022366092,
        "'1 year'": 34.258287889932944,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 91.84166666666667,
        "'1 hour'": 100.0,
        "'1 month'": 88.13777777777779,
        "'1 week'": 69.2452380952381,
        "'1 year'": 100.0,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 36159,
        "'1 hour'": 2463,
        "'1 month'": 764785,
        "'1 week'": 166555,
        "'1 year'": 10936380,
        "'5 minute'": 0
      },
      {
        "'1 day'": 36159,
        "'1 hour'": 960,
        "'1 month'": 24749,
        "'1 week'": 9968,
        "'1 year'": 347295,
        "'5 minute'": 0
      }
    ]
  ],
  "rows": 1
}

The endpoint returns a single row per pool address containing all time-range metrics aggregated within the swapVolumeUSD, feeApr, tickUtilization, swapCount, and uniqueUserCount map fields. Find pool addresses using the /api/v1/evm/pancake/v3/pools endpoint.

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.network/api/v1/evm/pancake/v3/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.network/api/v1/evm/pancake/v3/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/evm/pancake/v3/pools - Returns a list of all PancakeSwap V3 liquidity pools, including token pairs, fee tiers, and creation timestamps
  • /api/v1/evm/uniswap/v3/pool - Returns equivalent pool metrics (TVL, volume, APR, tick utilization, swap count, unique users) for Uniswap V3 pools
  • /api/v1/evm/aero/v3/pool - Returns equivalent pool metrics for Aerodrome V3 pools
  • /api/v1/evm/sushi/v3/pool - Returns equivalent pool metrics for SushiSwap V3 pools
  • /api/v1/evm/clones/v3/pool - Returns equivalent pool metrics for Uniswap V3 clone pools