Cambrian V3 - Pool Info API

By Cambrian Network pancake

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

PancakeSwap V3 Pool Info

Overview

Returns current pool state and performance metrics for a PancakeSwap V3 liquidity pool on Base, including TVL, swap volume, fee APR, price volatility, tick pressure, swap count, and unique user count 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://api.cambrian.org/evm/pancake/v3/pool

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

Query Parameters

Parameter Type Required Default Description
chain_id integer No 8453 EVM chain ID. Only 8453 (Base) is currently supported.
pool_address string Yes - Pool address with 0x prefix (e.g., 0xC211e1f853A898Bd1302385CCdE55f33a8C4B3f3)

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 Symbol of token0
token0Decimals UInt8 Decimal precision of token0
token1Address String Contract address of token1 in the pool
token1Symbol String Symbol of token1
token1Decimals UInt8 Decimal precision of token1
feeTier UInt32 Pool fee tier in hundredths of a basis point (e.g., 100 = 0.01%)
tickSpacing Int32 Minimum tick spacing allowed for the pool's fee tier
currentLiquidity Nullable(Int256) Current in-range liquidity of the pool
currentSqrtPriceX96 Nullable(UInt256) Current pool price expressed as sqrt(price) * 2^96
currentTick Nullable(Int32) Current tick of the pool
currentPoolPrice Nullable(Float64) Current pool price of token1 in terms of token0
poolTvlUsd Nullable(Float64) Current total value locked in the pool, in USD
swapVolumeUsd Map(String,Nullable(Float64)) Swap volume in USD, keyed by time range (5 minute, 1 hour, 1 day, 1 week, 1 month, 1 year)
feeApr Map(String,Nullable(Float64)) Annualized fee APR, keyed by time range
priceVolatilityPct Map(String,Float64) Price volatility percentage, keyed by time range
priceVolatilityAdjustedPct Map(String,Float64) Mean-adjusted price volatility percentage, keyed by time range
tickPressurePer1MUsd Map(String,Nullable(Float64)) Tick movement pressure per $1M of swap volume, keyed by time range
swapCount Map(String,UInt64) Number of swaps, keyed by time range
uniqueUserCount Map(String,UInt64) Number of unique users who swapped, keyed by time range

Examples

1. WETH/cbBTC Pool Info

Fetch current metrics for the WETH/cbBTC pool on Base, a high-volume, low-fee-tier pool.

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

Response:

[
  {
    "columns": [
      { "name": "createdAt", "type": "DateTime('UTC')" },
      { "name": "token0Address", "type": "String" },
      { "name": "token0Symbol", "type": "String" },
      { "name": "token0Decimals", "type": "UInt8" },
      { "name": "token1Address", "type": "String" },
      { "name": "token1Symbol", "type": "String" },
      { "name": "token1Decimals", "type": "UInt8" },
      { "name": "feeTier", "type": "UInt32" },
      { "name": "tickSpacing", "type": "Int32" },
      { "name": "currentLiquidity", "type": "Nullable(Int256)" },
      { "name": "currentSqrtPriceX96", "type": "Nullable(UInt256)" },
      { "name": "currentTick", "type": "Nullable(Int32)" },
      { "name": "currentPoolPrice", "type": "Nullable(Float64)" },
      { "name": "poolTvlUsd", "type": "Nullable(Float64)" },
      { "name": "swapVolumeUsd", "type": "Map(String,Nullable(Float64))" },
      { "name": "feeApr", "type": "Map(String,Nullable(Float64))" },
      { "name": "priceVolatilityPct", "type": "Map(String,Float64)" },
      { "name": "priceVolatilityAdjustedPct", "type": "Map(String,Float64)" },
      { "name": "tickPressurePer1MUsd", "type": "Map(String,Nullable(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,
        "183379827491988582",
        "135353135126901401813605",
        -265613,
        0.02918619445882321,
        5570127.537101628,
        {
          "1 day": 45386421.69582063,
          "1 hour": 1046296.7716726399,
          "1 month": 1167595215.148688,
          "1 week": 298708324.39242345,
          "1 year": 16634739479.090212,
          "5 minute": 27645.496733862878
        },
        {
          "1 day": 0.2974087004046328,
          "1 hour": 0.1645484714452616,
          "1 month": 0.25154078588790885,
          "1 week": 0.2788595550989557,
          "1 year": 0.29864198563298905,
          "5 minute": 0.05217285595898275
        },
        {
          "1 day": 0.006165682666121917,
          "1 hour": 0.000828430427998967,
          "1 month": 0.047890380137098024,
          "1 week": 0.018637632675020162,
          "1 year": 0.32084449215406996,
          "5 minute": 0.00010840403858738094
        },
        {
          "1 day": 0.00004879570381228392,
          "1 hour": 0.00004239785360524167,
          "1 month": 0.000058885738322169586,
          "1 week": 0.00005356623642117787,
          "1 year": 0.0000986476371848453,
          "5 minute": 0.00002050277335630321
        },
        {
          "1 day": 108.5126303414555,
          "1 hour": 96.53092959327257,
          "1 month": 190.95487640518232,
          "1 week": 132.82857141897043,
          "1 year": 280.37331187918795,
          "5 minute": 108.51676961641675
        },
        {
          "1 day": 15966,
          "1 hour": 381,
          "1 month": 661418,
          "1 week": 121057,
          "1 year": 10578298,
          "5 minute": 10
        },
        {
          "1 day": 99,
          "1 hour": 33,
          "5 minute": 6
        }
      ]
    ],
    "rows": 1
  }
]

