Aerodrome V2 Pool Info
Returns detailed information for a specific Aerodrome V2 liquidity pool on Base, including token reserves, TVL, and USD-denominated fees, rewards, bribes, and APR breakdowns. USD prices, valuations, and APRs are null when a required token price is unavailable.
Parameters
Responses
Examples
1. 7-Day Annualized Pool APR
Fetch pool details for the USDC/AERO pool on Base, annualizing APR from the previous 7 completed UTC days.
Response:
2 {
3 "columns": [
4 {
5 "name": "poolAddress",
6 "type": "String"
7 },
8 {
9 "name": "token0Address",
10 "type": "String"
11 },
12 {
13 "name": "token0Symbol",
14 "type": "String"
15 },
16 {
17 "name": "token0Name",
18 "type": "String"
19 },
20 {
21 "name": "token0Decimals",
22 "type": "UInt8"
23 },
24 {
25 "name": "token1Address",
26 "type": "String"
27 },
28 {
29 "name": "token1Symbol",
30 "type": "String"
31 },
32 {
33 "name": "token1Name",
34 "type": "String"
35 },
36 {
37 "name": "token1Decimals",
38 "type": "UInt8"
39 },
40 {
41 "name": "reserve0",
42 "type": "Int256"
43 },
44 {
45 "name": "reserve1",
46 "type": "Int256"
47 },
48 {
49 "name": "tvlToken0",
50 "type": "Float64"
51 },
52 {
53 "name": "tvlToken1",
54 "type": "Float64"
55 },
56 {
57 "name": "token0PriceUsd",
58 "type": "Nullable(Float64)"
59 },
60 {
61 "name": "token1PriceUsd",
62 "type": "Nullable(Float64)"
63 },
64 {
65 "name": "tvlUsd",
66 "type": "Nullable(Float64)"
67 },
68 {
69 "name": "feesXdUsd",
70 "type": "Nullable(Float64)"
71 },
72 {
73 "name": "aeroRewardsXdUsd",
74 "type": "Nullable(Float64)"
75 },
76 {
77 "name": "bribesXdUsd",
78 "type": "Nullable(Float64)"
79 },
80 {
81 "name": "swapFeeAPR",
82 "type": "Nullable(Float64)"
83 },
84 {
85 "name": "aeroRewardAPR",
86 "type": "Nullable(Float64)"
87 },
88 {
89 "name": "bribeFeeAPR",
90 "type": "Nullable(Float64)"
91 },
92 {
93 "name": "totalAPR",
94 "type": "Nullable(Float64)"
95 },
96 {
97 "name": "calculationTimestampAt",
98 "type": "UInt32"
99 },
100 {
101 "name": "baseCurrency",
102 "type": "String"
103 },
104 {
105 "name": "createdAt",
106 "type": "DateTime('UTC')"
107 },
108 {
109 "name": "tvlPriceComplete",
110 "type": "UInt8"
111 },
112 {
113 "name": "unpricedTokenAddresses",
114 "type": "Array(String)"
115 }
116 ],
117 "data": [
118 [
119 "0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d",
120 "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
121 "USDC",
122 "USD Coin",
123 6,
124 "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
125 "AERO",
126 "Aerodrome",
127 18,
128 "12601279199261",
129 "30392701917380872686694266",
130 12601279.199261,
131 30392701.917380873,
132 1,
133 0.41335875,
134 25164368.38,
135 30381.42,
136 95109.51,
137 null,
138 0.063,
139 0.1971,
140 null,
141 null,
142 1785883500,
143 "Usd",
144 "2023-09-07T22:50:45+00:00",
145 1,
146 []
147 ]
148 ],
149 "rows": 1
150 }
151]
2. 30-Day Annualized Pool APR
Fetch the same pool but annualize APR over the previous 30 completed UTC days to smooth out short-term volatility.
Response:
2 {
3 "columns": [
4 {
5 "name": "poolAddress",
6 "type": "String"
7 },
8 {
9 "name": "token0Address",
10 "type": "String"
11 },
12 {
13 "name": "token0Symbol",
14 "type": "String"
15 },
16 {
17 "name": "token0Name",
18 "type": "String"
19 },
20 {
21 "name": "token0Decimals",
22 "type": "UInt8"
23 },
24 {
25 "name": "token1Address",
26 "type": "String"
27 },
28 {
29 "name": "token1Symbol",
30 "type": "String"
31 },
32 {
33 "name": "token1Name",
34 "type": "String"
35 },
36 {
37 "name": "token1Decimals",
38 "type": "UInt8"
39 },
40 {
41 "name": "reserve0",
42 "type": "Int256"
43 },
44 {
45 "name": "reserve1",
46 "type": "Int256"
47 },
48 {
49 "name": "tvlToken0",
50 "type": "Float64"
51 },
52 {
53 "name": "tvlToken1",
54 "type": "Float64"
55 },
56 {
57 "name": "token0PriceUsd",
58 "type": "Nullable(Float64)"
59 },
60 {
61 "name": "token1PriceUsd",
62 "type": "Nullable(Float64)"
63 },
64 {
65 "name": "tvlUsd",
66 "type": "Nullable(Float64)"
67 },
68 {
69 "name": "feesXdUsd",
70 "type": "Nullable(Float64)"
71 },
72 {
73 "name": "aeroRewardsXdUsd",
74 "type": "Nullable(Float64)"
75 },
76 {
77 "name": "bribesXdUsd",
78 "type": "Nullable(Float64)"
79 },
80 {
81 "name": "swapFeeAPR",
82 "type": "Nullable(Float64)"
83 },
84 {
85 "name": "aeroRewardAPR",
86 "type": "Nullable(Float64)"
87 },
88 {
89 "name": "bribeFeeAPR",
90 "type": "Nullable(Float64)"
91 },
92 {
93 "name": "totalAPR",
94 "type": "Nullable(Float64)"
95 },
96 {
97 "name": "calculationTimestampAt",
98 "type": "UInt32"
99 },
100 {
101 "name": "baseCurrency",
102 "type": "String"
103 },
104 {
105 "name": "createdAt",
106 "type": "DateTime('UTC')"
107 },
108 {
109 "name": "tvlPriceComplete",
110 "type": "UInt8"
111 },
112 {
113 "name": "unpricedTokenAddresses",
114 "type": "Array(String)"
115 }
116 ],
117 "data": [
118 [
119 "0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d",
120 "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
121 "USDC",
122 "USD Coin",
123 6,
124 "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
125 "AERO",
126 "Aerodrome",
127 18,
128 "12601279199261",
129 "30392701917380872686694266",
130 12601279.199261,
131 30392701.917380873,
132 1,
133 0.41335875,
134 25164368.38,
135 199216.55,
136 489954.63,
137 null,
138 0.0963,
139 0.2369,
140 null,
141 null,
142 1785883500,
143 "Usd",
144 "2023-09-07T22:50:45+00:00",
145 1,
146 []
147 ]
148 ],
149 "rows": 1
150 }
151]
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/v2/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/v2/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