{"uid":"cap_S9u6KA5vsHViddFp0lMoU","slug":"orcpin-wallet-snapshot-fcf83f9e","name":"Orcpin Wallet Snapshot","description":"On-chain wallet snapshot on Base: native ETH and tracked ERC-20 token balances (USDC, WETH) plus account flags (contract status, transaction count) and derived metrics (wallet type, activity tier, gas runway), anchored to a specific block. Factual wallet balance and holdings lookup for AI agents — portfolio and on-chain data API.","url":"https://orcpin.dev/v1/wallet-snapshot?utm_source=zero.xyz","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":["address"],"properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EVM wallet address to snapshot (0x...)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object"},"address":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"},"block_number":{"type":"integer"},"schema_version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"account":{"is_contract":false,"transaction_count":42},"native_balance":{"wei":"1000000000000000","symbol":"ETH","formatted":"0.001"},"token_balances":[{"raw":"1000000","symbol":"USDC","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"formatted":"1.0"}]},"as_of":"block","chain":"Base","address":"0x0000000000000000000000000000000000000001","sources":["public_rpc","on_chain_read"],"chain_id":8453,"timestamp":"2026-06-18T12:00:00.000Z","disclaimer":"Informational snapshot. See /terms.","block_number":12345678,"schema_version":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KgGJO7ViU-nU-tv3vMgE4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a block-anchored on-chain snapshot of an EVM wallet's balances and account metadata on Base, including native ETH and ERC-20 token holdings.","exampleAgentPrompt":"Can you pull a block-anchored snapshot of the wallet 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to see its ETH balance, any ERC-20 tokens it holds, and whether it's a contract?","exampleUseCases":null,"resultDescription":"A JSON object with the wallet's native ETH balance (in wei and formatted), an array of ERC-20 token balances (symbol, contract address, formatted amount), account metadata (is_contract flag, transaction count), the Base chain ID (8453), the specific block number the snapshot was taken at, a UTC timestamp, and a disclaimer. Data is sourced from public RPC and on-chain reads.","failureModes":["Invalid or malformed address (not a 0x-prefixed 40-hex-char string) returns a validation error","Address not found or zero-activity wallet returns an empty balance snapshot","Payment not received or x402 payment header missing/invalid results in 402 Payment Required","RPC node unavailability or Base network congestion may cause timeout or stale data","Chain reorganization may cause block number to be slightly behind tip"],"whenToPreferThis":"Choose this endpoint when you need a factual, block-anchored on-chain read of a Base wallet's token and ETH balances — especially in agent workflows where auditability and block provenance matter. Prefer it over generic blockchain explorers when you need structured JSON output suitable for downstream computation, and when you need both native and ERC-20 balances in a single call on Base (chainId 8453).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:35:26.389Z","isFirstParty":false,"canonicalSlug":"orcpin-wallet-snapshot-fcf83f9e"}