Aave V3 Pool Windows
Returns windowed historical metrics for Aave V3 lending pools, including TVL, deposit/withdrawal flows, borrow volume, and supply/borrow APYs aggregated over a selected timeframe. Results can be filtered by chain, pool, or underlying token, and sorted by any returned metric.
GET
https://api.cambrian.org/evm/lending/aave/v3/pools/windows
Parameters
timeframe* (string)
Timeframe for historical data results
pool_address (string)
Aave V3 pool address
underlying_address (string)
Underlying token address. See tokens for valid addresses.
chain_id (integer)
EVM chain ID.
min_tvl_usd (number)
Minimum TVL Usd of the lending pool/vault, not the window average.
limit (integer)
Limit the number of results.
offset (integer)
Offset the results, allows you to skip a number of rows before starting to return rows.
order_asc (array)
List of column names to order by in ascending order divided by comma. Leave empty items to combine with descending order
order_desc (array)
List of column names to order by in descending order divided by comma. Leave empty items to combine with ascending order
Responses
Code
Description
200
Successful response
Media type: application/vnd.cambrian.table.v1.0.0+json
[
{
"columns": [
{
"name": "chainId",
"type": "UInt16"
},
{
"name": "protocolId",
"type": "String"
},
{
"name": "poolAddress",
"type": "FixedString(42)"
},
{
"name": "symbol",
"type": "Nullable(String)"
},
{
"name": "name",
"type": "Nullable(String)"
},
{
"name": "underlyingAddress",
"type": "FixedString(42)"
},
{
"name": "underlyingSymbol",
"type": "String"
},
{
"name": "tvlUsd",
"type": "Float64"
},
{
"name": "tvlUsdChange",
"type": "Float64"
},
{
"name": "depositsUsd",
"type": "Float64"
},
{
"name": "withdrawalsUsd",
"type": "Float64"
},
{
"name": "netFlowUsd",
"type": "Float64"
},
{
"name": "borrowsUsd",
"type": "Float64"
},
{
"name": "availableLiquidityChangeUsd",
"type": "Float64"
},
{
"name": "supplyApy",
"type": "Float64"
},
{
"name": "supplyBaseApy",
"type": "Float64"
},
{
"name": "supplyExtraRewardsApy",
"type": "Float64"
},
{
"name": "borrowApy",
"type": "Float64"
},
{
"name": "utilizationRate",
"type": "Float64"
},
{
"name": "updatedAt",
"type": "DateTime('UTC')"
}
],
"data": [
[
8453,
"aave-v3",
"0xbdb9300b7cde636d9cd4aff00f6f009ffbbc8ee6",
"aBascbBTC",
"Aave Base cbBTC",
"0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
"cbBTC",
213476881.53122863,
-21619684.104109317,
47586726.64825358,
37614546.80154517,
9972179.84670841,
8904430.75428932,
-20896666.351077467,
0.00008907155148303311,
0.00008907155148303311,
0,
0.006393065268894976,
0.02786225380350281,
"2026-11-18T12:42:26+00:00"
],
[
8453,
"aave-v3",
"0x4e65fe4dba92790696d040ac24aa414708f5c0ab",
"aBasUSDC",
"Aave Base USDC",
"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"USDC",
185695790.85841143,
-10898629.706488997,
55149976.43711399,
65239849.964101985,
-10089873.526987992,
15332978.802599998,
-3580709.29081586,
0.05325724173657701,
0.05325724173657701,
0,
0.06446942582700732,
0.9169773925651605,
"2026-11-18T12:42:28+00:00"
],
[
8453,
"aave-v3",
"0xd4a0e0b9149bcee3c920d2e00b5de09138fd8bb7",
"aBasWETH",
"Aave Base WETH",
"0x4200000000000000000000000000000000000006",
"WETH",
175966888.6325674,
-31880041.497113824,
38488219.26538195,
45643758.94093926,
-7155539.675557315,
22013495.14579357,
-10627016.326680735,
0.013475810342660644,
0.013475810342660644,
0,
0.019907755441077462,
0.7963120251632152,
"2026-11-18T12:42:26+00:00"
],
[
8453,
"aave-v3",
"0xcf3d55c10db69f28fd1a75bd73f3d8a2d9c595ad",
"aBascbETH",
"Aave Base cbETH",
"0x2ae3f1ec7f1f5012cfeab0185bfc7aa3cf0dec22",
"cbETH",
118174091.727348,
-16055825.172092319,
8168696.285737191,
7270184.199330297,
898512.086406894,
0,
-16046709.146110713,
3.733986244700054e-8,
3.733986244700054e-8,
0,
0.00008266425899274607,
0.0005314129018432831,
"2026-11-18T11:48:58+00:00"
],
[
8453,
"aave-v3",
"0x80a94c36747cf51b2fbabdff045f6d22c1930ed1",
"aBaswrsETH",
"Aave Base wrsETH",
"0xedfa23602d0ec14714057867a78d01e94176bea0",
"wrsETH",
21897126.601792715,
-3412506.8908815123,
0,
0,
0,
0,
-3412506.8908815123,
0,
0,
0,
0.01,
0,
"2026-11-11T11:43:42+00:00"
],
[
8453,
"aave-v3",
"0x99cbc45ea5bb7ef3a5bc08fb1b7e56bb2442ef0d",
"aBaswstETH",
"Aave Base wstETH",
"0xc1cba3fcea344f92d9239c08c0568f6f2f0ee452",
"wstETH",
19453896.98076391,
-2729624.0491152406,
2060492.243469131,
2013937.83233955,
46554.41112958104,
0,
-2699846.3743773997,
6.287055206630336e-7,
6.287055206630336e-7,
0,
0.00006359204409435188,
0.010405970621158238,
"2026-11-18T12:35:11+00:00"
],
[
8453,
"aave-v3",
"0x90da57e0a6c0d166bf15764e03b83745dc90025b",
"aBasEURC",
"Aave Base EURC",
"0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42",
"EURC",
11714367.016498774,
836683.0962385908,
5871401.742652832,
4833853.357290186,
1037548.3853626456,
1585596.4555783654,
-178.9954151250422,
0.017873888167474837,
0.017873888167474837,
0,
0.04061833496918762,
0.48740548032059966,
"2026-11-18T12:33:37+00:00"
],
[
8453,
"aave-v3",
"0x067ae75628177fd257c2b1e500993e1a0babcbd1",
"aBasGHO",
"Aave Base GHO",
"0x6bb7a212910682dcfdbd5bcbb3e28fb4e8da10ee",
"GHO",
1249280.1057589373,
-44023.30499415635,
189176.59919590486,
231751.58274418037,
-42574.983548275515,
51129.80521279693,
-14686.196014483256,
0.06453898330711448,
0.06453898330711448,
0,
0.07901811313409711,
0.9064331493088638,
"2026-11-18T10:32:52+00:00"
],
[
8453,
"aave-v3",
"0x67eaf2bee4384a2f84da9eb8105c661c123736ba",
"aBasAAVE",
"Aave Base AAVE",
"0x63706e401c06ac8513145b7687a14804d17f814b",
"AAVE",
852650.5237194898,
-102547.30397283903,
63387.65152550142,
59632.238355688765,
3755.413169812651,
0,
-102547.30397283903,
0,
0,
0,
0,
0,
"2026-11-18T12:37:45+00:00"
],
[
8453,
"aave-v3",
"0xbcffb4b3beadc989bd1458740952af6ec8fbe431",
"aBastBTC",
"Aave Base tBTC",
"0x236aa50979d5f3de3bd1eeb40e81137f22ab794b",
"tBTC",
178276.98896501874,
-31129.148439099197,
4.030755826202981,
4051.6679434381313,
-4047.6371876119283,
0,
-27519.9560288708,
0.0011419399093994481,
0.0011419399093994481,
0,
0.01696534650479235,
0.13461040603314287,
"2026-11-17T15:16:46+00:00"
]
],
"rows": 10
}
]
400
Bad Request: Invalid request parameters or malformed request.
401
Unauthorized: Missing or invalid API key. Include X-API-Key header with your request.
403
Forbidden: Invalid API key or insufficient permissions to access this resource.
404
Not Found: Endpoint or resource does not exist.
408
Request Timeout: Request took too long to process. Try again.
500
Internal Server Error: An unexpected error occurred while processing your request.
503
Service Unavailable: The server is temporarily unable to handle the request. Please try again later.
Examples
1. Top Aave V3 Pools by TVL over the Last 7 Days
This example retrieves the 10 largest Aave V3 pools on Base, showing their 7-day flow and APY metrics.
curl
curl -X GET "https://api.cambrian.org/evm/lending/aave/v3/pools/windows?timeframe=7d&limit=10" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json"
Response:
JSON
1[
2 {
3 "columns": [
4 {
5 "name": "chainId",
6 "type": "UInt16"
7 },
8 {
9 "name": "protocolId",
10 "type": "String"
11 },
12 {
13 "name": "poolAddress",
14 "type": "FixedString(42)"
15 },
16 {
17 "name": "symbol",
18 "type": "Nullable(String)"
19 },
20 {
21 "name": "name",
22 "type": "Nullable(String)"
23 },
24 {
25 "name": "underlyingAddress",
26 "type": "FixedString(42)"
27 },
28 {
29 "name": "underlyingSymbol",
30 "type": "String"
31 },
32 {
33 "name": "tvlUsd",
34 "type": "Float64"
35 },
36 {
37 "name": "tvlUsdChange",
38 "type": "Float64"
39 },
40 {
41 "name": "depositsUsd",
42 "type": "Float64"
43 },
44 {
45 "name": "withdrawalsUsd",
46 "type": "Float64"
47 },
48 {
49 "name": "netFlowUsd",
50 "type": "Float64"
51 },
52 {
53 "name": "borrowsUsd",
54 "type": "Float64"
55 },
56 {
57 "name": "availableLiquidityChangeUsd",
58 "type": "Float64"
59 },
60 {
61 "name": "supplyApy",
62 "type": "Float64"
63 },
64 {
65 "name": "supplyBaseApy",
66 "type": "Float64"
67 },
68 {
69 "name": "supplyExtraRewardsApy",
70 "type": "Float64"
71 },
72 {
73 "name": "borrowApy",
74 "type": "Float64"
75 },
76 {
77 "name": "utilizationRate",
78 "type": "Float64"
79 },
80 {
81 "name": "updatedAt",
82 "type": "DateTime('UTC')"
83 }
84 ],
85 "data": [
86 [
87 8453,
88 "aave-v3",
89 "0xbdb9300b7cde636d9cd4aff00f6f009ffbbc8ee6",
90 "aBascbBTC",
91 "Aave Base cbBTC",
92 "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
93 "cbBTC",
94 213476881.53122863,
95 -21619684.104109317,
96 47586726.64825358,
97 37614546.80154517,
98 9972179.84670841,
99 8904430.75428932,
100 -20896666.351077467,
101 0.00008907155148303311,
102 0.00008907155148303311,
103 0,
104 0.006393065268894976,
105 0.02786225380350281,
106 "2026-11-18T12:42:26+00:00"
107 ],
108 [
109 8453,
110 "aave-v3",
111 "0x4e65fe4dba92790696d040ac24aa414708f5c0ab",
112 "aBasUSDC",
113 "Aave Base USDC",
114 "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
115 "USDC",
116 185695790.85841143,
117 -10898629.706488997,
118 55149976.43711399,
119 65239849.964101985,
120 -10089873.526987992,
121 15332978.802599998,
122 -3580709.29081586,
123 0.05325724173657701,
124 0.05325724173657701,
125 0,
126 0.06446942582700732,
127 0.9169773925651605,
128 "2026-11-18T12:42:28+00:00"
129 ],
130 [
131 8453,
132 "aave-v3",
133 "0xd4a0e0b9149bcee3c920d2e00b5de09138fd8bb7",
134 "aBasWETH",
135 "Aave Base WETH",
136 "0x4200000000000000000000000000000000000006",
137 "WETH",
138 175966888.6325674,
139 -31880041.497113824,
140 38488219.26538195,
141 45643758.94093926,
142 -7155539.675557315,
143 22013495.14579357,
144 -10627016.326680735,
145 0.013475810342660644,
146 0.013475810342660644,
147 0,
148 0.019907755441077462,
149 0.7963120251632152,
150 "2026-11-18T12:42:26+00:00"
151 ],
152 [
153 8453,
154 "aave-v3",
155 "0xcf3d55c10db69f28fd1a75bd73f3d8a2d9c595ad",
156 "aBascbETH",
157 "Aave Base cbETH",
158 "0x2ae3f1ec7f1f5012cfeab0185bfc7aa3cf0dec22",
159 "cbETH",
160 118174091.727348,
161 -16055825.172092319,
162 8168696.285737191,
163 7270184.199330297,
164 898512.086406894,
165 0,
166 -16046709.146110713,
167 3.733986244700054e-8,
168 3.733986244700054e-8,
169 0,
170 0.00008266425899274607,
171 0.0005314129018432831,
172 "2026-11-18T11:48:58+00:00"
173 ],
174 [
175 8453,
176 "aave-v3",
177 "0x80a94c36747cf51b2fbabdff045f6d22c1930ed1",
178 "aBaswrsETH",
179 "Aave Base wrsETH",
180 "0xedfa23602d0ec14714057867a78d01e94176bea0",
181 "wrsETH",
182 21897126.601792715,
183 -3412506.8908815123,
184 0,
185 0,
186 0,
187 0,
188 -3412506.8908815123,
189 0,
190 0,
191 0,
192 0.01,
193 0,
194 "2026-11-11T11:43:42+00:00"
195 ],
196 [
197 8453,
198 "aave-v3",
199 "0x99cbc45ea5bb7ef3a5bc08fb1b7e56bb2442ef0d",
200 "aBaswstETH",
201 "Aave Base wstETH",
202 "0xc1cba3fcea344f92d9239c08c0568f6f2f0ee452",
203 "wstETH",
204 19453896.98076391,
205 -2729624.0491152406,
206 2060492.243469131,
207 2013937.83233955,
208 46554.41112958104,
209 0,
210 -2699846.3743773997,
211 6.287055206630336e-7,
212 6.287055206630336e-7,
213 0,
214 0.00006359204409435188,
215 0.010405970621158238,
216 "2026-11-18T12:35:11+00:00"
217 ],
218 [
219 8453,
220 "aave-v3",
221 "0x90da57e0a6c0d166bf15764e03b83745dc90025b",
222 "aBasEURC",
223 "Aave Base EURC",
224 "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42",
225 "EURC",
226 11714367.016498774,
227 836683.0962385908,
228 5871401.742652832,
229 4833853.357290186,
230 1037548.3853626456,
231 1585596.4555783654,
232 -178.9954151250422,
233 0.017873888167474837,
234 0.017873888167474837,
235 0,
236 0.04061833496918762,
237 0.48740548032059966,
238 "2026-11-18T12:33:37+00:00"
239 ],
240 [
241 8453,
242 "aave-v3",
243 "0x067ae75628177fd257c2b1e500993e1a0babcbd1",
244 "aBasGHO",
245 "Aave Base GHO",
246 "0x6bb7a212910682dcfdbd5bcbb3e28fb4e8da10ee",
247 "GHO",
248 1249280.1057589373,
249 -44023.30499415635,
250 189176.59919590486,
251 231751.58274418037,
252 -42574.983548275515,
253 51129.80521279693,
254 -14686.196014483256,
255 0.06453898330711448,
256 0.06453898330711448,
257 0,
258 0.07901811313409711,
259 0.9064331493088638,
260 "2026-11-18T10:32:52+00:00"
261 ],
262 [
263 8453,
264 "aave-v3",
265 "0x67eaf2bee4384a2f84da9eb8105c661c123736ba",
266 "aBasAAVE",
267 "Aave Base AAVE",
268 "0x63706e401c06ac8513145b7687a14804d17f814b",
269 "AAVE",
270 852650.5237194898,
271 -102547.30397283903,
272 63387.65152550142,
273 59632.238355688765,
274 3755.413169812651,
275 0,
276 -102547.30397283903,
277 0,
278 0,
279 0,
280 0,
281 0,
282 "2026-11-18T12:37:45+00:00"
283 ],
284 [
285 8453,
286 "aave-v3",
287 "0xbcffb4b3beadc989bd1458740952af6ec8fbe431",
288 "aBastBTC",
289 "Aave Base tBTC",
290 "0x236aa50979d5f3de3bd1eeb40e81137f22ab794b",
291 "tBTC",
292 178276.98896501874,
293 -31129.148439099197,
294 4.030755826202981,
295 4051.6679434381313,
296 -4047.6371876119283,
297 0,
298 -27519.9560288708,
299 0.0011419399093994481,
300 0.0011419399093994481,
301 0,
302 0.01696534650479235,
303 0.13461040603314287,
304 "2026-11-17T15:16:46+00:00"
305 ]
306 ],
307 "rows": 10
308 }
309]
2 {
3 "columns": [
4 {
5 "name": "chainId",
6 "type": "UInt16"
7 },
8 {
9 "name": "protocolId",
10 "type": "String"
11 },
12 {
13 "name": "poolAddress",
14 "type": "FixedString(42)"
15 },
16 {
17 "name": "symbol",
18 "type": "Nullable(String)"
19 },
20 {
21 "name": "name",
22 "type": "Nullable(String)"
23 },
24 {
25 "name": "underlyingAddress",
26 "type": "FixedString(42)"
27 },
28 {
29 "name": "underlyingSymbol",
30 "type": "String"
31 },
32 {
33 "name": "tvlUsd",
34 "type": "Float64"
35 },
36 {
37 "name": "tvlUsdChange",
38 "type": "Float64"
39 },
40 {
41 "name": "depositsUsd",
42 "type": "Float64"
43 },
44 {
45 "name": "withdrawalsUsd",
46 "type": "Float64"
47 },
48 {
49 "name": "netFlowUsd",
50 "type": "Float64"
51 },
52 {
53 "name": "borrowsUsd",
54 "type": "Float64"
55 },
56 {
57 "name": "availableLiquidityChangeUsd",
58 "type": "Float64"
59 },
60 {
61 "name": "supplyApy",
62 "type": "Float64"
63 },
64 {
65 "name": "supplyBaseApy",
66 "type": "Float64"
67 },
68 {
69 "name": "supplyExtraRewardsApy",
70 "type": "Float64"
71 },
72 {
73 "name": "borrowApy",
74 "type": "Float64"
75 },
76 {
77 "name": "utilizationRate",
78 "type": "Float64"
79 },
80 {
81 "name": "updatedAt",
82 "type": "DateTime('UTC')"
83 }
84 ],
85 "data": [
86 [
87 8453,
88 "aave-v3",
89 "0xbdb9300b7cde636d9cd4aff00f6f009ffbbc8ee6",
90 "aBascbBTC",
91 "Aave Base cbBTC",
92 "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
93 "cbBTC",
94 213476881.53122863,
95 -21619684.104109317,
96 47586726.64825358,
97 37614546.80154517,
98 9972179.84670841,
99 8904430.75428932,
100 -20896666.351077467,
101 0.00008907155148303311,
102 0.00008907155148303311,
103 0,
104 0.006393065268894976,
105 0.02786225380350281,
106 "2026-11-18T12:42:26+00:00"
107 ],
108 [
109 8453,
110 "aave-v3",
111 "0x4e65fe4dba92790696d040ac24aa414708f5c0ab",
112 "aBasUSDC",
113 "Aave Base USDC",
114 "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
115 "USDC",
116 185695790.85841143,
117 -10898629.706488997,
118 55149976.43711399,
119 65239849.964101985,
120 -10089873.526987992,
121 15332978.802599998,
122 -3580709.29081586,
123 0.05325724173657701,
124 0.05325724173657701,
125 0,
126 0.06446942582700732,
127 0.9169773925651605,
128 "2026-11-18T12:42:28+00:00"
129 ],
130 [
131 8453,
132 "aave-v3",
133 "0xd4a0e0b9149bcee3c920d2e00b5de09138fd8bb7",
134 "aBasWETH",
135 "Aave Base WETH",
136 "0x4200000000000000000000000000000000000006",
137 "WETH",
138 175966888.6325674,
139 -31880041.497113824,
140 38488219.26538195,
141 45643758.94093926,
142 -7155539.675557315,
143 22013495.14579357,
144 -10627016.326680735,
145 0.013475810342660644,
146 0.013475810342660644,
147 0,
148 0.019907755441077462,
149 0.7963120251632152,
150 "2026-11-18T12:42:26+00:00"
151 ],
152 [
153 8453,
154 "aave-v3",
155 "0xcf3d55c10db69f28fd1a75bd73f3d8a2d9c595ad",
156 "aBascbETH",
157 "Aave Base cbETH",
158 "0x2ae3f1ec7f1f5012cfeab0185bfc7aa3cf0dec22",
159 "cbETH",
160 118174091.727348,
161 -16055825.172092319,
162 8168696.285737191,
163 7270184.199330297,
164 898512.086406894,
165 0,
166 -16046709.146110713,
167 3.733986244700054e-8,
168 3.733986244700054e-8,
169 0,
170 0.00008266425899274607,
171 0.0005314129018432831,
172 "2026-11-18T11:48:58+00:00"
173 ],
174 [
175 8453,
176 "aave-v3",
177 "0x80a94c36747cf51b2fbabdff045f6d22c1930ed1",
178 "aBaswrsETH",
179 "Aave Base wrsETH",
180 "0xedfa23602d0ec14714057867a78d01e94176bea0",
181 "wrsETH",
182 21897126.601792715,
183 -3412506.8908815123,
184 0,
185 0,
186 0,
187 0,
188 -3412506.8908815123,
189 0,
190 0,
191 0,
192 0.01,
193 0,
194 "2026-11-11T11:43:42+00:00"
195 ],
196 [
197 8453,
198 "aave-v3",
199 "0x99cbc45ea5bb7ef3a5bc08fb1b7e56bb2442ef0d",
200 "aBaswstETH",
201 "Aave Base wstETH",
202 "0xc1cba3fcea344f92d9239c08c0568f6f2f0ee452",
203 "wstETH",
204 19453896.98076391,
205 -2729624.0491152406,
206 2060492.243469131,
207 2013937.83233955,
208 46554.41112958104,
209 0,
210 -2699846.3743773997,
211 6.287055206630336e-7,
212 6.287055206630336e-7,
213 0,
214 0.00006359204409435188,
215 0.010405970621158238,
216 "2026-11-18T12:35:11+00:00"
217 ],
218 [
219 8453,
220 "aave-v3",
221 "0x90da57e0a6c0d166bf15764e03b83745dc90025b",
222 "aBasEURC",
223 "Aave Base EURC",
224 "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42",
225 "EURC",
226 11714367.016498774,
227 836683.0962385908,
228 5871401.742652832,
229 4833853.357290186,
230 1037548.3853626456,
231 1585596.4555783654,
232 -178.9954151250422,
233 0.017873888167474837,
234 0.017873888167474837,
235 0,
236 0.04061833496918762,
237 0.48740548032059966,
238 "2026-11-18T12:33:37+00:00"
239 ],
240 [
241 8453,
242 "aave-v3",
243 "0x067ae75628177fd257c2b1e500993e1a0babcbd1",
244 "aBasGHO",
245 "Aave Base GHO",
246 "0x6bb7a212910682dcfdbd5bcbb3e28fb4e8da10ee",
247 "GHO",
248 1249280.1057589373,
249 -44023.30499415635,
250 189176.59919590486,
251 231751.58274418037,
252 -42574.983548275515,
253 51129.80521279693,
254 -14686.196014483256,
255 0.06453898330711448,
256 0.06453898330711448,
257 0,
258 0.07901811313409711,
259 0.9064331493088638,
260 "2026-11-18T10:32:52+00:00"
261 ],
262 [
263 8453,
264 "aave-v3",
265 "0x67eaf2bee4384a2f84da9eb8105c661c123736ba",
266 "aBasAAVE",
267 "Aave Base AAVE",
268 "0x63706e401c06ac8513145b7687a14804d17f814b",
269 "AAVE",
270 852650.5237194898,
271 -102547.30397283903,
272 63387.65152550142,
273 59632.238355688765,
274 3755.413169812651,
275 0,
276 -102547.30397283903,
277 0,
278 0,
279 0,
280 0,
281 0,
282 "2026-11-18T12:37:45+00:00"
283 ],
284 [
285 8453,
286 "aave-v3",
287 "0xbcffb4b3beadc989bd1458740952af6ec8fbe431",
288 "aBastBTC",
289 "Aave Base tBTC",
290 "0x236aa50979d5f3de3bd1eeb40e81137f22ab794b",
291 "tBTC",
292 178276.98896501874,
293 -31129.148439099197,
294 4.030755826202981,
295 4051.6679434381313,
296 -4047.6371876119283,
297 0,
298 -27519.9560288708,
299 0.0011419399093994481,
300 0.0011419399093994481,
301 0,
302 0.01696534650479235,
303 0.13461040603314287,
304 "2026-11-17T15:16:46+00:00"
305 ]
306 ],
307 "rows": 10
308 }
309]
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)
bash
npm install @x402/fetch @x402/evm viem
TypeScript
1import { x402Client } from "@x402/core/client";
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/lending/aave/v3/pools/windows"
11);
12const data = await response.json();
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/lending/aave/v3/pools/windows"
11);
12const data = await response.json();
Quickstart (Python)
bash
pip install "x402[httpx]"
Python
1import asyncio, os
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/lending/aave/v3/pools/windows")
13 print(response.json())
14asyncio.run(main())
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/lending/aave/v3/pools/windows")
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