Give the machine one supported chain and one native, ERC-20, or allowlisted symbol asset. It returns currently observed factual Aave V3 lending and Lido liquid-staking venues and rates from a frozen protocol set, with evidence, timestamps, explicit APR/APY labels, and limitations. Optional filters, objective sort, and a result limit are available. It does not recommend a venue, connect a wallet, or construct a transaction.
PURPOSE
Plain-English job
Agents often need a factual look at current protocol supply rates before they act. This machine reads Aave V3 on-chain reserve state and, where applicable, the official Lido stETH APR. It is a protocol rate snapshot, not a complete map of DeFi, and not investment advice.
WHEN TO CALL
Job-shaped selection
Call when you need currently observed Aave V3 supply APR and/or Lido staking APR for one supported Ethereum or Base asset. Factual snapshot only — not a ranking, recommendation, or complete map of DeFi. Sibling first-party machines are listed on GET /v1/catalog.
INPUT
Exact JSON object
Required chain_id (1 or 8453) and asset. Native and ERC-20 V1 forms remain accepted. Allowlisted symbols: Ethereum ETH, WETH, USDC, stETH, wstETH; Base ETH, WETH, USDC. Optional venue_types, protocols, sort (protocol, rate_desc, rate_asc), and limit 1–20. Additional properties and unsupported symbols are rejected before payment.
Classification is OBSERVED_COMPLETE, OBSERVED_PARTIAL, OBSERVED_EMPTY_SUPPORTED_SET, HOLD_UPSTREAM, or HOLD_OUTPUT_REFUSED. Default venue order is protocol, then market, then venue id. sort=rate_desc and rate_asc use rates.primary_apr only and are labeled objective_sort_not_a_recommendation. There is no desirability ranking. HOLD_OUTPUT_REFUSED is a local generated-output refusal, not an upstream outage.
HOW DATA IS PROCESSED
Terms-relevant facts
FROZEN PROTOCOL SETV2 observes Aave V3 on Ethereum and Base plus official Lido stETH APR on Ethereum. Pool is resolved from PoolAddressesProvider on every uncached Aave observation. Compound III is not included.
NATIVE MAPPINGNative ETH maps to canonical WETH on that chain. The mapping is disclosed in evidence.
AAVE RATEScurrentLiquidityRate is preserved as a RAY decimal string. Supply APR is that RAY divided by 1e27 and is copied to rates.primary_apr with kind aave_v3_supply_apr. Derived APY uses daily compounding over 365 and is labeled DERIVED_DAILY_COMPOUNDING_365. It is not a guaranteed return.
LIDO RATESOfficial eth-api.lido.fi last APR is required for Lido adapter success. SMA is optional enrichment. Lido APR is percentage points, normalized to a decimal fraction. Lido supply_apy / derived APY remain null. rates.primary_apr is the observed staking APR.
NO RECOMMENDATIONThis is a factual snapshot of supported protocol state. It is not investment advice, not a recommendation, and not a complete map of DeFi.
AFTER SETTLEMENTA required dependency failure may return HOLD_UPSTREAM after payment and may be reviewed for one no-extra-charge replay or refund handled manually. Email contact@agentmercantile.com with the receipt ID. PARTIAL is not automatically remediation eligible. HOLD_OUTPUT_REFUSED is not automatically remediation eligible.
NO EXECUTIONNo wallet connection, signing, custody, swap, bridge, lending, or staking transaction.
LIMITATIONS
Known bounds
ETHEREUM AND BASE ONLYchain_id 1 or 8453. No extra chains.
NO INCENTIVE APRAave reward APR and total APY remain null. They are not fabricated as zero.
NO YIELD HISTORYPoint-in-time observation only. 60-second cache after settlement.
AVAILABLEVM04 is a bounded pay-per-call product. This page does not start a payment. A free captured sample is available before purchase.
CONTRACT
Intended routes
Public API origin:
POST https://api.agentmercantile.com/v1/productive-venue-snapshot