# Beefy Finance Vault Detail

> Beefy Finance Vault Detail 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-02).

Returns full details of a Beefy Finance vault by vault ID or contract address, including APY breakdown, TVL, fees, risk flags, token info, and live on-chain price-per-share data.

## Facts

- Endpoint: POST https://api.vextorium.com/beefy-vault-pago?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beefy-finance-vault-detail-caa18135
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OWde5gwv09D2PvkEFlgWr

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 beefy-finance-vault-detail-caa18135 -d '<json body>'
```

Example prompt: What are the full details for the Beefy Finance vault 'aerodrome-weth-usdc' — I need the APY breakdown, TVL, fees, risk flags, and the current on-chain price per share?

## When to prefer this

Use this endpoint when you need comprehensive, structured data about a specific Beefy Finance vault — including live on-chain verification of price per share and total deposits — rather than a simple APY list or aggregate protocol stats. Prefer this over generic DeFi data aggregators when Beefy-specific fields like strategy contracts, harvest timestamps, and Beefy risk flags are required.

## Known failure modes

- Invalid or unknown vault ID returns null or empty result
- Vault contract address not found on supported chains returns error
- On-chain RPC call failure may result in null onchain fields
- Truncated or malformed vault ID causes lookup failure
- Network timeout on on-chain price-per-share check

## How this service works

Full detail of a Beefy Finance vault by id or vault contract address: APY breakdown, TVL, performance/deposit/withdraw fees, risk flags, deposited token and price, vault and strategy contracts, last harvest, plus an on-chain check of price per share and total deposits.

## Output

A JSON object containing vault ID, name, platform, assets, APY percentage, full APY/APR breakdown (vault APR, pool fees APR, compounding frequency), TVL in USD, deposit/withdrawal/performance fees, risk flag array, vault and strategy contract addresses, deposited token and price, last harvest timestamp, links for adding/removing liquidity, and on-chain data including price per share and total deposits.

## 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": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Beefy vault id (e.g. aerodrome-weth-usdc) or vault contract address"
      }
     }
    },
    "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": {
      "id": {
       "type": [
        "string",
        "null"
       ]
      },
      "red": {
       "type": [
        "string",
        "null"
       ]
      },
      "url": {
       "type": [
        "string",
        "null"
       ]
      },
      "creado": {
       "type": [
        "string",
        "null"
       ]
      },
      "estado": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "nombre": {
       "type": [
        "string",
        "null"
       ]
      },
      "activos": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "string"
        ]
       }
      },
      "apy_pct": {
       "type": [
        "number",
        "null"
       ]
      },
      "enlaces": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "añadir_liquidez": {},
        "retirar_liquidez": {}
       }
      },
      "onchain": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "valor_participacion": {
         "type": [
          "number",
          "null"
         ]
        },
        "token_depositado_total": {
         "type": [
          "number",
          "null"
         ]
        }
       }
      },
      "riesgos": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type"
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "morpho-base-gauntlet-frontier-usdc",
  "red": "base",
  "url": "https://app.beefy.com/vault/morpho-base-gauntlet-frontier-usdc",
  "creado": "2026-01-21T18:44:37Z",
  "estado": "activo",
  "fuente": "Beefy (api.beefy.finance); participaciones y valor por participación leídos on-chain",
  "nombre": "USDC (Gauntlet, Frontier V2)",
  "activos": [
   "USDC"
  ],
  "apy_pct": 5.15,
  "enlaces": {
   "añadir_liquidez": null,
   "retirar_liquidez": null
  },
  "onchain": {
   "valor_participacion": 1.088449703202246,
   "token_depositado_total": 362958.335458
  },
  "riesgos": [
   "Vault gestionado por un tercero (curator)"
  ],
  "tvl_usd": 362944,
  "contratos": {
   "vault": "0x83152eE78d8f20Bba134A5FF000D551355Ce3996",
   "estrategia": "0x1FdD1C2533B0bABab328eb4bCB3c94b19a3a5cEB"
  },
  "comisiones": {
   "deposito_pct": 0,
   "retirada_pct": 0,
   "rendimiento_pct": 9.5
  },
  "estrategia": "single",
  "plataforma": "morpho",
  "rentabilidad": {
   "apr_vault_pct": 0,
   "apy_total_pct": 5.15,
   "reinversiones_al_año": 2190,
   "apr_comisiones_pool_pct": null,
   "apr_liquidez_concentrada_pct": null
  },
  "ultima_cosecha": "2026-09-29T05:52:35Z",
  "token_depositado": {
   "simbolo": "USDC",
   "contrato": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "decimales": 6,
   "precio_usd": 0.99996257
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beefy-finance-vault-detail-caa18135/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)