{"uid":"cap_435s01tTxqlIwCNtnE558","slug":"wallet-portfolio-token-balances-erc20-multi-chain-b4a0b360","name":"Wallet Portfolio Token Balances (ERC20, Multi-Chain)","description":"Curated ERC20 token balances across high-volume EVM chains with D1-backed historical wallet snapshots and source coverage. Price 0.15 USDC on Base via x402. Demo: https://wallet-portfolio-history-mcp.mtree.workers.dev/demo/tools/token_balances. Contact: https://wallet-portfolio-history-mcp.mtree.workers.dev/contact.","url":"https://wallet-portfolio-history-mcp.mtree.workers.dev/tools/token_balances","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"limit":{"type":"integer","maximum":50,"minimum":1},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"refresh":{"type":"boolean"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"body":{"chain":"ethereum","limit":10,"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"type":"http","method":"POST","bodyType":"json"}},"response":{"ok":true,"chain":"ethereum","route":"/tools/token_balances","result":{"token_balances":[{"error":"HTTP request failed.\n\nStatus: 521\nURL: https://eth.llamarpc.com/\nRequest body: {\"method\":\"eth_call\",\"params\":[{\"data\":\"0","symbol":"USDC","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","decimals":6},{"error":"HTTP request failed.\n\nStatus: 521\nURL: https://eth.llamarpc.com/\nRequest body: {\"method\":\"eth_call\",\"params\":[{\"data\":\"0","symbol":"WETH","address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","decimals":18},{"error":"HTTP request failed.\n\nStatus: 521\nURL: https://eth.llamarpc.com/\nRequest body: {\"method\":\"eth_call\",\"params\":[{\"data\":\"0","symbol":"DAI","address":"0x6B175474E89094C44Da98b954EedeAC495271d0F","decimals":18}]},"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","service":"wallet-portfolio-history-mcp","freshness_score":75,"source_coverage":{"rpc_native_balance":false,"dataset_writes_to_d1":true,"curated_erc20_balances":3,"protocol_watchlist_size":3,"rpc_native_balance_error":"HTTP request failed.\n\nStatus: 521\nURL: https://eth.llamarpc.com/\nRequest body: {\"method\":\"eth_getBalance\",\"params\":[\"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\"latest\"]}\n\nDetails","transaction_history_source":"blockscout","curated_defi_receipt_tokens":3,"transaction_history_supported":false},"dataset_fresh_at":"2026-06-16T18:48:02.000Z"}},"exampleRequest":{"chain":"ethereum","limit":10,"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ohQM0ZTJAAfA8I1OY0u2v","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns curated ERC20 token balances for a wallet address across high-volume EVM chains, with D1-backed historical snapshots and source coverage metadata.","exampleAgentPrompt":"Pull the current ERC20 token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 across all major EVM chains and show me the full token list with amounts.","exampleUseCases":null,"resultDescription":"A curated list of ERC20 token balances held by the queried wallet across high-volume EVM chains, enriched with token metadata (symbol, amount, chain), historical D1-backed snapshot data, and source coverage details indicating where balance data was sourced from.","failureModes":["Invalid or malformed wallet address returns an error response","Unsupported chain yields empty or partial results","Payment failure (x402 USDC not authorized) blocks the request","Wallet with no ERC20 activity returns empty token list","D1 snapshot stale or unavailable may return outdated balances"],"whenToPreferThis":"Choose this endpoint when you need a curated, multi-chain ERC20 token balance snapshot for a specific wallet — especially when historical comparison, source provenance, or coverage metadata is important. Prefer this over raw on-chain RPC calls when you need normalized, enriched data ready for downstream wallet diligence or risk analysis workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:00.133Z","isFirstParty":false}