Cambrian V2 - List Pools API

By Cambrian Network base

GET /api/v1/evm/aero/v2/pools

Aerodrome V2 Pools

This endpoint provides comprehensive data on all Aerodrome V2 liquidity pools on Base chain, including token information, TVL metrics, trading volumes, and yield calculations. The response includes detailed pool analytics with current pricing, fee structures, and APR calculations.

Business Value

  • Pool Discovery: Browse all available Aerodrome V2 pools with complete token pair information and symbols
  • TVL Analysis: Access real-time total value locked data for both tokens in each pool with USD valuations
  • Yield Optimization: Compare APR across pools including swap fees, AERO rewards, and bribe incentives
  • Volume Tracking: Monitor trading activity with 24h and 7-day volume metrics for investment decisions
  • Risk Assessment: Evaluate pool health through TVL, volume, and fee generation metrics

Endpoint Details

URL: 

https://opabinia.cambrian.network/api/v1/evm/aero/v2/pools

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

Query Parameters

Parameter Type Required Default Description
limit integer No 100 Limit the number of results (1-1000)
offset integer No 0 Offset the results, skip number of rows (0-100000)

Response Field Descriptions

Response Field Type Description
poolId FixedString(42) Unique pool contract address identifier
token0 FixedString(42) First token contract address in the pool
token0Symbol FixedString(50) Trading symbol for the first token
token0Decimals UInt8 Decimal places for the first token
token1 FixedString(42) Second token contract address in the pool
token1Symbol FixedString(50) Trading symbol for the second token
token1Decimals UInt8 Decimal places for the second token
tvlToken0 Float64 Total value locked amount for token0
tvlToken1 Float64 Total value locked amount for token1
priceUSDToken0 Float64 USD price per unit of token0
priceUSDToken1 Float64 USD price per unit of token1
poolTvlUSD Float64 Total pool value in USD
volume24hUSD Float64 Trading volume over last 24 hours in USD
volume7dUSD Float64 Trading volume over last 7 days in USD
fees7dUSD Float64 Total fees collected over last 7 days in USD
aeroRewards7dUSD Float64 AERO token rewards distributed over last 7 days in USD
bribes7dUSD Float64 Bribe rewards paid over last 7 days in USD
swapFeeApr7d Float64 Annualized percentage rate from swap fees over 7 days
aeroRewardApr7d Float64 Annualized percentage rate from AERO rewards over 7 days
bribeFeeApr7d Float64 Annualized percentage rate from bribes over 7 days
totalApr7d Float64 Total combined APR from all yield sources over 7 days
createdAt DateTime('UTC') Pool creation timestamp in UTC

Examples

1. Default Pool Listing

Retrieve the top 100 Aerodrome V2 pools ordered by TVL.

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

Response:

[{"columns":[{"name":"poolId","type":"FixedString(42)"},{"name":"token0","type":"FixedString(42)"},{"name":"token0Symbol","type":"FixedString(50)"},{"name":"token0Decimals","type":"UInt8"},{"name":"token1","type":"FixedString(42)"},{"name":"token1Symbol","type":"FixedString(50)"},{"name":"token1Decimals","type":"UInt8"},{"name":"tvlToken0","type":"Float64"},{"name":"tvlToken1","type":"Float64"},{"name":"priceUSDToken0","type":"Float64"},{"name":"priceUSDToken1","type":"Float64"},{"name":"poolTvlUSD","type":"Float64"},{"name":"volume24hUSD","type":"Float64"},{"name":"volume7dUSD","type":"Float64"},{"name":"fees7dUSD","type":"Float64"},{"name":"aeroRewards7dUSD","type":"Float64"},{"name":"bribes7dUSD","type":"Float64"},{"name":"swapFeeApr7d","type":"Float64"},{"name":"aeroRewardApr7d","type":"Float64"},{"name":"bribeFeeApr7d","type":"Float64"},{"name":"totalApr7d","type":"Float64"},{"name":"createdAt","type":"DateTime('UTC')"}],"data":[["0xde4fb30ccc2f1210fce2c8ad66410c586c8d1f9a","0x4200000000000000000000000000000000000006","WETH",18,"0x7ba6f01772924a82d9626c126347a28299e98c98","msETH",18,2386.977371,3158.261473,3091.43271554,3074.84733939,17090351.82,33976.54,527315.86,0.0,24051.47,0.0,0.0,7.34,0.0,7.34,"2024-06-05T21:56:33+00:00"],["0xd9edc75a3a797ec92ca370f19051babebfb2edee","0x4200000000000000000000000000000000000006","WETH",18,"0xc0634090f2fe6c6d75e61be2b949464abb498973","KTA",18,1319.67048,18130195.192776,3091.43271554,0.226105,8179000.22,196328.42,4034548.35,0.0,135.32,0.0,0.0,0.09,0.0,0.09,"2025-03-05T18:32:33+00:00"],["0x01784ef301d79e4b2df3a21ad9a536d4cf09a5ce","0x4200000000000000000000000000000000000006","WETH",18,"0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf","VVV",18,1111.420443,1482594.653994,3091.43271554,2.33944417,6904328.93,927273.06,5558699.15,0.0,34953.85,18136.03,0.0,26.4,13.7,40.1,"2025-01-27T16:44:43+00:00"],["0x7f670f78b17dec44d5ef68a48740b6f8849cc2e6","0x4200000000000000000000000000000000000006","WETH",18,"0x940181a94a35a4569e4529a3cdfb74e38fd98631","AERO",18,657.209933,3704832.771062,3091.43271554,0.55173901,4075821.05,103856.4,1213841.05,12138.41,6070.7,0.06,15.53,7.77,0.0,23.3,"2023-08-28T05:07:43+00:00"],["0x2578365b3dfa7ffe60108e181efb79feddec2319","0x4200000000000000000000000000000000000006","WETH",18,"0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf","cbBTC",8,652.821624,22.324397,3091.43271554,90422.81231414,4036788.9,29074.91,286753.93,0.0,739.28,15.73,0.0,0.95,0.02,0.97,"2024-09-15T06:40:49+00:00"]],"rows":100}]

