{"uid":"cap_jX7cvKJZGb75pjhbcVhhj","slug":"soren-chain-code-inspector-0e921df0","name":"Soren Chain Code Inspector","description":"Read whether an address is a contract, and its code size, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable.","url":"https://soren.com/v1/chain/code","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","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","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"The 0x… address to inspect."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SC4EBgg7BQQScDYMOC5ch","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads whether an Ethereum/Base address is a contract and returns its bytecode size, live from Base mainnet, charged per successful call via x402.","exampleAgentPrompt":"Can you check whether 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 is a smart contract or a regular wallet on Base mainnet, and if it is a contract, what's its code size?","exampleUseCases":[{"title":"Validate contract before DeFi interaction","prompt":"Before I interact with 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base, can you confirm it's actually a deployed smart contract and not just a wallet address?"},{"title":"Detect EOA vs contract for airdrop filtering","prompt":"I have the address 0x4200000000000000000000000000000000000006 — is it a contract or an externally owned account on Base mainnet? I need to filter it for my airdrop list."},{"title":"Audit contract deployment size","prompt":"What's the bytecode size of the contract at 0x2626664c2603336E57B271c5C0b26F421741e481 on Base? I want to know how large the deployed code is."}],"resultDescription":"Returns whether the given address has deployed contract code (true/false), the size of the bytecode in bytes, and the block number at which the read was taken from Base mainnet. If the address is an EOA, code size will be zero.","failureModes":["Invalid or malformed address format returns an error","Address not found or network connectivity issues may return an error","Payment failure (insufficient USDC balance or x402 rejection) means no charge and no result","Call only succeeds and charges if the read completes — failed reads are not billed"],"whenToPreferThis":"Use this endpoint when you need a live, real-time check of whether a Base mainnet address is a smart contract, without setting up an API key or account. Prefer it over full node RPC setups or general blockchain explorers when you want pay-per-use, frictionless access with block-stamped results. If you also need attestation/signing of the result, use the /v1/oracle/onchain variant instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:37:45.393Z","isFirstParty":false}