# Beefy Finance Vault Positions Lookup

> Beefy Finance Vault Positions Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-18).

Returns all Beefy Finance yield vault positions (amount, value, APY) for a given EVM wallet address on a specified chain.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/beefy-positions?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beefy-finance-vault-positions-lookup-93f0adc3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aV30y_qgWJaqv0kcIpGp8

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-positions-lookup-93f0adc3 -d '<json body>'
```

Example prompt: Can you check my Beefy Finance vault positions for wallet 0x1A07DceEfeEbBA3D1873e2B92BeF190d2f11C3cB on Base — show me which vaults I'm in, how much they're worth in USD, and what APY I'm earning?

## When to prefer this

Choose this endpoint when you need to look up Beefy Finance vault positions for a specific EVM wallet across Base, Ethereum, Arbitrum, Optimism, or Polygon. It is specifically useful for DeFi portfolio dashboards, yield farming audits, or recovering forgotten funds in retired vaults. It reads shares and price-per-share directly on-chain via Beefy's API, making it more reliable than parsing raw contract events. Prefer this over generic token balance endpoints when the user is specifically asking about Beefy yield vault positions and APY.

## Known failure modes

- Invalid or malformed EVM address returns an error or empty positions array
- Unsupported network enum value causes a validation error
- Wallet with no Beefy positions returns an empty positions array with total_value_usd of 0
- On-chain RPC timeouts may cause partial or failed responses
- Beefy API downtime upstream may result in stale or unavailable data

## 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 the wallet address, network, a list of vault positions (each with vault ID, name, URL, deposited token, asset pair, amount, USD value, APY percentage, and status), the number of reviewed vaults, and total portfolio value in USD. Includes retired vaults where funds may remain, but excludes staked BIFI and concentrated liquidity (CLM) vaults.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "EVM wallet address (0x...)"
  },
  "network": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon"
   ],
   "type": "string",
   "description": "Chain: base (default), ethereum, arbitrum, optimism or polygon"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Includes retired vaults, where forgotten funds sometimes remain. Does not include staked BIFI or concentrated liquidity vaults (CLM).",
  "source": "Beefy (api.beefy.finance); shares and price per share read on-chain",
  "address": "0x1A07DceEfeEbBA3D1873e2B92BeF190d2f11C3cB",
  "network": "base",
  "positions": [
   {
    "id": "aero-cow-weth-moobifi-vault",
    "url": "https://app.beefy.com/vault/aero-cow-weth-moobifi-vault",
    "name": "WETH-mooBIFI",
    "amount": 9.436634596504046,
    "assets": [
     "WETH",
     "mooBIFI"
    ],
    "status": "active",
    "apy_pct": 35.35,
    "value_usd": 358.66,
    "deposited_token": "WETH-mooBIFI"
   }
  ],
  "reviewed_vaults": 533,
  "total_value_usd": 358.66
 }
}
```

## More

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