The response returns the top pools by TVL, with the WETH/msETH pool having the highest TVL at $17.09M and offering a 7.34% total APR from AERO rewards.

2. Limited Results with Offset

Retrieve 10 pools starting from the 5th position to paginate through results.

curl -X GET "https://opabinia.cambrian.network/api/v1/evm/aero/v2/pools?limit=10&offset=5" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[{"columns":[{"name":"poolId","type":"FixedString(42)"},{"name":"token0","type":"FixedString(42)"},{"name":"token0Symbol","type":"FixedString(50)"},{"name":"token0Decimals","type":"UInt8"},{"name":"token1","type":"FixedString(42)"},{"name":"token1Symbol","type":"FixedString(50)"},{"name":"token1Decimals","type":"UInt8"},{"name":"tvlToken0","type":"Float64"},{"name":"tvlToken1","type":"Float64"},{"name":"priceUSDToken0","type":"Float64"},{"name":"priceUSDToken1","type":"Float64"},{"name":"poolTvlUSD","type":"Float64"},{"name":"volume24hUSD","type":"Float64"},{"name":"volume7dUSD","type":"Float64"},{"name":"fees7dUSD","type":"Float64"},{"name":"aeroRewards7dUSD","type":"Float64"},{"name":"bribes7dUSD","type":"Float64"},{"name":"swapFeeApr7d","type":"Float64"},{"name":"aeroRewardApr7d","type":"Float64"},{"name":"bribeFeeApr7d","type":"Float64"},{"name":"totalApr7d","type":"Float64"},{"name":"createdAt","type":"DateTime('UTC')"}],"data":[["0x21594b992f68495dd28d605834b58889d0a727c7","0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b","VIRTUAL",18,"0x4200000000000000000000000000000000000006","WETH",18,1806821.435709,614.951712,1.05089842,3091.43271554,3799867.64,556710.32,3876445.37,38764.45,8509.15,0.15,53.19,11.68,0.0,64.87,"2024-03-31T15:39:19+00:00"],["0x89d0f320ac73dd7d9513ffc5bc58d1161452a657","0x4200000000000000000000000000000000000006","WETH",18,"0xa88594d404727625a9437c3f886c7643872296ae","WELL",18,599.445924,232352961.927186,3091.43271554,0.00799074,3709818.83,9086.56,314317.15,3143.17,1988.08,0.0,4.42,2.79,0.0,7.21,"2024-03-26T01:57:57+00:00"],["0x594b83709464a83f37ac77e69ddd447a8a33c0ee","0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf","cbBTC",8,"0xed6e000def95780fb89734c07ee2ce9f6dcaf110","EDGE",18,17.602676,11953906.041934,90422.81231414,0.13301789,3181766.85,84147.09,3728040.95,26096.29,211.06,0.0,42.77,0.35,0.0,43.12,"2025-04-02T13:00:43+00:00"],["0x5447f7fe76894d98753a0a6d69b9cb840037c13d","0x4200000000000000000000000000000000000006","WETH",18,"0xb33ff54b9f7242ef1593d2c9bcd8f9df46c77935","FAI",18,450.041897,563582304.438123,3091.43271554,0.00248174,2789939.62,19985.87,223066.32,2230.66,5.4,0.0,4.17,0.01,0.0,4.18,"2024-11-23T09:02:39+00:00"],["0x91f0f34916ca4e2cce120116774b0e4fa0cdcaa8","0x04c0599ae5a44757c0af6f9ec3b93da8976c150a","weETH.base",18,"0x4200000000000000000000000000000000000006","WETH",18,351.659391,381.511292,3355.22918057,3091.43271554,2359314.34,275.11,1437.71,0.72,781.41,0.0,0.0,1.73,0.0,1.73,"2024-04-25T03:56:03+00:00"]],"rows":100}]

This paginated response shows pools 6-10, including the high-yield VIRTUAL/WETH pool offering 64.87% total APR and the cbBTC/EDGE pool with 43.12% APR from swap fees and rewards.

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/aero/v2/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/aero/v2/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/aero/v2/pool - Get information for a specific Aerodrome V2 pool address
  • /api/v1/evm/aero/v2/fee-metrics - Shows daily historical data to understand the fees over time on a pool
  • /api/v1/evm/aero/v2/pool-volume - Helpful for aggregate statistics over a particular timeframe, with hourly data to understand distribution of recent activity
  • /api/v1/evm/aero/v2/provider-summary - Provides a comprehensive overview of a liquidity provider's activity on a specific DEX and chain
  • /api/v1/evm/aero/v3/pool - Returns current pool TVL, Swap Volume, Fees APR, Price Tick Utilization, Number of Swaps and Unique users for Aerodrome V3 pools