Get complete portfolio including wallet holdings and DeFi protocol positions across 20+ blockchains. Returns token balances, values, and protocol positions. Waits for a fresh sync by default. Costs 1 credit per address.

Get wallet holdings only (excludes DeFi protocols). Returns token balances and values across all chains. Costs 1 credit per address.

Get total net worth (NAV) in specified currency. Supports USD, EUR, GBP, JPY, CNY, ETH, BTC. Costs 1 credit per address.

Get aggregated token distribution across all chains. Shows which tokens you hold, their values, and percentage breakdown. Costs 1 credit per address.

Get a single EVM address's portfolio valued at a specific block on ethereum, linea or monad, with every balance and price as of that block. Requires the Portfolio at Block add-on. Costs 1 credit.

Query transaction history with filtering and pagination. Filter by chain, type, protocol, counterparty, text search, NFT token ID, and date range, and hide spam or dust. Max 250 transactions per request. Costs 1 credit per address.

Manually trigger transaction synchronization for addresses. Forces immediate indexing of latest transactions. Costs 1 credit per address.

Get portfolio snapshot for a specific date in the past. Shows holdings and values at that point in time. Costs 1 credit per address.

Subscribe to automatic portfolio snapshots. Enables historical tracking. Costs 1200 credits. API expects addresses with optional descriptions.

Check synchronization status of addresses across all chains. Shows which chains are synced and last sync time. FREE - no credits required.

Check API credit balance, usage, and remaining credits. FREE - no credits required.

List every chain Octav supports, with its key (used by chain filters in other tools), name, chain id, and whether portfolio and transactions are supported. FREE - no credits required.

List the DeFi protocols Octav tracks on a chain, with their keys (used by the protocol filter on octav_get_transactions). Paginated; the response says whether more pages exist. FREE - no credits required.

Identify the DeFi protocol a contract address belongs to, such as a spender from octav_get_approvals or a transaction counterparty. With a chain it returns { protocol }; without one it returns { protocols } for every chain the address is known on. Costs 5 credits, refunded if no protocol is found.

Check airdrop eligibility for Solana address. Shows eligible airdrops with claim links. Solana addresses only. Costs 1 credit.

Get Polymarket prediction market positions for address. Shows active positions, values, and P&L. Costs 1 credit.

Get wallet holdings using x402 payment protocol. For AI agents with automatic payment. Returns wallet balances and values. Costs paid via HTTP 402 payment protocol.

Get full portfolio using x402 payment protocol. For AI agents with automatic payment. Returns wallet + DeFi positions. Costs paid via HTTP 402 payment protocol.

Get the ERC-20 token approvals (allowances) a wallet has granted to spender contracts on one chain. Paginated: pass the returned cursor to get the next page; there are no more pages when it is absent or null. Costs 1 credit.

List the virtual users on the account (balance-tracking or CEX-linked accounts managed in Octav Pro), with their virtual: address, type, and label. Requires Pro. Costs 1 credit.

Get portfolios for virtual users, using the virtual: addresses from octav_list_virtual_users. Same shape as octav_get_portfolio; set aggregated for one combined portfolio. Waits for a fresh sync by default. Requires Pro. Costs 1 credit per address.

List every address saved in the account address book (the same list shown in Octav Pro), with its label, plan (FREE, LITE, PRO), plan expiry, and whether the plan is paid. Costs 1 credit.

Save addresses (EVM, Solana, Starknet, or Tron) to the address book, each with an optional label. An address already in the book keeps its existing label; use octav_rename_address_book_entry to change it. Accounts without a paid plan can save up to 50 addresses. Returns the full address book. Costs 1 credit.

Change the label on an address already in the address book, replacing the current one. Pass an empty string to clear the label. Requires confirm: true. Costs 1 credit.

Remove an address from the address book. Entries on a paid plan or authorized by the wallet owner cannot be removed through the API; they must be removed in Octav Pro. Requires confirm: true. Costs 1 credit.

List every bundle (a named group of address book addresses, as in Octav Pro) with its id, name, and addresses. Pass a bundle's addresses to octav_get_portfolio to see its holdings. Costs 1 credit.

Get one bundle by id, with its name and addresses. Use octav_list_bundles to find bundle ids. Costs 1 credit.

Create a named bundle from addresses that are already in the address book (save them first with octav_add_address_book_entries). Names must be unique (case-sensitive), a bundle cannot be empty, and no two bundles may hold exactly the same addresses. Default limits are 5 bundles and 10 addresses per bundle. Bundles created through the API are private. Costs 1 credit.

Rename a bundle, replacing its current name. Names must be unique (case-sensitive). Requires confirm: true. Costs 1 credit.

Delete a bundle. Its addresses stay in the address book. Requires confirm: true. Costs 1 credit.

Add one address to a bundle. The address must already be in the address book. Returns the updated bundle. Costs 1 credit.

Remove one address from a bundle; it stays in the address book. A bundle cannot be emptied, so to remove its last address delete the bundle instead. Requires confirm: true. Returns the updated bundle. Costs 1 credit.