# Octav PRO – Wallet Holdings Lookup

> Octav PRO – Wallet Holdings Lookup is a paid API for AI agents from api.octav.fi, paid per call via x402, $0.025/call, status unknown (last checked 2026-09-13).

Returns the token and asset holdings currently held in a given blockchain wallet address

## Facts

- Endpoint: GET https://api.octav.fi/v1/agent/wallet
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/octav-pro-wallet-holdings-lookup-8857e9de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xfqYzv9Fp25gGISiMBZGm

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 octav-pro-wallet-holdings-lookup-8857e9de
```

Example prompt: Can you pull up all the token holdings currently sitting in my wallet address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Octav?

## When to prefer this

Use this endpoint when you need a straightforward breakdown of raw wallet token holdings for a specific address — ideal for portfolio snapshots, balance checks, or auditing which tokens are held. Prefer the sibling 'wallet and protocol holdings' endpoint if you also need DeFi protocol positions combined with wallet holdings in a single call. Use this when you only need on-chain token balances without NAV computation or protocol-level breakdown.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Unsupported blockchain or chain not indexed returns empty or error
- Rate limiting or payment failure returns 402 Payment Required
- Address with no on-chain activity may return empty holdings
- Network timeout if the chain data is slow to sync

## How this service works

Monitor crypto portfolios with automated NAV reports, exposure insights, and AI-powered transaction labeling. Octav Pro helps funds and institutions turn digital-asset complexity into clear, compliant reporting.

## Output

A JSON object listing all tokens and assets held in the specified wallet address, including balances and likely valuations for each asset in the portfolio

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "addresses"
     ],
     "properties": {
      "addresses": {
       "type": "string",
       "required": true,
       "description": "The address of the wallet to get the wallet holdings of (EVM or SOLANA)"
      }
     }
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/octav-pro-wallet-holdings-lookup-8857e9de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.octav.fi](https://www.zero.xyz/host/api.octav.fi/llms.txt)