Docs / Aave v3 risk card

How do I read Aave v3 risk for an address before my agent acts?

Meridian by MioDio gives back an Aave v3 snapshot for one EVM address on Base or Ethereum: health factor, collateral, debt, available borrows, LTV, and liquidation distance, for $0.005 USDC on Base via x402. Upstream RPC failure is a charged 200 with status partial.

Fields returned

Demo card includes aave_v3 with protocol, pool, total_collateral_usd, total_debt_usd, available_borrows_usd, liquidation_threshold_pct, ltv_pct, health_factor, and raw Pool.getUserAccountData fields. MVP uses that pool read only.

Chain query

Query chain=base or chain=ethereum.

Call it (curl + free demo)

curl -s "https://meridian.miodiollc.com/v1/demo/risk"
curl -i "https://meridian.miodiollc.com/v1/risk/0xbe00A0de23A02A85d7fb7451ab9b69D84fd61Fe3?chain=base"

Unpaid -> HTTP 402 + PAYMENT-REQUIRED.

Price

$0.005 USDC on Base (~5000 atomic). Network eip155:8453. Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. payTo 0x4DA1ED782BD61BaE9AdD5a5CaBbCf32f767f8d7F.

Errors

Response (demo, trimmed)

{
  "version": "0.9.0",
  "status": "ok",
  "address": "0xbe00A0de23A02A85d7fb7451ab9b69D84fd61Fe3",
  "chain": "base",
  "aave_v3": {
    "protocol": "aave_v3",
    "pool": "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5",
    "total_collateral_usd": "0",
    "total_debt_usd": "0",
    "available_borrows_usd": "0",
    "liquidation_threshold_pct": "0.00",
    "ltv_pct": "0.00",
    "health_factor": null
  }
}

What it does NOT do

Unpaid calls return HTTP 402 with PAYMENT-REQUIRED. Retry with PAYMENT-SIGNATURE.

FAQ

Which chains?
Base or Ethereum.
Are balances invented?
No. Missing fields mean the read failed or was not attempted.
What happens on RPC failure?
Charged HTTP 200 with status partial. Unexpected Worker 5xx is not charged.
Is this financial advice?
No.

Related