# Meridian DeFi Risk Passport — Aave v3 Risk Card

> Meridian DeFi Risk Passport — Aave v3 Risk Card is a paid API for AI agents from workers.miodiollc.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Fetches an Aave v3 risk snapshot for an EVM address, returning health factor, collateral, debt, LTV, and liquidation threshold on Base or Ethereum.

## Facts

- Endpoint: GET https://workers.miodiollc.com/v1/risk/0x0000000000000000000000000000000000000001?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meridian-defi-risk-passport-aave-v3-risk-card-ad610824
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__E0-2tj4yYl16stBEdIUG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability meridian-defi-risk-passport-aave-v3-risk-card-ad610824
```

Example prompt: What's the Aave v3 risk snapshot for wallet 0xAbCd1234...5678 on Base — I want to see the health factor, collateral, debt, and how close it is to liquidation.

## When to prefer this

Choose this endpoint when you need a fast, cheap ($0.005 USDC) on-chain Aave v3 risk snapshot for a single EVM address on Base or Ethereum. It is the lightweight option compared to the deep passport or bundle endpoints — ideal for health factor checks, liquidation monitoring, and risk gates in automated agent workflows. Prefer the bundle or deep passport endpoints when you also need Lido, vault data, or OFAC SDN screening in a single call.

## Known failure modes

- Address has no Aave v3 position — aave_v3 field returns null
- Invalid or malformed EVM address — request fails or returns error array
- RPC read failure on the selected chain — status returns 'partial' with errors listed
- Unsupported chain value — schema validation rejects the request
- Payment not completed via x402 — 402 response returned before data is served

## How this service works

Meridian — DeFi risk cards for agents. Aave v3, Lido, vaults, deep passport, OFAC SDN screen, parameter-drift, and transaction simulation via x402 on Base.

## Output

A JSON object containing the Aave v3 position snapshot for the queried address, including: health factor (numeric, e.g. 3.21), total collateral in USD, total debt in USD, available borrows in USD, LTV percentage, liquidation threshold percentage, the raw on-chain values, the Aave pool address used, and metadata (chain, timestamp, status, disclaimer). Returns null for aave_v3 if the read fails.

## Request schema (JSON Schema)

```json
{
 "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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "EVM address (checksummed or 0x-prefixed hex) to snapshot on Aave v3"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum"
       ],
       "type": "string",
       "description": "Aave v3 read chain (public RPC). Defaults to base. Independent of the USDC payment network."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "product",
      "version",
      "status",
      "address",
      "chain",
      "as_of",
      "disclaimer",
      "aave_v3",
      "hooks"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "chain": {
       "enum": [
        "base",
        "ethereum"
       ],
       "type": "string"
      },
      "hooks": {
       "type": "object"
      },
      "errors": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "status": {
       "enum": [
        "ok",
        "partial"
       ],
       "type": "string"
      },
      "aave_v3": {
       "type": [
        "object",
        "null"
       ]
      },
      "address": {
       "type": "string"
      },
      "product": {
       "type": "string",
       "const": "mio_dio_defi_risk_passport"
      },
      "version": {
       "type": "string"
      },
      "disclaimer": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-09-14T00:00:00.000Z",
  "chain": "base",
  "hooks": {
   "next": [
    "Optional: stablecoin exposure breakdown via UiPoolDataProvider"
   ],
   "notes": [
    "MVP uses Aave v3 Pool.getUserAccountData only (collateral, debt, HF).",
    "No social scrapes, no off-chain enrichment resale."
   ]
  },
  "status": "ok",
  "aave_v3": {
   "raw": {
    "ltv": "7500",
    "healthFactor": "3210000000000000000",
    "totalDebtBase": "100000000",
    "totalCollateralBase": "1234000000",
    "availableBorrowsBase": "567000000",
    "currentLiquidationThreshold": "8250"
   },
   "pool": "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5",
   "ltv_pct": "75.00",
   "protocol": "aave_v3",
   "health_factor": "3.21",
   "total_debt_usd": "1.00",
   "total_collateral_usd": "12.34",
   "available_borrows_usd": "5.67",
   "liquidation_threshold_pct": "82.50"
  },
  "address": "0x0000000000000000000000000000000000000001",
  "product": "mio_dio_defi_risk_passport",
  "version": "0.7.0",
  "disclaimer": "MioDio DeFi Risk Passport (MVP). Best-effort public on-chain reads only. Not financial, legal, or investment advice. No KYC/social enrichment. Balances are never invented — missing fields mean the read failed or was not attempted. Always verify on-chain."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meridian-defi-risk-passport-aave-v3-risk-card-ad610824/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from workers.miodiollc.com](https://www.zero.xyz/host/workers.miodiollc.com/llms.txt)
