{"uid":"cap_R5XOIUI9wzx6T7KM-ZSP0","slug":"multi-chain-wallet-portfolio-transaction-history-b1f88ecc","name":"Multi-Chain Wallet Portfolio & Transaction History","description":"Use when you need a multi-chain wallet balance, a wallet portfolio or wallet transaction history on Ethereum, Base or Solana. Do not use for uSD values, NFTs, DeFi positions, long-tail tokens or chains beyond Ethereum, Base and Solana. Returns JSON with a multi-chain wallet balance and transaction history: native and major-token balances on Ethereum, Base or Solana plus the latest transfers, without airdrop spam for 0.005 USDC per call. Typical response time 3000 ms (p95). Category: Data.","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-portfolio?utm_source=zero.xyz","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":{"chains":{"type":"array","items":{"enum":["ethereum","base","solana"],"type":"string"},"maxItems":3,"minItems":1,"description":"Chains to read (ethereum and base for a 0x address, solana for a Solana address, when omitted), e.g. [\"base\"]"},"address":{"type":"string","maxLength":44,"minLength":32,"description":"Wallet address: 0x... for Ethereum and Base, or a Solana address, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"historyLimit":{"type":"integer","maximum":25,"minimum":0,"description":"Latest transfers to return per chain, 0 to 25 (10 when omitted), e.g. 5"}}},"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","required":["address","ethereum","base","solana","updatedAt","note"],"properties":{"base":{"anyOf":[{"type":"object","required":["native","tokens","history"],"properties":{"native":{"type":"object","required":["symbol","balance"],"properties":{"symbol":{"type":"string"},"balance":{"type":"string"}},"additionalProperties":false},"tokens":{"type":"array","items":{"type":"object","required":["symbol","contract","decimals","balance"],"properties":{"symbol":{"type":"string"},"balance":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"number"}},"additionalProperties":false}},"history":{"type":"array","items":{"type":"object","required":["hash","time","direction","counterparty","asset","amount"],"properties":{"hash":{"type":"string"},"time":{"type":["string","null"]},"asset":{"type":"string"},"amount":{"type":"string"},"direction":{"enum":["in","out","self"],"type":"string"},"counterparty":{"type":["string","null"]}},"additionalProperties":false}}},"additionalProperties":false},{"type":"null"}]},"next":{"type":"object","required":["service","tool","method","url","useWhen","sample"],"properties":{"url":{"type":"string","description":"Paid route of the next call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"enum":["GET","POST"],"type":"string"},"sample":{"type":"string","description":"Free fixed sample of the whole family"},"service":{"type":"string","description":"Service id of the suggested next paid call"},"useWhen":{"type":"string","description":"When the next call is the right one"}},"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","additionalProperties":false},"note":{"type":"string"},"solana":{"anyOf":[{"type":"object","required":["native","tokens","history"],"properties":{"native":{"type":"object","required":["symbol","balance"],"properties":{"symbol":{"type":"string"},"balance":{"type":"string"}},"additionalProperties":false},"tokens":{"type":"array","items":{"type":"object","required":["symbol","contract","decimals","balance"],"properties":{"symbol":{"type":"string"},"balance":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"number"}},"additionalProperties":false}},"history":{"type":"array","items":{"type":"object","required":["hash","time","direction","counterparty","asset","amount"],"properties":{"hash":{"type":"string"},"time":{"type":["string","null"]},"asset":{"type":"string"},"amount":{"type":"string"},"direction":{"enum":["in","out","self"],"type":"string"},"counterparty":{"type":["string","null"]}},"additionalProperties":false}}},"additionalProperties":false},{"type":"null"}]},"address":{"type":"string"},"ethereum":{"anyOf":[{"type":"object","required":["native","tokens","history"],"properties":{"native":{"type":"object","required":["symbol","balance"],"properties":{"symbol":{"type":"string"},"balance":{"type":"string"}},"additionalProperties":false},"tokens":{"type":"array","items":{"type":"object","required":["symbol","contract","decimals","balance"],"properties":{"symbol":{"type":"string"},"balance":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"number"}},"additionalProperties":false}},"history":{"type":"array","items":{"type":"object","required":["hash","time","direction","counterparty","asset","amount"],"properties":{"hash":{"type":"string"},"time":{"type":["string","null"]},"asset":{"type":"string"},"amount":{"type":"string"},"direction":{"enum":["in","out","self"],"type":"string"},"counterparty":{"type":["string","null"]}},"additionalProperties":false}}},"additionalProperties":false},{"type":"null"}]},"updatedAt":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"base":{"native":{"symbol":"ETH","balance":"0"},"tokens":[{"symbol":"USDC","balance":"0.015","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6}],"history":[{"hash":"0xeca4b84c7be1b01b92314dd139ba623f4065ea2d9af702cdca1a6e006fc92f09","time":"2026-10-17T23:55:53.000Z","asset":"USDC","amount":"0.005","direction":"in","counterparty":"0x87db3c25d1e8e40f8ef240d48a711b0c355cf8cf"},{"hash":"0x618c2559d32eef4fa33af283a53db6e96dacd049c22a586a8dc4bc3a603326e4","time":"2026-10-17T23:54:41.000Z","asset":"USDC","amount":"0.005","direction":"in","counterparty":"0x87db3c25d1e8e40f8ef240d48a711b0c355cf8cf"}]},"note":"Balances of the native coin and major tokens of each chain (a fixed list; airdrop spam and long-tail tokens are left out). History: the latest native and major-token transfers in and out; on Solana, the net change per transaction. Amounts are decimal strings in token units, without USD values.","solana":null,"address":"0xFf918CFB0690FdEd4224DBDab916F6E6F78882b7","ethereum":null,"updatedAt":"2026-10-18T02:46:08.863Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hu1gQe-GKRzsWj78zWmWn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native and major-token balances plus recent transfer history for a wallet address on Ethereum, Base, and/or Solana","exampleAgentPrompt":"Can you pull up the token balances and last 10 transfers for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on both Ethereum and Base?","exampleUseCases":[{"title":"Cross-chain portfolio snapshot for a user","prompt":"What are the ETH, USDC, and other token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 across Ethereum and Base?"},{"title":"Recent transfer audit for a Solana wallet","prompt":"Show me the last 5 transactions for Solana address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgHkV — I want to see what moved in or out recently."},{"title":"Agent onboarding wallet check","prompt":"Before we proceed, can you check if wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B has any ETH or USDC balance on Base, and show me its last 3 transfers?"}],"resultDescription":"A JSON object keyed by chain (ethereum, base, solana) each containing: native token symbol and balance, an array of major token balances (symbol, contract, decimals, balance), and a history array of recent transfers (hash, timestamp, direction in/out, counterparty address, asset, amount). Also includes the queried address and an updatedAt timestamp. Airdrop spam is filtered out.","failureModes":["Invalid or malformed wallet address returns an error","Requesting a chain incompatible with the address format (e.g. Solana chain for an 0x address) may return empty or error","historyLimit out of range (>25 or <0) returns a validation error","Network timeouts may occur given ~3000ms p95 latency","Missing required 'address' field returns a schema validation error"],"whenToPreferThis":"Use this endpoint when you need multi-chain native and major-token balances and recent transfer history for a specific wallet on Ethereum, Base, or Solana. Prefer this over general blockchain explorers when you want a clean, spam-filtered JSON response ready for agent consumption. Do not use for USD valuations, NFT holdings, DeFi positions (liquidity, staking), long-tail or obscure token balances, or chains beyond Ethereum, Base, and Solana.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:30:11.939Z","isFirstParty":false,"canonicalSlug":"multi-chain-wallet-portfolio-transaction-history-b1f88ecc"}