{"uid":"cap_35XrL9rD6qyP5KsMgFrm7","slug":"bcs-wallet-overview-via-x402-preflight-9f0f11a1","name":"BCS Wallet Overview via x402 Preflight","description":"Machine-payable service intelligence for discovering, verifying, and monitoring identity, risk, authorization, execution-preflight, and evidence APIs before autonomous agents spend.","url":"https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/wallet-overview","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["blockchain","address"],"properties":{"address":{"type":"string","pattern":"^[A-Za-z0-9:_-]{3,128}$","description":"Address to summarize."},"symbols":{"type":"string","pattern":"^[A-Za-z0-9,._-]{1,240}$","description":"Optional comma-separated asset symbols to include."},"contracts":{"type":"string","pattern":"^[A-Za-z0-9,:._-]{1,1000}$","description":"Optional comma-separated token contracts to include."},"blockchain":{"type":"string","pattern":"^[a-z0-9_-]{2,32}$","description":"BlockchainSecurity chain slug."},"output_asset":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,40}$","description":"Optional output asset for valuation where supported."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["product","upstream_service","upstream_response"],"properties":{"product":{"type":"string"},"request":{"type":"object"},"provenance":{"type":"object"},"upstream_headers":{"type":"object"},"upstream_service":{"type":"string"},"upstream_response":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"product":"bcs-wallet-overview","upstream_headers":{"request_id":"example-request-id","credit_cost":null,"credit_remaining":null},"upstream_service":"blockchainsecurity-atlantis","upstream_response":{"data":{},"meta":{"request_id":"example-request-id"}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6nSR16yTwPIfKHSby_eXa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a blockchain wallet summary (balances, assets, valuations) for a given address and chain, proxied through an x402-gated preflight service.","exampleAgentPrompt":"Give me a wallet overview for address 0xABC123... on the ethereum chain, and include valuations in USDC so I can see the full balance breakdown.","exampleUseCases":[{"title":"Agent pre-purchase wallet audit","prompt":"Before buying that x402 dataset, check the wallet overview for 0xDEF456... on base and make sure it has enough USDC and the right assets to cover the purchase."},{"title":"Portfolio snapshot for DeFi agent","prompt":"Pull a full wallet summary for address cosmos1xyz... on the osmosis chain, including all token balances, so I can see what we're working with before rebalancing."},{"title":"On-chain holdings check for compliance","prompt":"Get me the asset breakdown for wallet 0x789GHI... on the polygon chain, filtering to just USDC and WETH, so I can review the holdings."}],"resultDescription":"Returns a JSON object with the product identifier ('bcs-wallet-overview'), upstream service name, request metadata (request_id, credit_cost, credit_remaining), and the upstream response containing a 'data' object with wallet holdings and a 'meta' block with the request ID. The data block includes asset balances, token compositions, and optional valuations for the queried address on the specified blockchain.","failureModes":["Missing required 'blockchain' or 'address' query parameters returns a validation error","Invalid address format (not matching pattern ^[A-Za-z0-9:_-]{3,128}$) causes a 400 rejection","Unsupported or misspelled chain slug causes upstream lookup failure","Upstream BlockchainSecurity Atlantis service unavailability yields a 502 or timeout","Payment not provided or insufficient USDC balance results in x402 payment-required response","Invalid token contract format in 'contracts' parameter causes a parse error"],"whenToPreferThis":"Choose this endpoint when you need a structured, aggregated wallet overview for a specific blockchain address, especially within an x402 agent-commerce context where you need to verify buyer wallet composition before a purchase. Prefer it over raw RPC calls when you want normalized asset summaries with optional valuation in a target asset, and when operating within the BlockchainSecurity Atlantis data ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:54:39.336Z","isFirstParty":false}