{"uid":"cap_qzARjhNLy0yp26_st2rJa","slug":"wallet-address-risk-lookup-for-evm-eth-chains-a9a9b669","name":"Wallet Address Risk Lookup for EVM/ETH Chains","description":"Pay-per-request identity, risk, authorization, execution-preflight and evidence APIs for autonomous agents.","url":"https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/lookup","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":["chain","address"],"properties":{"chain":{"enum":["ETH"],"type":"string","description":"Chain namespace for the address. Current hosted feed supports ETH/EVM labels."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet or contract address to screen."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"hit":{"type":"boolean"},"chain":{"type":"string"},"labels":{"type":"array"},"address":{"type":"string"},"dataset":{"type":"object"},"product":{"type":"string"},"provenance":{"type":"object"},"risk_level":{"type":"string"},"risk_score":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"hit":false,"chain":"ETH","labels":[],"address":"0x94f751f04b98507d31b500b7ed50be68a1514873","product":"public-wallet-risk-lookup","provenance":{"batch_key":"2026-W27","source_keys":[],"source_count":0,"manifest_sha256":"sha256:example"},"risk_level":"none","risk_score":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JyxXXF-u8KV83QQ6AmA7m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up the risk score, risk level, and sanction/fraud labels for an Ethereum wallet or contract address on the ETH/EVM chain.","exampleAgentPrompt":"Before my agent pays that ETH address 0x94f751f04b98507d31b500b7ed50be68a1514873, can you check its risk score and whether it has any sanction or fraud labels on the ETH chain?","exampleUseCases":[{"title":"Pre-payment wallet sanction check","prompt":"I'm about to send funds to 0xAbC1234567890abcdef1234567890abcdef123456 on ETH — can you screen it for any risk flags or sanction labels before I proceed?"},{"title":"DeFi contract address vetting","prompt":"Before my agent interacts with the contract at 0xDEADBEEFdeadbeefdeadbeefdeadbeefdeadbeef on ETH, look up whether it has any known exploit or fraud labels."},{"title":"x402 API seller address review","prompt":"An x402 marketplace is asking my agent to pay 0x1111111111111111111111111111111111111111 on ETH — what's the risk level and are there any labels attached to that address?"}],"resultDescription":"Returns a JSON object with: a boolean 'hit' indicating whether any risk signals were found, the queried 'address' and 'chain', a 'risk_score' (numeric), a 'risk_level' string (e.g. 'none', 'low', 'high'), an array of 'labels' listing any sanction/fraud/exploit tags, 'product' identifier, and 'provenance' metadata including batch key, source keys, source count, and a manifest SHA256 hash for auditability.","failureModes":["Invalid address format (not matching 0x + 40 hex chars) returns a validation error","Unsupported chain value (only ETH currently supported) returns an enum error","Address not found in dataset returns hit=false with empty labels (not an error)","Service unavailable on Cloudflare Workers returns 5xx","Missing required query parameters (chain or address) returns 400","Payment not completed (x402 protocol failure) prevents access to the endpoint"],"whenToPreferThis":"Choose this endpoint when you need a fast, low-cost ($0.10 USDC) on-chain risk and sanction label lookup for an EVM/ETH address before authorizing a payment or interaction. It is specifically suited for x402 purchase governance flows where an AI agent must preflight-check a seller or counterparty address. Prefer this over generic KYC APIs when you need blockchain-native risk scoring with provenance metadata and batch audit trails.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T16:28:34.339Z","isFirstParty":false}