{"uid":"cap_biN5QPyziO4i2ZJie4jVk","slug":"code402-erc-20-token-chain-data-e1e59b8f","name":"code402 ERC-20 Token Chain Data","description":"Deterministic compliance verification (IBAN, sanctions, onchain address) with XDR-1 signed receipts, plus Ethereum chain-data endpoints. Paid per call via x402 on Base (USDC).","url":"https://verify.code402.dev/v1/chain/erc20/%7Btoken%7D/%7Baddress%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object"}}},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"result":"string","network":"ethereum-mainnet"}}}}},"responseSchema":{"type":"json","example":{"result":"chain data","network":"ethereum"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SfoP_BXSQNkGeh9MtqbeE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain ERC-20 token data for a specific token contract and address on Ethereum, returning chain data with a signed receipt, paid per call via x402 on Base (USDC).","exampleAgentPrompt":"Can you look up the on-chain ERC-20 token data for the USDC contract (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and my wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?","exampleUseCases":[{"title":"Verify wallet token holdings","prompt":"What's the current on-chain USDC balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum? Use the ERC-20 chain data lookup for the USDC token contract."},{"title":"Compliance check for token transfers","prompt":"I need to verify what ERC-20 token balance the address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e holds for the DAI contract before approving a large transfer — can you pull that on-chain data?"},{"title":"DeFi portfolio audit","prompt":"Pull the on-chain data for the WETH token contract and the address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B so I can audit their holdings for my DeFi report."}],"resultDescription":"Returns a JSON object with a 'result' field containing the ERC-20 token chain data (such as balance or token metadata) for the given token contract and address, along with a 'network' field identifying the chain (e.g. 'ethereum'). Responses include an XDR-1 signed receipt for auditability.","failureModes":["Invalid token contract address returns an error or empty result","Invalid or malformed Ethereum wallet address returns a 400-level error","Token contract does not exist on the specified network, returning no data","Payment failure via x402 protocol results in 402 Payment Required before data is returned","RPC node downtime or Ethereum network congestion may cause delayed or failed responses"],"whenToPreferThis":"Choose this endpoint when you need deterministic, auditable on-chain ERC-20 token data for a specific token and wallet address on Ethereum, especially when a signed XDR-1 receipt is required for compliance or audit purposes. It is best suited for per-call, pay-as-you-go queries via x402 on Base (USDC) where you need a tamper-evident record of the query result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:41:44.790Z","isFirstParty":false,"canonicalSlug":"code402-erc-20-token-chain-data-e1e59b8f"}