# MoneyTools ERC-4626 Vault Reader

> MoneyTools ERC-4626 Vault Reader is a paid API for AI agents from tools.moneytools.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-05).

Reads on-chain ERC-4626 yield vault metadata including underlying asset, total assets, share price, deposit status, and an optional holder's position.

## Facts

- Endpoint: GET https://tools.moneytools.dev/v1/vault?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-05
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/moneytools-erc-4626-vault-reader-9c87837b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V2hxT8rPf2Bs4Vx83mr9j

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 moneytools-erc-4626-vault-reader-9c87837b
```

Example prompt: Can you pull the vault facts for the ERC-4626 vault at 0xbeeF010f9cb27031ad51e3333f9aF9C6B1228183 on Base — I want to know the underlying asset, total assets, current share price, and whether deposits are open?

## When to prefer this

Use this endpoint when you need on-chain ERC-4626 vault metadata without setting up your own RPC node or writing contract call logic. It is ideal for agents that need to inspect yield vaults across multiple chains (Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche) in a single API call. It's especially useful for checking a user's specific position in a vault alongside vault-level stats. Prefer this over raw RPC calls when you want structured JSON output with payment handled via x402 micropayments.

## Known failure modes

- Invalid or non-ERC-4626 vault address returns an error — the contract may not implement the standard interface
- Unsupported chain name returns a validation error
- Exceeded free tier (10/day) without payment credentials results in HTTP 402 Payment Required
- Network RPC errors or chain congestion may cause timeouts
- Invalid holder address format returns a parameter validation error

## How this service works

ERC-4626 vault reader: Yield vault facts: underlying asset, total assets, share price (assets per share), deposits open, and a holder's position. Free tier 10/day; then $0.002 via x402 (HTTP 402 + PAYMENT-REQUIRED) or X-API-Key credits. Not charged on failure. $0.002 USDC per call via x402 on Base. Run by MoneyTools.

## Output

A JSON object containing the vault's underlying asset address, total assets held, share price expressed as assets-per-share, whether deposits are currently open, and (if a holder address was provided) the holder's share balance and equivalent asset value. Also includes payment metadata indicating whether a charge was made and the transaction hash.

## 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"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain",
      "vault"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "examples": [
        "base"
       ],
       "description": "chain: base, ethereum, arbitrum, optimism, polygon, bsc, avalanche"
      },
      "vault": {
       "type": "string",
       "examples": [
        "0xbeeF010f9cb27031ad51e3333f9aF9C6B1228183"
       ],
       "description": "ERC-4626 vault address"
      },
      "holder": {
       "type": "string",
       "description": "holder address"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "properties": {
      "payment": {
       "type": "object",
       "properties": {
        "charged": {
         "type": "boolean"
        },
        "network": {
         "type": "string"
        },
        "amountUsd": {
         "type": "string"
        },
        "transaction": {
         "type": [
          "string",
          "null"
         ]
        }
       }
      },
      "freeTier": {
       "type": "object"
      },
      "_moneytools": {
       "type": "object",
       "description": "optional plan / partner hints"
      }
     },
     "description": "Tool-specific JSON result (see llms.txt / openapi.json). Always includes payment info.",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/moneytools-erc-4626-vault-reader-9c87837b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.moneytools.dev](https://www.zero.xyz/host/tools.moneytools.dev/llms.txt)