# Vextorium Pool APY History

> Vextorium Pool APY History is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Returns historical APY and TVL time-series data for a DeFi liquidity pool over a configurable look-back window (7–365 days), sourced from DefiLlama.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/pool-apy-history?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-pool-apy-history-325ffdc0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J5ty0VmQfSPddle--wSBA

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 vextorium-pool-apy-history-325ffdc0 -d '<json body>'
```

Example prompt: Pull the APY history for DeFi pool ID 43641cf5-a92e-416b-bce9-27113d3c0db6 over the last 90 days and tell me whether the yield looks stable, what the average and peak APY were, and what the current TVL is.

## When to prefer this

Use this endpoint when you need historical APY and TVL trend data for a specific DeFi liquidity pool identified by its DefiLlama pool ID. It is ideal for evaluating yield sustainability, detecting APY spikes vs stable returns, and building time-series charts. If you only need current yield snapshots across many pools (not historical depth), a DeFi yields discovery endpoint would be more appropriate.

## Known failure modes

- Invalid or unknown pool_id returns an error or empty series
- days value outside 7–365 range rejected with validation error
- Pool has insufficient historical data for requested window, resulting in partial series
- DefiLlama source data unavailable causing upstream timeout or null values in series

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object containing a daily time-series array (each entry with date, APY percentage, and TVL in USD), plus aggregate statistics: average APY, min APY, max APY, current APY, current TVL, a stability flag ('yes'/'no'), the pool ID, and a look-back window in days. Also includes a human-readable note explaining how to interpret the data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "maximum": 365,
   "minimum": 7,
   "description": "Look-back window in days (7-365, default 90)"
  },
  "pool_id": {
   "type": "string",
   "description": "Pool id (the 'id' field from the DeFi yields service)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 90,
  "note": "Average APY and its change tell whether the yield is real and sustained or a one-off spike. Source: DefiLlama.",
  "series": [
   {
    "date": "2026-07-03",
    "apy_pct": 5.17,
    "tvl_usd": 3170318295
   },
   {
    "date": "2026-07-10",
    "apy_pct": 4.89,
    "tvl_usd": 3336696799
   }
  ],
  "stable": "yes",
  "pool_id": "43641cf5-a92e-416b-bce9-27113d3c0db6",
  "avg_apy_pct": 4.96,
  "max_apy_pct": 5.26,
  "min_apy_pct": 4.8,
  "current_apy_pct": 5.14,
  "current_tvl_usd": 2871719879
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-pool-apy-history-325ffdc0/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)