API · x402
Aave V3 reserve state on 8 chains for any asset: supply and borrow APY, utilization, to…
Aave V3 reserve state on 8 chains for any asset: supply and borrow APY, utilization, total supplied and borrowed, LTV, liquidation threshold and caps.
by Saylor Innovations Knowledge Base · verified provider · updated 2026-10-26
What it does
Aave V3 reserve state on 8 chains for any asset: supply and borrow APY, utilization, total supplied and borrowed, LTV, liquidation threshold and caps.
Tags: aave v3 reserve data · aave supply apy · aave borrow rate · lending utilization rate · aave ltv and caps
Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/saylorinnovations-api-chain-aave-reserve.jsonfor the price and payment options. - Pay. Call
GET https://saylorinnovations.com/api/chain/aave-reserve. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC or USDT or SOL on Base, Polygon, Arbitrum One, Solana, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.01 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base, Polygon, Arbitrum One, Solana
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Polygon eip155:137 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Arbitrum One eip155:42161 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDC | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDT | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | SOL | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "So11111111111111111111111111111111111111112",
"amount": "95830",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
}
]Schemas
Output schema (JSON Schema)
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "the chain name that was queried"
},
"chain_id": {
"type": "number",
"description": "EIP-155 chain id of that network"
},
"token": {
"type": "string",
"description": "underlying asset"
},
"symbol": {
"type": [
"string",
"null"
],
"description": "asset symbol"
},
"decimals": {
"type": "number",
"description": "asset decimals"
},
"pool": {
"type": "string",
"description": "Aave V3 Pool contract"
},
"a_token": {
"type": "string",
"description": "interest-bearing receipt token"
},
"variable_debt_token": {
"type": "string",
"description": "variable debt token"
},
"total_supplied": {
"type": "string",
"description": "total supplied, asset units"
},
"total_borrowed": {
"type": "string",
"description": "total variable debt, asset units"
},
"available_liquidity_approx": {
"type": "string",
"description": "supplied minus borrowed"
},
"utilization_pct": {
"type": "number",
"description": "borrowed share of supplied"
},
"supply_apr_pct": {
"type": "number",
"description": "supply rate, annualised, percent"
},
"supply_apy_pct": {
"type": "number",
"description": "supply rate compounded, percent"
},
"variable_borrow_apr_pct": {
"type": "number",
"description": "variable borrow rate, percent"
},
"variable_borrow_apy_pct": {
"type": "number",
"description": "variable borrow rate compounded, percent"
},
"ltv_pct": {
"type": "number",
"description": "maximum loan-to-value"
},
"liquidation_threshold_pct": {
"type": "number",
"description": "threshold at which liquidation starts"
},
"liquidation_bonus_pct": {
"type": "number",
"description": "liquidator bonus, percent"
},
"supply_cap_tokens": {
"type": [
"number",
"null"
],
"description": "supply cap in whole tokens"
},
"borrow_cap_tokens": {
"type": [
"number",
"null"
],
"description": "borrow cap in whole tokens"
},
"active": {
"type": "boolean",
"description": "reserve is active"
},
"frozen": {
"type": "boolean",
"description": "reserve is frozen"
},
"borrowing_enabled": {
"type": "boolean",
"description": "borrowing allowed"
},
"paused": {
"type": "boolean",
"description": "reserve is paused"
},
"last_update": {
"type": "string",
"description": "time the rates were last updated"
},
"note": {
"type": "string",
"description": "plain-language reading of the result, including units"
},
"source": {
"type": "string",
"description": "where the data was read from"
}
},
"required": [
"chain",
"chain_id",
"token",
"total_supplied",
"utilization_pct",
"supply_apy_pct",
"variable_borrow_apy_pct",
"ltv_pct",
"note",
"source"
]
}Example shape — generated from the schema, not a captured live response
{
"chain": "string",
"chain_id": 0,
"token": "string",
"symbol": "string",
"decimals": 0,
"pool": "string",
"a_token": "string",
"variable_debt_token": "string",
"total_supplied": "string",
"total_borrowed": "string",
"available_liquidity_approx": "string",
"utilization_pct": 0,
"supply_apr_pct": 0,
"supply_apy_pct": 0,
"variable_borrow_apr_pct": 0,
"variable_borrow_apy_pct": 0,
"ltv_pct": 0,
"liquidation_threshold_pct": 0,
"liquidation_bonus_pct": 0,
"supply_cap_tokens": 0,
"borrow_cap_tokens": 0,
"active": true,
"frozen": true,
"borrowing_enabled": true,
"paused": true,
"last_update": "string",
"note": "string",
"source": "string"
}Examples
curl
curl "https://saylorinnovations.com/api/chain/aave-reserve"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidJavaScript
const res = await fetch("https://saylorinnovations.com/api/chain/aave-reserve");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://saylorinnovations.com/api/chain/aave-reserve")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- Saylor Innovations Knowledge Base
- Endpoint
- https://saylorinnovations.com/api/chain/aave-reserve
- Side effects
- Paid calls settle the advertised payment; see the provider contract for execution behavior.
- Machine-readable
/resources/saylorinnovations-api-chain-aave-reserve.json