Aerodrome V2 Pool Information

This endpoint retrieves comprehensive information about a specific Aerodrome V2 pool, including token details, reserves, TVL, and APR calculations. It provides real-time pool data essential for liquidity providers and traders analyzing pool performance on the Aerodrome DEX.

Business Value

• Pool Analytics: Access detailed metrics including TVL, reserves, and APR to analyze pool performance and profitability
• Risk Assessment: Evaluate pool composition with token balances, prices, and reserve ratios for informed investment decisions
• Yield Optimization: Compare APR breakdowns (swap fees, rewards, bribes) to identify highest-yielding liquidity opportunities
• Portfolio Management: Monitor pool positions with real-time pricing and reserve data for active liquidity management
• Trading Intelligence: Understand pool depth and composition to optimize trade execution and slippage management

Endpoint Details

URL:

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

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

Query Parameters

Response Field Descriptions

Examples

1. Get USDC/AERO Pool Information

This example retrieves comprehensive pool data for the USDC/AERO pool with a 7-day APR calculation window.

curl -X GET "https://opabinia.cambrian.network/api/v1/evm/aero/v2/pool?pool_address=0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d&apr_days_annualized=7" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {
      "name": "poolAddress",
      "type": "String"
    },
    {
      "name": "token0Address",
      "type": "FixedString(42)"
    },
    {
      "name": "token0Symbol",
      "type": "FixedString(50)"
    },
    {
      "name": "token0Name",
      "type": "String"
    },
    {
      "name": "token0Decimals",
      "type": "UInt8"
    },
    {
      "name": "token1Address",
      "type": "FixedString(42)"
    },
    {
      "name": "token1Symbol",
      "type": "FixedString(50)"
    },
    {
      "name": "token1Name",
      "type": "String"
    },
    {
      "name": "token1Decimals",
      "type": "UInt8"
    },
    {
      "name": "reserve0",
      "type": "UInt256"
    },
    {
      "name": "reserve1",
      "type": "UInt256"
    },
    {
      "name": "tvlToken0",
      "type": "Float64"
    },
    {
      "name": "tvlToken1",
      "type": "Float64"
    },
    {
      "name": "token0PriceUSD",
      "type": "Float64"
    },
    {
      "name": "token1PriceUSD",
      "type": "Float64"
    },
    {
      "name": "tvlUSD",
      "type": "Float64"
    },
    {
      "name": "feesXdUSD",
      "type": "Float64"
    },
    {
      "name": "aeroRewardsXdUSD",
      "type": "Float64"
    },
    {
      "name": "bribesXdUSD",
      "type": "Float64"
    },
    {
      "name": "swapFeeAPR",
      "type": "Float64"
    },
    {
      "name": "aeroRewardAPR",
      "type": "Float64"
    },
    {
      "name": "bribeFeeAPR",
      "type": "Float64"
    },
    {
      "name": "totalAPR",
      "type": "Float64"
    },
    {
      "name": "calculationTimestampAt",
      "type": "UInt32"
    },
    {
      "name": "baseCurrency",
      "type": "String"
    },
    {
      "name": "createdAt",
      "type": "DateTime('UTC')"
    }
  ],
  "data": [
    [
      "0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d",
      "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "USDC",
      "USD Coin",
      6,
      "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
      "AERO",
      "Aerodrome",
      18,
      "16544268286970",
      "34647667581027436398736393",
      16544268.28697,
      34647667.581027,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      1769608808,
      "USD",
      "2023-09-07T22:50:45+00:00"
    ]
  ],
  "rows": 1
}

This response shows a USDC/AERO pool with approximately 16.5M USDC and 34.6M AERO tokens in reserves. The pool was created in September 2023 and currently has zero APR from all sources, indicating either minimal recent trading activity or the pool being in its early stages.

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/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/aero/v2/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/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