# Aave v3 APY & TVL History

> Aave v3 APY & TVL History is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Returns daily supply APY (base + rewards) and TVL history for a specific asset on an Aave v3 market, with summary stats (avg, max, min, current) over a chosen period.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/aave-apy-history?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aave-v3-apy-tvl-history-59cf6aa9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7mQUe5YrLwQKwhuJ5iD0l

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 aave-v3-apy-tvl-history-59cf6aa9 -d '<json body>'
```

Example prompt: What's been the daily supply APY and TVL for USDC on Aave v3 Ethereum over the last 30 days? Give me the average, max, and min APY too.

## When to prefer this

Choose this endpoint when you need historical daily APY and TVL data specifically for Aave v3 markets, sourced from DefiLlama. It is ideal for yield sustainability analysis, trend monitoring, and summary statistics over a custom time window. Prefer this over generic DeFi dashboards when you need structured, machine-readable data with aggregated stats (avg/max/min) for agent-driven workflows. Not suitable for real-time tick data, other lending protocols (Compound, Morpho), or Aave v1/v2 markets.

## Known failure modes

- Unknown asset or network combination returns empty or error response
- Unsupported chain not indexed by DefiLlama returns no data
- Very short history (newly launched market) may return fewer data points than requested
- Invalid days parameter (non-integer or out-of-range) may cause a 400 error
- Rate limiting or payment failure returns 402 or 429 error

## How this service works

Daily history of the supply APY (base and rewards) and TVL of an Aave v3 market (asset and chain), with average, max and min over the period. DefiLlama data.

## Output

Returns a JSON object with: the asset name, network, pool ID, stablecoin flag, number of days, a daily time series of APY (%) and TVL (USD), plus summary statistics — average, max, min, and current APY and TVL. Includes a human-readable note about interpreting yield sustainability. Source is DefiLlama.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {
      "days": {
       "type": "integer"
      },
      "asset": {
       "type": "string"
      },
      "network": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "days": {
       "type": [
        "number",
        "null"
       ]
      },
      "note": {
       "type": [
        "string",
        "null"
       ]
      },
      "asset": {
       "type": [
        "string",
        "null"
       ]
      },
      "series": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "date": {
          "type": [
           "null",
           "string"
          ]
         },
         "apy_pct": {
          "type": [
           "null",
           "number"
          ]
         },
         "tvl_usd": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "stable": {
       "type": [
        "string",
        "null"
       ]
      },
      "network": {
       "type": [
        "string",
        "null"
       ]
      },
      "pool_id": {
       "type": [
        "string",
        "null"
       ]
      },
      "avg_apy_pct": {
       "type": [
        "number",
        "null"
       ]
      },
      "max_apy_pct": {
       "type": [
        "number",
        "null"
       ]
      },
      "min_apy_pct": {
       "type": [
        "number",
        "null"
       ]
      },
      "current_apy_pct": {
       "type": [
        "number",
        "null"
       ]
      },
      "current_tvl_usd": {
       "type": [
        "number",
        "null"
       ]
      }

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 30,
  "note": "Average APY and its change tell whether the yield is real and sustained or a one-off spike. Source: DefiLlama.",
  "asset": "USDC",
  "series": [
   {
    "date": "2026-09-03",
    "apy_pct": 3.53,
    "tvl_usd": 169539744
   },
   {
    "date": "2026-09-05",
    "apy_pct": 3.59,
    "tvl_usd": 151177905
   }
  ],
  "stable": "yes",
  "network": "Ethereum",
  "pool_id": "aa70268e-4b52-42bf-a116-608b370f9501",
  "avg_apy_pct": 3.64,
  "max_apy_pct": 4.08,
  "min_apy_pct": 3.52,
  "current_apy_pct": 3.68,
  "current_tvl_usd": 156876478
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aave-v3-apy-tvl-history-59cf6aa9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)