This pool shows strong sustained activity: ~$45.4M in 1-day swap volume, a 1-day fee APR of ~29.7%, and 99 unique users trading over the past day, reflecting a deep, actively-traded WETH/cbBTC market. Note that some time-range keys (e.g. "1 month", "1 week", "1 year") are absent from uniqueUserCount in this response, indicating no data was available for that range.

2. QUID/USDC Pool Info

Fetch current metrics for a lower-volume, wider fee-tier pool (QUID/USDC) to illustrate a pool with minimal recent activity.

curl -X GET "https://api.cambrian.org/evm/pancake/v3/pool?pool_address=0xac84c1ddb3af32261dce60d040b0ff9c812d2cb3&chain_id=8453" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "columns": [
      { "name": "createdAt", "type": "DateTime('UTC')" },
      { "name": "token0Address", "type": "String" },
      { "name": "token0Symbol", "type": "String" },
      { "name": "token0Decimals", "type": "UInt8" },
      { "name": "token1Address", "type": "String" },
      { "name": "token1Symbol", "type": "String" },
      { "name": "token1Decimals", "type": "UInt8" },
      { "name": "feeTier", "type": "UInt32" },
      { "name": "tickSpacing", "type": "Int32" },
      { "name": "currentLiquidity", "type": "Nullable(Int256)" },
      { "name": "currentSqrtPriceX96", "type": "Nullable(UInt256)" },
      { "name": "currentTick", "type": "Nullable(Int32)" },
      { "name": "currentPoolPrice", "type": "Nullable(Float64)" },
      { "name": "poolTvlUsd", "type": "Nullable(Float64)" },
      { "name": "swapVolumeUsd", "type": "Map(String,Nullable(Float64))" },
      { "name": "feeApr", "type": "Map(String,Nullable(Float64))" },
      { "name": "priceVolatilityPct", "type": "Map(String,Float64)" },
      { "name": "priceVolatilityAdjustedPct", "type": "Map(String,Float64)" },
      { "name": "tickPressurePer1MUsd", "type": "Map(String,Nullable(Float64))" },
      { "name": "swapCount", "type": "Map(String,UInt64)" },
      { "name": "uniqueUserCount", "type": "Map(String,UInt64)" }
    ],
    "data": [
      [
        "2026-08-04T12:59:03+00:00",
        "0x1a44233fae8d50f1aeb3a5d58dd426ff4814cb53",
        "QUID",
        18,
        "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "USDC",
        6,
        2500,
        50,
        "341700416721311060",
        "29120682046261131917882",
        -296343,
        0.13509644396215864,
        32.90854723892649,
        {
          "1 day": 40810.47115018515,
          "1 hour": 0,
          "1 month": 40810.47115018515,
          "1 week": 40810.47115018515,
          "1 year": 40810.47115018515,
          "5 minute": 0
        },
        {
          "1 day": 1,
          "1 hour": 0,
          "1 month": 1,
          "1 week": 1,
          "1 year": 1,
          "5 minute": 0
        },
        {
          "1 day": 0.059949635246689253,
          "1 hour": 0,
          "1 month": 0.059949635246689253,
          "1 week": 0.059949635246689253,
          "1 year": 0.059949635246689253,
          "5 minute": 0
        },
        {
          "1 day": 0.0035954549356848144,
          "1 hour": 0,
          "1 month": 0.0035954549356848144,
          "1 week": 0.0035954549356848144,
          "1 year": 0.0035954549356848144,
          "5 minute": 0
        },
        {
          "1 day": 3215.351264069018,
          "1 hour": 0,
          "1 month": 3215.351264069018,
          "1 week": 3215.351264069018,
          "1 year": 3215.351264069018,
          "5 minute": 0
        },
        {
          "1 day": 278,
          "1 hour": 0,
          "1 month": 278,
          "1 week": 278,
          "1 year": 278,
          "5 minute": 0
        },
        {
          "1 day": 27,
          "1 hour": 0,
          "5 minute": 0
        }
      ]
    ],
    "rows": 1
  }
]

This pool was created on the same day as the query, so all longer time-range windows (1 week, 1 month, 1 year) show identical values equal to the 1-day figures, and the 1-hour/5-minute windows show zero activity, reflecting a newly-created pool with limited trading history. TVL is only ~$33, indicating this pool has negligible liquidity.

Note: Each result collection in the example responses above is limited to its first 10 items for documentation purposes.

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/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.org/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

  • /evm/pancake/v3/pools - Returns a list of all liquidity pools, including token pairs, fee tiers, and creation timestamps.
  • /evm/uniswap/v3/pool - Returns current pool TVL, swap volume, fee APR, price volatility, tick pressure, swap count, and unique users for a Uniswap V3 pool.
  • /evm/sushi/v3/pool - Returns current pool TVL, swap volume, fee APR, price volatility, tick pressure, swap count, and unique users for a Sushi V3 pool.
  • /evm/aero/v3/pool - Returns current pool TVL, swap volume, price volatility, tick pressure, swap count, and unique users for an Aerodrome V3 pool.
  • /evm/alien/v3/pool - Returns current pool TVL, swap volume, fee APR, price volatility, tick pressure, swap count, and unique users for an Alien V3 pool.