{"uid":"cap_-JG4uhJYfv4NlpRL4qzVZ","slug":"saylor-innovations-data-desk-aave-v3-reserve-state-0e12ad8b","name":"Saylor Innovations Data Desk – Aave V3 Reserve State","description":"Aave V3 reserve state on 8 chains for any asset: supply and borrow APY, utilization, total supplied and borrowed, LTV, liquidation threshold and caps.","url":"https://saylorinnovations.com/api/chain/aave-reserve?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["chain","token"],"properties":{"chain":{"type":"string","description":"ethereum, base, arbitrum, optimism, polygon, avalanche, bsc or gnosis (or chain id)"},"token":{"type":"string","description":"the underlying asset contract (for example USDC)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["chain","chain_id","token","total_supplied","utilization_pct","supply_apy_pct","variable_borrow_apy_pct","ltv_pct","note","source"],"properties":{"note":{"type":"string","description":"plain-language reading of the result, including units"},"pool":{"type":"string","description":"Aave V3 Pool contract"},"chain":{"type":"string","description":"the chain name that was queried"},"token":{"type":"string","description":"underlying asset"},"active":{"type":"boolean","description":"reserve is active"},"frozen":{"type":"boolean","description":"reserve is frozen"},"paused":{"type":"boolean","description":"reserve is paused"},"source":{"type":"string","description":"where the data was read from"},"symbol":{"type":["string","null"],"description":"asset symbol"},"a_token":{"type":"string","description":"interest-bearing receipt token"},"ltv_pct":{"type":"number","description":"maximum loan-to-value"},"chain_id":{"type":"number","description":"EIP-155 chain id of that network"},"decimals":{"type":"number","description":"asset decimals"},"last_update":{"type":"string","description":"time the rates were last updated"},"supply_apr_pct":{"type":"number","description":"supply rate, annualised, percent"},"supply_apy_pct":{"type":"number","description":"supply rate compounded, percent"},"total_borrowed":{"type":"string","description":"total variable debt, asset units"},"total_supplied":{"type":"string","description":"total supplied, asset units"},"utilization_pct":{"type":"number","description":"borrowed share of supplied"},"borrow_cap_tokens":{"type":["number","null"],"description":"borrow cap in whole tokens"},"borrowing_enabled":{"type":"boolean","description":"borrowing allowed"},"supply_cap_tokens":{"type":["number","null"],"description":"supply cap in whole tokens"},"variable_debt_token":{"type":"string","description":"variable debt token"},"liquidation_bonus_pct":{"type":"number","description":"liquidator bonus, percent"},"variable_borrow_apr_pct":{"type":"number","description":"variable borrow rate, percent"},"variable_borrow_apy_pct":{"type":"number","description":"variable borrow rate compounded, percent"},"liquidation_threshold_pct":{"type":"number","description":"threshold at which liquidation starts"},"available_liquidity_approx":{"type":"string","description":"supplied minus borrowed"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JCktH0fzBXr8jI4k2BZhH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live Aave V3 reserve metrics for any asset on 8 chains, including supply/borrow APY, utilization, TVL, LTV, and liquidation parameters.","exampleAgentPrompt":"What's the current supply APY and utilization rate for USDC on Aave V3 Ethereum? Give me the contract address for the aToken too.","exampleUseCases":[{"title":"Yield farming rate comparison","prompt":"What's the current supply APY for USDC on Aave V3 Base and what's the utilization rate? I want to know if it's worth depositing there."},{"title":"DeFi borrowing cost check","prompt":"I'm thinking about borrowing WETH on Aave V3 Arbitrum — what's the current variable borrow APY and what's the maximum LTV I can use?"},{"title":"Reserve health monitoring","prompt":"Check the USDT reserve on Aave V3 Polygon for me — is it active, what's the utilization, and are there any borrow caps I should know about?"}],"resultDescription":"A JSON object containing: chain name and chain ID, token address and symbol, supply APR and APY (percent), variable borrow APR and APY (percent), total supplied and total borrowed amounts, utilization percentage, LTV percent, liquidation threshold percent, supply and borrow caps, aToken address, reserve status flags (active/frozen/paused), asset decimals, last update timestamp, data source, and a plain-language note summarizing the result.","failureModes":["Unsupported chain name or chain ID returns an error","Token contract address not found in Aave V3 reserve list for that chain returns a 404 or empty result","Reserve exists but has never been seeded — returns zeroed metrics","Malformed contract address causes a validation error","Chain is temporarily unavailable or RPC issues cause a timeout"],"whenToPreferThis":"Use this endpoint when you need real-time Aave V3 reserve data — supply/borrow rates, utilization, or risk parameters — for a specific token on a specific chain. It covers 8 chains in a single unified API, making it superior to querying each chain's subgraph separately. Prefer this over generic DeFi data aggregators when you need structured, machine-readable output with explicit LTV and liquidation parameters for agent-driven lending or yield decisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:31:06.571Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-data-desk-aave-v3-reserve-state-0e12ad8b"}