{"service":"wallet-balances","version":"1.0.0","title":"Wallet balances on Base","description":"Use when you need a wallet balance, token balances or the ERC20 balance of an address on Base, read live from the chain. Do not use for ethereum mainnet or other chains, NFTs, transaction history or USD values. Returns JSON with the wallet balance of an address on Base: ETH and ERC20 token balances read on-chain in one block, 21 major tokens plus any you list for 0.003 USDC per call. Typical response time 1200 ms (p95). Category: Data.","paid":{"method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-balances","scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"3000","amountUsdc":"0.003","payTo":"0xbB2F227a85e9F7405614326CeD123230D708DD90","maxTimeoutSeconds":60},"input":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address on Base, e.g. 0x5A6c77758820182484EA8DE614FC65423E80749a"},"tokens":{"description":"Extra ERC20 token addresses on Base to check, e.g. [\"0x4200000000000000000000000000000000000006\"] (up to 20, beyond the 21 major ones)","maxItems":20,"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"includeZero":{"description":"Also list tokens with zero balance (false when omitted)","type":"boolean"}},"required":["address"]},"example":{"address":"0x5A6c77758820182484EA8DE614FC65423E80749a"}},"output":{"schema":{"type":"object","properties":{"address":{"type":"string"},"network":{"type":"string","const":"eip155:8453"},"blockNumber":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"native":{"type":"object","properties":{"symbol":{"type":"string","const":"ETH"},"balance":{"type":"string"},"raw":{"type":"string"}},"required":["symbol","balance","raw"],"additionalProperties":false},"tokens":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"symbol":{"type":["string","null"]},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"balance":{"type":"string"},"raw":{"type":"string"}},"required":["token","symbol","decimals","balance","raw"],"additionalProperties":false}},"notTokens":{"type":"array","items":{"type":"string"}},"checkedTokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next":{"type":"object","properties":{"service":{"type":"string","description":"Service id of the suggested next paid call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"type":"string","enum":["GET","POST"]},"url":{"type":"string","description":"Paid route of the next call"},"useWhen":{"type":"string","description":"When the next call is the right one"},"sample":{"type":"string","description":"Free fixed sample of the whole family"}},"required":["service","tool","method","url","useWhen","sample"],"additionalProperties":false,"description":"Suggested next paid call in the same family (call it in a loop when the task continues)"}},"required":["address","network","blockNumber","native","tokens","notTokens","checkedTokens"],"additionalProperties":false},"example":{"address":"0x5A6c77758820182484EA8DE614FC65423E80749a","network":"eip155:8453","blockNumber":52713897,"native":{"symbol":"ETH","balance":"0","raw":"0"},"tokens":[{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","decimals":6,"balance":"0.01","raw":"10000"}],"notTokens":[],"checkedTokens":21}},"mcp":{"url":"https://x402-gateway.blackwoodstate8.workers.dev/mcp","tool":"blackwood_wallet_balances"},"openapi":"https://x402-gateway.blackwoodstate8.workers.dev/openapi.json","status":"https://x402-gateway.blackwoodstate8.workers.dev/status.json"}