Cambrian V3 - List Pools API

By Cambrian Network base

GET /api/v1/evm/uniswap/v3/pools

Uniswap V3 Pools

Returns a comprehensive list of all Uniswap V3 liquidity pools, including token pairs, fee tiers, and creation timestamps. This endpoint provides access to pool data across different EVM chains.

Business Value

  • Pool Discovery: Find available liquidity pools for specific token pairs on Uniswap V3
  • Market Analysis: Analyze liquidity distribution and fee structures across different pools
  • DeFi Integration: Access pool addresses and metadata for smart contract interactions
  • Token Research: Discover new token pairs and their associated liquidity pools
  • Historical Tracking: Monitor pool creation patterns and market evolution over time

Endpoint Details

URL: 

https://opabinia.cambrian.network/api/v1/evm/uniswap/v3/pools

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

Query Parameters

Parameter Type Required Default Description
token_address string No - Pool token address. See tokens for valid addresses. Must match pattern: ^0x[a-fA-F0-9]{40}$
limit integer No 100 Limit the number of results. Range: 1-1000
offset integer No 0 Offset the results, allows you to skip a number of rows before starting to return rows. Range: 0-100000
order_asc array No - List of column names to order by in ascending order divided by comma. Available columns: chainId, dexAddress, dexName, poolAddress, token0Address, token0Symbol, token0Decimals, token1Address, token1Symbol, token1Decimals, createdAt, fee, tickSpacing
order_desc array No - List of column names to order by in descending order divided by comma. Available columns: chainId, dexAddress, dexName, poolAddress, token0Address, token0Symbol, token0Decimals, token1Address, token1Symbol, token1Decimals, createdAt, fee, tickSpacing

Response Field Descriptions

Response Field Type Description
chainId UInt32 The blockchain network identifier (e.g., 8453 for Base)
dexAddress FixedString(42) The address of the Uniswap V3 DEX contract
dexName String The name of the decentralized exchange (UniswapV3)
poolAddress FixedString(42) The unique address of the liquidity pool contract
token0Address FixedString(42) The contract address of the first token in the pair
token0Symbol String The symbol/ticker of the first token
token0Decimals UInt8 The number of decimal places for the first token
token1Address FixedString(42) The contract address of the second token in the pair
token1Symbol String The symbol/ticker of the second token
token1Decimals UInt8 The number of decimal places for the second token
createdAt DateTime('UTC') The timestamp when the pool was created
fee UInt32 The fee tier for the pool (e.g., 300 = 0.03%, 3000 = 0.3%, 10000 = 1.0%)
tickSpacing Int32 The spacing between initializable ticks in the pool

Examples

1. Get All Pools (Default Query)

Retrieves the most recent Uniswap V3 pools with default pagination settings.

curl -X GET "https://opabinia.cambrian.network/api/v1/evm/uniswap/v3/pools" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {
      "name": "chainId",
      "type": "UInt32"
    },
    {
      "name": "dexAddress",
      "type": "LowCardinality(FixedString(42))"
    },
    {
      "name": "dexName",
      "type": "String"
    },
    {
      "name": "poolAddress",
      "type": "FixedString(42)"
    },
    {
      "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": "createdAt",
      "type": "DateTime('UTC')"
    },
    {
      "name": "fee",
      "type": "UInt32"
    },
    {
      "name": "tickSpacing",
      "type": "Int32"
    }
  ],
  "data": [
    [
      8453,
      "0x33128a8fc17869897dce68ed026d694621f6fdfd",
      "UniswapV3",
      "0x9fb68dff35bcc31ff1c1a30c7c0d5f6a3b873bd2",
      "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "USDC",
      6,
      "0xab6363da0c80cef3ae105bd6241e30872355d021",
      "ROLL",
      18,
      "2026-01-28T12:03:49+00:00",
      300,
      6
    ],
    [
      8453,
      "0x33128a8fc17869897dce68ed026d694621f6fdfd",
      "UniswapV3",
      "0x1e3799a69d2604e619799e5a3152561fd6f49cdc",
      "0x121d60c4b32cff9b464cba68cb3c5def8319e0d0",
      "Pow",
      18,
      "0x4200000000000000000000000000000000000006",
      "WETH",
      18,
      "2026-01-28T11:42:47+00:00",
      10000,
      200
    ],
    [
      8453,
      "0x33128a8fc17869897dce68ed026d694621f6fdfd",
      "UniswapV3",
      "0x66038115e71f188496bca81d773ede248b66440f",
      "0x36e7fa3db5be6b23ee03fc5fbb33a32a5356f34b",
      "GoldClawd",
      18,
      "0x4200000000000000000000000000000000000006",
      "WETH",
      18,
      "2026-01-28T11:28:53+00:00",
      10000,
      200
    ],
    [
      8453,
      "0x33128a8fc17869897dce68ed026d694621f6fdfd",
      "UniswapV3",
      "0xdfb75da0fb4b7c377e6b9827c8e6757b7f5ab387",
      "0x4200000000000000000000000000000000000006",
      "WETH",
      18,
      "0xf77b5b6dc79140f4b1a157be63e68b38b52d5b07",
      "Krydbz1ne",
      18,
      "2026-01-28T11:24:23+00:00",
      100,
      1
    ],
    [
      8453,
      "0x33128a8fc17869897dce68ed026d694621f6fdfd",
      "UniswapV3",
      "0x340b596f452f338a21efc060322d83e42c0d38a2",
      "0x4200000000000000000000000000000000000006",
      "WETH",
      18,
      "0xdd9362cc633cd227531007ec7ce21ed0980b96c3",
      "FACESS",
      18,
      "2026-01-28T11:23:17+00:00",
      3000,
      60
    ]
  ],
  "rows": 5
  // ... additional rows omitted for brevity
}

This shows the 5 most recent Uniswap V3 pools on the Base network (chainId 8453), including various token pairs like USDC/ROLL, Pow/WETH, and others with their respective fee tiers and creation timestamps.

2. Filter by Token Address

Finds all pools containing a specific token address (WETH in this example).

curl -X GET "https://opabinia.cambrian.network/api/v1/evm/uniswap/v3/pools?token_address=0x4200000000000000000000000000000000000006&limit=10" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [...],
  "data": [...],
  "rows": 10
}

This would return only pools that contain WETH (Wrapped Ethereum) as either token0 or token1, limited to 10 results.

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/uniswap/v3/pools"
);
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/uniswap/v3/pools")
        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/uniswap/v3/pool - Returns current pool TVL, Swap Volume, Fees APR, Price Tick Utilization, Number of Swaps and Unique users for recent time ranges
  • /api/v1/evm/price-current - Returns current price of a token calculated based on Uniswap V3 and clones liquidity pools
  • /api/v1/evm/aero/v3/pools - Returns a list of all Aerodrome V3 liquidity pools with token pairs, fee tiers, and creation timestamps
  • /api/v1/evm/pancake/v3/pools - Returns a list of all PancakeSwap V3 liquidity pools with token pairs, fee tiers, and creation timestamps
  • /api/v1/evm/alien/v3/pools - Returns a list of all AlienSwap V3 liquidity pools with token pairs, fee tiers, and creation timestamps