{"slug":"x402-gateway-blackwoodstate8-workers-dev-v1-wallet-portfolio-9ebfbd","title":"Use when you need a multi-chain wallet balance, a wallet portfolio or the recent","host":"x402-gateway.blackwoodstate8.workers.dev","method":"POST","resource":"https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-portfolio","category":"market","description":"Use when you need a multi-chain wallet balance, a wallet portfolio or the recent transaction history of an address 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 wallet's native and major-","price_listed":0.005,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":3,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"address":"0xFf918CFB0690FdEd4224DBDab916F6E6F78882b7","chains":["base"],"historyLimit":2},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"description":"Wallet address: 0x... for Ethereum and Base, or a Solana address, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","maxLength":44,"minLength":32,"type":"string"},"chains":{"description":"Chains to read (ethereum and base for a 0x address, solana for a Solana address, when omitted), e.g. [\"base\"]","items":{"enum":["ethereum","base","solana"],"type":"string"},"maxItems":3,"minItems":1,"type":"array"},"historyLimit":{"description":"Latest transfers to return per chain, 0 to 25 (10 when omitted), e.g. 5","maximum":25,"minimum":0,"type":"integer"}},"required":["address"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"address":{"type":"string"},"base":{"anyOf":[{"additionalProperties":false,"properties":{"history":{"items":{"additionalProperties":false,"properties":{"amount":{"type":"string"},"asset":{"type":"string"},"counterparty":{"type":["string","null"]},"direction":{"enum":["in","out","self"],"type":"string"},"hash":{"type":"string"},"time":{"type":["string","null"]}},"required":["hash","time","direction","counterparty","asset","amount"],"type":"object"},"type":"array"},"native":{"additionalProperties":false,"properties":{"balance":{"type":"string"},"symbol":{"type":"string"}},"required":["symbol","balance"],"type":"object"},"tokens":{"items":{"additionalProperties":false,"properties":{"balance":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"number"},"symbol":{"type":"string"}},"required":["symbol","contract","decimals","balance"],"type":"object"},"type":"array"}},"required":["native","tokens","history"],"type":"object"},{"type":"null"}]},"ethereum":{"anyOf":[{"additionalProperties":false,"properties":{"history":{"items":{"additionalProperties":false,"properties":{"amount":{"type":"string"},"asset":{"type":"string"},"counterparty":{"type":["string","null"]},"direction":{"enum":["in","out","self"],"type":"string"},"hash":{"type":"string"},"time":{"type":["string","null"]}},"required":["hash","time","direction","counterparty","asset","amount"],"type":"object"},"type":"array"},"native":{"additionalProperties":false,"properties":{"balance":{"type":"string"},"symbol":{"type":"string"}},"required":["symbol","balance"],"type":"object"},"tokens":{"items":{"additionalProperties":false,"properties":{"balance":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"number"},"symbol":{"type":"string"}},"required":["symbol","contract","decimals","balance"],"type":"object"},"type":"array"}},"required":["native","tokens","history"],"type":"object"},{"type":"null"}]},"next":{"additionalProperties":false,"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","properties":{"method":{"enum":["GET","POST"],"type":"string"},"sample":{"description":"Free fixed sample of the whole family","type":"string"},"service":{"description":"Service id of the suggested next paid call","type":"string"},"tool":{"description":"MCP tool name of the same call","type":"string"},"url":{"description":"Paid route of the next call","type":"string"},"useWhen":{"description":"When the next call is the right one","type":"string"}},"required":["service","tool","method","url","useWhen","sample"],"type":"object"},"note":{"type":"string"},"solana":{"anyOf":[{"additionalProperties":false,"properties":{"history":{"items":{"additionalProperties":false,"properties":{"amount":{"type":"string"},"asset":{"type":"string"},"counterparty":{"type":["string","null"]},"direction":{"enum":["in","out","self"],"type":"string"},"hash":{"type":"string"},"time":{"type":["string","null"]}},"required":["hash","time","direction","counterparty","asset","amount"],"type":"object"},"type":"array"},"native":{"additionalProperties":false,"properties":{"balance":{"type":"string"},"symbol":{"type":"string"}},"required":["symbol","balance"],"type":"object"},"tokens":{"items":{"additionalProperties":false,"properties":{"balance":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"number"},"symbol":{"type":"string"}},"required":["symbol","contract","decimals","balance"],"type":"object"},"type":"array"}},"required":["native","tokens","history"],"type":"object"},{"type":"null"}]},"updatedAt":{"type":"string"}},"required":["address","ethereum","base","solana","updatedAt","note"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Use when you need a multi-chain wallet balance, a wallet portfolio or the recent transaction history of an address 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 wallet's native and major-token balances on Ethereum, Base or Solana plus its latest transfers in and out, in one call, leaving airdrop spam out for 0.005 USDC per call. Typical response time 3000 ms (p95). Category: Data.","last_updated":"2026-10-18T15:25:08.95Z","schemes":["exact","upto"]}