Wallet Portfolio API — Pay Per Call with USDC on Base

wallet_portfolio API

Get a complete wallet portfolio for an Ethereum address: native ETH balance, ERC-20 balances, NFT holdings, recent transfers. Part of the x402 Gateway — $0.002 per call, settled in USDC on Base. No accounts, no API keys: agents pay per request via the x402 protocol.

How payment works

Send a POST to https://x402.freeq.one/tools/wallet_portfolio without a payment header and the API replies 402 Payment Required with an x402 challenge (payTo address, USDC amount, Base network). A paying agent signs the USDC payment and retries with the X-PAYMENT header — settlement is verified on-chain in seconds and the API response returns with an X-PAYMENT-RESPONSE receipt.

Example call

curl -X POST https://x402.freeq.one/tools/wallet_portfolio \
  -H "Content-Type: application/json" \
  -d '{"{param}": "{value}"}'

Browse every pay-per-call API on the all APIs page, or inspect the machine-readable service card and OpenAPI spec.