# Beefy Finance Vault Positions by Wallet

> Beefy Finance Vault Positions by Wallet 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-02).

Returns all Beefy Finance vault positions (active and retired) for an EVM wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon, with share amounts, price-per-share, and USD valuations read directly on-chain.

## Facts

- Endpoint: POST https://api.vextorium.com/beefy-posiciones-pago?utm_source=zero.xyz
- Price: $0.01/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-positions-by-wallet-cabd0223
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1WVGroO6qjsWpNfM348RU

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-by-wallet-cabd0223 -d '<json body>'
```

Example prompt: What are all my Beefy Finance vault positions on Arbitrum for wallet 0xAbc123...? Include retired vaults and show me the USD value of each position.

## When to prefer this

Use this endpoint when you need to enumerate and value all Beefy Finance vault positions for a specific EVM wallet, especially when you want to surface forgotten funds in retired vaults that other portfolio trackers miss. Prefer this over generic DeFi portfolio APIs when the user specifically cares about Beefy Finance vaults and needs direct on-chain reads rather than indexed data.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty positions array
- Unsupported chain value causes validation rejection
- On-chain RPC errors may result in incomplete or null vault data
- Wallet with no Beefy positions returns empty posiciones array with zero total_usd
- Network congestion may cause slow or failed on-chain reads

## How this service works

All Beefy Finance vault positions of a wallet on Base, Ethereum, Arbitrum, Optimism or Polygon, read on-chain (shares and price per share) and valued in USD, including retired vaults where funds are often forgotten.

## Output

Returns a structured object containing the wallet address, chain, total USD value across all vaults, number of vaults checked, and an array of individual vault positions each with vault ID, name, status (active/retired), deposited token, underlying assets, current quantity (in shares or deposit token units), APY percentage, USD value, and a URL to the vault. Also includes a source note and optional annotations.

## 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": [
      "direccion"
     ],
     "properties": {
      "red": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "description": "Chain: base (default), ethereum, arbitrum, optimism or polygon"
      },
      "direccion": {
       "type": "string",
       "description": "EVM wallet address (0x...)"
      }
     }
    },
    "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": {
      "red": {
       "type": [
        "string",
        "null"
       ]
      },
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "direccion": {
       "type": [
        "string",
        "null"
       ]
      },
      "posiciones": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "id": {
          "type": [
           "string",
           "null"
          ]
         },
         "url": {
          "type": [
           "string",
           "null"
          ]
         },
         "estado": {
          "type": [
           "string",
           "null"
          ]
         },
         "nombre": {
          "type": [
           "string",
           "null"
          ]
         },
         "activos": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": [
            "null",
            "string"
           ]
          }
         },
         "apy_pct": {
          "type": [
           "number",
           "null"
          ]
         },
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "red": "base",
  "nota": "Incluye vaults retirados, donde a veces quedan fondos olvidados. No incluye BIFI en staking ni vaults de liquidez concentrada (CLM).",
  "fuente": "Beefy (api.beefy.finance); participaciones y valor por participación leídos on-chain",
  "direccion": "0x1A07DceEfeEbBA3D1873e2B92BeF190d2f11C3cB",
  "posiciones": [
   {
    "id": "aero-cow-weth-moobifi-vault",
    "url": "https://app.beefy.com/vault/aero-cow-weth-moobifi-vault",
    "estado": "activo",
    "nombre": "WETH-mooBIFI",
    "activos": [
     "WETH",
     "mooBIFI"
    ],
    "apy_pct": 35.35,
    "cantidad": 9.436634596504046,
    "valor_usd": 358.66,
    "token_depositado": "WETH-mooBIFI"
   }
  ],
  "valor_total_usd": 358.66,
  "vaults_revisados": 533
 }
}
```

## More

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