Aerodrome V3 Pool Info
Returns current pool TVL (Total Value Locked), swap volume, price volatility and mean adjusted volatility (percentage), tick pressure per 1M$ volume, number of swaps, and unique users for a specific Aerodrome V3 (concentrated liquidity) pool on Base. Metrics are broken down across multiple recent time ranges (5 minutes, 1 hour, 1 day, 1 week, 1 month, and 1 year).
Parameters
Responses
Examples
1. Get V3 Pool Info for WETH/cbBTC
Fetch current pool metrics for the WETH/cbBTC Aerodrome V3 pool on Base.
Response:
2 {
3 "columns": [
4 {
5 "name": "createdAt",
6 "type": "DateTime('UTC')"
7 },
8 {
9 "name": "token0Address",
10 "type": "String"
11 },
12 {
13 "name": "token0Symbol",
14 "type": "String"
15 },
16 {
17 "name": "token0Decimals",
18 "type": "UInt8"
19 },
20 {
21 "name": "token1Address",
22 "type": "String"
23 },
24 {
25 "name": "token1Symbol",
26 "type": "String"
27 },
28 {
29 "name": "token1Decimals",
30 "type": "UInt8"
31 },
32 {
33 "name": "tickSpacing",
34 "type": "Int32"
35 },
36 {
37 "name": "currentLiquidity",
38 "type": "Nullable(Int256)"
39 },
40 {
41 "name": "currentSqrtPriceX96",
42 "type": "Nullable(UInt256)"
43 },
44 {
45 "name": "currentTick",
46 "type": "Nullable(Int32)"
47 },
48 {
49 "name": "currentPoolPrice",
50 "type": "Nullable(Float64)"
51 },
52 {
53 "name": "poolTvlUsd",
54 "type": "Nullable(Float64)"
55 },
56 {
57 "name": "swapVolumeUsd",
58 "type": "Map(String,Nullable(Float64))"
59 },
60 {
61 "name": "priceVolatilityPct",
62 "type": "Map(String,Float64)"
63 },
64 {
65 "name": "priceVolatilityAdjustedPct",
66 "type": "Map(String,Float64)"
67 },
68 {
69 "name": "tickPressurePer1MUsd",
70 "type": "Map(String,Nullable(Float64))"
71 },
72 {
73 "name": "swapCount",
74 "type": "Map(String,UInt64)"
75 },
76 {
77 "name": "uniqueUserCount",
78 "type": "Map(String,UInt64)"
79 }
80 ],
81 "data": [
82 [
83 "2025-02-13T22:12:07+00:00",
84 "0x4200000000000000000000000000000000000006",
85 "WETH",
86 18,
87 "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
88 "cbBTC",
89 8,
90 10,
91 "56389843308",
92 "135531666605172087391945",
93 -265587,
94 0.02926323871608235,
95 34.851306584948645,
96 {
97 "1 day": 0.0750185699423578,
98 "1 hour": 0,
99 "1 month": 783.647302016295,
100 "1 week": 378.18435935401294,
101 "1 year": 4766.040834024103,
102 "5 minute": 0
103 },
104 {
105 "1 day": 0,
106 "1 hour": 0,
107 "1 month": 0.031000322701857774,
108 "1 week": 0.01371590088020538,
109 "1 year": 1,
110 "5 minute": 0
111 },
112 {
113 "1 day": 0,
114 "1 hour": 0,
115 "1 month": 0.0015618088088647807,
116 "1 week": 0.0009954027098261833,
117 "1 year": 1,
118 "5 minute": 0
119 },
120 {
121 "1 day": 0,
122 "1 hour": 0,
123 "1 month": 451223.3999787921,
124 "1 week": 303026.8099816486,
125 "1 year": 90068993.31106928,
126 "5 minute": 0
127 },
128 {
129 "1 day": 1,
130 "1 hour": 0,
131 "1 month": 392,
132 "1 week": 186,
133 "1 year": 1161,
134 "5 minute": 0
135 },
136 {
137 "1 day": 1,
138 "1 hour": 0,
139 "5 minute": 0
140 }
141 ]
142 ],
143 "rows": 1
144 }
145]
2. Get V3 Pool Info for WETH/USDC
Fetch current pool metrics for the higher-volume WETH/USDC Aerodrome V3 pool on Base.
Response:
2 {
3 "columns": [
4 {
5 "name": "createdAt",
6 "type": "DateTime('UTC')"
7 },
8 {
9 "name": "token0Address",
10 "type": "String"
11 },
12 {
13 "name": "token0Symbol",
14 "type": "String"
15 },
16 {
17 "name": "token0Decimals",
18 "type": "UInt8"
19 },
20 {
21 "name": "token1Address",
22 "type": "String"
23 },
24 {
25 "name": "token1Symbol",
26 "type": "String"
27 },
28 {
29 "name": "token1Decimals",
30 "type": "UInt8"
31 },
32 {
33 "name": "tickSpacing",
34 "type": "Int32"
35 },
36 {
37 "name": "currentLiquidity",
38 "type": "Nullable(Int256)"
39 },
40 {
41 "name": "currentSqrtPriceX96",
42 "type": "Nullable(UInt256)"
43 },
44 {
45 "name": "currentTick",
46 "type": "Nullable(Int32)"
47 },
48 {
49 "name": "currentPoolPrice",
50 "type": "Nullable(Float64)"
51 },
52 {
53 "name": "poolTvlUsd",
54 "type": "Nullable(Float64)"
55 },
56 {
57 "name": "swapVolumeUsd",
58 "type": "Map(String,Nullable(Float64))"
59 },
60 {
61 "name": "priceVolatilityPct",
62 "type": "Map(String,Float64)"
63 },
64 {
65 "name": "priceVolatilityAdjustedPct",
66 "type": "Map(String,Float64)"
67 },
68 {
69 "name": "tickPressurePer1MUsd",
70 "type": "Map(String,Nullable(Float64))"
71 },
72 {
73 "name": "swapCount",
74 "type": "Map(String,UInt64)"
75 },
76 {
77 "name": "uniqueUserCount",
78 "type": "Map(String,UInt64)"
79 }
80 ],
81 "data": [
82 [
83 "2024-05-01T18:45:31+00:00",
84 "0x4200000000000000000000000000000000000006",
85 "WETH",
86 18,
87 "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
88 "USDC",
89 6,
90 100,
91 "4882948427719440609",
92 "3429336856146121144326862",
93 -200965,
94 1873.5320484968538,
95 6401648.766035728,
96 {
97 "1 day": 44754468.83826165,
98 "1 hour": 1120992.9963265602,
99 "1 month": 1355451478.3275385,
100 "1 week": 261042365.47260854,
101 "1 year": 46294130909.72368,
102 "5 minute": 23130.240714292144
103 },
104 {
105 "1 day": 0.008755330134790818,
106 "1 hour": 0.0012113898660744346,
107 "1 month": 0.07192239934185146,
108 "1 week": 0.02448668823680449,
109 "1 year": 0.9723014890417713,
110 "5 minute": 0.00006973043789367841
111 },
112 {
113 "1 day": 0.00007000469320576046,
114 "1 hour": 0.00006373599467932553,
115 "1 month": 0.00009258266288696674,
116 "1 week": 0.0000757055066943909,
117 "1 year": 0.0002791508568309004,
118 "5 minute": 0.000018652947436337457
119 },
120 {
121 "1 day": 1.3931569655161569,
122 "1 hour": 1.2667340515536416,
123 "1 month": 2.1560343890774196,
124 "1 week": 1.717920381192134,
125 "1 year": 1.2289970430798092,
126 "5 minute": 1.2970033632837656
127 },
128 {
129 "1 day": 15641,
130 "1 hour": 361,
131 "1 month": 603488,
132 "1 week": 104617,
133 "1 year": 12131764,
134 "5 minute": 11
135 },
136 {
137 "1 day": 119,
138 "1 hour": 33,
139 "5 minute": 6
140 }
141 ]
142 ],
143 "rows": 1
144 }
145]
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.
Quickstart (Typescript)
2import { ExactEvmScheme } from "@x402/evm/exact/client";
3import { wrapFetchWithPayment } from "@x402/fetch";
4import { privateKeyToAccount } from "viem/accounts";
5const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
6const client = new x402Client();
7client.register("eip155:*", new ExactEvmScheme(signer));
8const fetchWithPayment = wrapFetchWithPayment(fetch, client);
9const response = await fetchWithPayment(
10 "https://x402.cambrian.org/evm/aero/v3/pool"
11);
12const data = await response.json();
Quickstart (Python)
2from eth_account import Account
3from x402 import x402Client
4from x402.http.clients import x402HttpxClient
5from x402.mechanisms.evm import EthAccountSigner
6from x402.mechanisms.evm.exact.register import register_exact_evm_client
7async def main():
8 client = x402Client()
9 account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
10 register_exact_evm_client(client, EthAccountSigner(account))
11 async with x402HttpxClient(client) as http:
12 response = await http.get("https://x402.cambrian.org/evm/aero/v3/pool")
13 print(response.json())
14asyncio.run(main())
Payment Flow
- Send a normal request to the endpoint (no API key needed)
- Server returns 402 Payment Required with payment details
- The x402 SDK automatically signs a payment authorization with your wallet
- The SDK resubmits the request with the signed payment
- Server verifies payment and returns the API response
The x402 SDK handles steps 2 through 5 automatically.
Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request