EVM Clones V3 Pool Information

Retrieves detailed information about a specific EVM V3 pool, including token information, liquidity metrics, price data, and historical performance statistics.

Business Value

• Pool Analytics: Access comprehensive liquidity pool data for DeFi analysis and monitoring
• Trading Intelligence: Get real-time price, liquidity, and trading volume metrics for informed decision making
• Performance Tracking: Monitor fee APRs, tick utilization, and swap activity across different time periods
• Token Information: Retrieve detailed token pair data including addresses, symbols, and decimals
• Risk Assessment: Analyze pool TVL, liquidity distribution, and trading patterns for risk management

Endpoint Details

URL:

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

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

Query Parameters

Response Field Descriptions

Examples

1. WBTC/cbBTC Pool Information

Gets current pool information for the WBTC/cbBTC trading pair on 9mm DEX.

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

Response:

{
  "columns": [
    {
      "name": "createdAt",
      "type": "DateTime('UTC')"
    },
    {
      "name": "dexName",
      "type": "String"
    },
    {
      "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": [
    [
      "2025-05-19T12:40:57+00:00",
      "9mm",
      "0x0555e30da8f98308edb960aa94c0db47230d2b9c",
      "WBTC",
      8,
      "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
      "cbBTC",
      8,
      500,
      10,
      1450597,
      "79131732056626544985620801809",
      -25,
      0.9975672344102923,
      16.365303353687764,
      {
        "'1 day'": 0.0,
        "'1 hour'": 0.0,
        "'1 month'": 10.406261047339086,
        "'1 week'": 0.0,
        "'1 year'": 81202.79440403447,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 0.0,
        "'1 hour'": 0.0,
        "'1 month'": 0.38152403859941164,
        "'1 week'": 0.0,
        "'1 year'": 100.0,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 0.0,
        "'1 hour'": 0.0,
        "'1 month'": 0.030555555555555555,
        "'1 week'": 0.0,
        "'1 year'": 81.06187214611872,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 0,
        "'1 hour'": 0,
        "'1 month'": 13,
        "'1 week'": 0,
        "'1 year'": 1296,
        "'5 minute'": 0
      },
      {
        "'1 day'": 0,
        "'1 hour'": 0,
        "'1 month'": 11,
        "'1 week'": 0,
        "'1 year'": 363,
        "'5 minute'": 0
      }
    ],
    [
      "2025-05-19T12:40:57+00:00",
      "9mm",
      "0x0555e30da8f98308edb960aa94c0db47230d2b9c",
      "WBTC",
      8,
      "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
      "cbBTC",
      8,
      500,
      10,
      0,
      "0",
      0,
      0.0,
      16.365303353687764,
      {
        "'1 day'": 0.0,
        "'1 hour'": 0.0,
        "'1 month'": 0.0,
        "'1 week'": 0.0,
        "'1 year'": 0.0,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 0.0,
        "'1 hour'": 0.0,
        "'1 month'": 0.0,
        "'1 week'": 0.0,
        "'1 year'": 0.0,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 0.0,
        "'1 hour'": 0.0,
        "'1 month'": 0.0,
        "'1 week'": 0.0,
        "'1 year'": 0.0,
        "'5 minute'": 0.0
      },
      {
        "'1 day'": 0,
        "'1 hour'": 0,
        "'1 month'": 0,
        "'1 week'": 0,
        "'1 year'": 0,
        "'5 minute'": 0
      },
      {
        "'1 day'": 0,
        "'1 hour'": 0,
        "'1 month'": 0,
        "'1 week'": 0,
        "'1 year'": 0,
        "'5 minute'": 0
      }
    ]
  ],
  "rows": 2
}

This response shows detailed metrics for a WBTC/cbBTC pool including current liquidity of 1,450,597, a TVL of $16.37, and various performance metrics across different time periods. The data includes two entries showing different states of the same pool.

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/evm/clones/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://deep42.cambrian.network/api/v1/evm/clones/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