{"uid":"cap_beuAqX2O-KJNxvqVbq-a8","slug":"base-onchain-tools-address-check-38ef3555","name":"Base Onchain Tools – Address Check","description":"Eleven read-only endpoints answering questions about Base mainnet that are tedious to assemble from raw RPC: what an unverified contract is actually able to do, whether a token transfer will revert and for what reason, what an arbitrary token is worth, and whether an address is safe to pay. Priced $0.001-$0.04 per call in USDC over x402. No account, no API key, no signup, no minimum, no rate limit to negotiate — the payTo address in the 402 response is the whole integration. Failed calls are not billed. The payment middleware cancels settlement on any 4xx or 5xx, so a malformed parameter or an upstream outage costs nothing. Answers are read live from Base mainnet at request time, with failover across five independent RPC providers. A batch that comes back incomplete is treated as a failure rather than returned with the missing entries as zeros, because a confident wrong answer costs a caller more than an error does. Scope is deliberately narrow: Base mainnet only, reads only, no keys held, nothing stored between requests.","url":"https://base-onchain-tools.dolerite.workers.dev/v1/base/address-check","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","description":"Base mainnet address (0x-prefixed, 20 bytes)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","verdict":"caution","is_contract":true}},"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_bGxDi42H00IvTZ0h8FHZ2","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":"Returns a safety verdict and contract status for a given Base mainnet address, indicating whether it is safe to pay or interact with.","exampleAgentPrompt":"Before I send payment, can you check whether the Base address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 is safe to interact with — is it a contract, and does it get a clean verdict?","exampleUseCases":[{"title":"Pre-payment safety check","prompt":"I'm about to send USDC to 0x1234567890abcdef1234567890abcdef12345678 on Base — can you run a quick safety check on that address and tell me if it looks trustworthy before I confirm the transaction?"},{"title":"Contractor wallet verification","prompt":"A freelancer just gave me their Base wallet address 0xabcdefabcdefabcdefabcdefabcdefabcdefabcd for payment — can you verify it's a normal EOA and not flagged as suspicious?"},{"title":"DeFi contract due diligence","prompt":"I want to know if the Base address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 is a contract and whether the safety verdict is clean before I approve it as a token recipient in my app."}],"resultDescription":"A JSON object containing the queried address, a verdict field (e.g. 'safe', 'caution', or similar classification), and an is_contract boolean indicating whether the address is a smart contract or externally owned account. Data is read live from Base mainnet with failover across five RPC providers. Incomplete results are treated as errors rather than returned with missing fields.","failureModes":["Invalid or malformed address (not 0x-prefixed or not 20 bytes) — 4xx error, no charge","RPC provider outage causing incomplete data — treated as failure, no charge","Address not found or never used on Base mainnet — may return limited verdict","Network congestion causing timeout — error returned, not billed"],"whenToPreferThis":"Choose this endpoint when you need a fast, pay-per-call safety verdict on a Base mainnet address with no API key or account setup. Ideal for agents making payment decisions, onboarding external addresses, or performing due diligence before token transfers. Prefer over raw RPC when you want an aggregated safety signal rather than raw chain data, and when cost-certainty matters (failed calls are free).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:48.301Z","isFirstParty":false}