{"uid":"cap_Iw_QeimP3F33Clwnsn2Qu","slug":"x402-address-poisoning-check-base-usdc-889423fb","name":"x402 Address-Poisoning Check (Base USDC)","description":"Address-poisoning check before you send USDC on Base. Body {from, to} (or sender/recipient; chain=base, token=USDC only, others 400 not charged; optional contacts/known_addresses): scans the sender's…","url":"https://paycheck.hectichustle.workers.dev/address/check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Intended recipient (aliases: recipient, toAddress, address). Required in every shape."},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Sender address (aliases: sender, fromAddress). Omit for contacts-only or recipient-only mode."},"chain":{"type":["string","integer"],"description":"Optional. Base only (base, eip155:8453, 8453). Any other chain returns 400 unsupported_chain and is not charged — Shield only scans Base USDC."},"token":{"type":"string","description":"Optional. USDC only (symbol USDC or Base USDC contract). Any other token (e.g. USDT) returns 400 unsupported_token and is not charged."},"contacts":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"maxItems":50,"description":"Optional: up to 50 trusted addresses / address book (aliases: known_addresses, known). With from: offline lookalike of contacts too. Without from: contacts-only mode (no RPC)."}}},"responseSchema":{"type":"json","example":{"to":"0x509e55c4f898b43c856fb0e51048b1b7bfbc9ede","from":"0x9d42eba8868cfd38a50ba615ee0cf903f1bbece9","risk":"low","reasons":["you have paid 'to' before and no lookalikes found"],"coverage":{"complete":false,"rpcCalls":47,"scannedTo":52518176,"coveragePct":38,"scannedFrom":52468176,"windowBlocks":50000,"transfersSeen":19},"lookalikes":[],"seenBefore":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nLpjIeHtpw-hKLWT1zGVk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a recipient Ethereum address is a lookalike/poisoning attack relative to a sender's transaction history, returning a risk level and reasons.","exampleAgentPrompt":"Before I send any USDC, check if 0x509e55c4f898b43c856fb0e51048b1b7bfbc9ede is a safe recipient — my wallet is 0x9d42eba8868cfd38a50ba615ee0cf903f1bbece9 — and tell me if it looks like an address-poisoning lookalike or if I've paid it before.","exampleUseCases":[{"title":"Pre-transfer address safety check","prompt":"I'm about to send USDC to 0xAbC1234... from my wallet 0xDef5678... — can you run a poisoning check to make sure it's not a lookalike scam address before I confirm?"},{"title":"DeFi bot guard against poisoning","prompt":"My trading bot is about to pay out to 0x1111aaa... from 0x2222bbb... — quickly check whether that recipient address could be an address-poisoning attack so we can block the transfer if it's risky."},{"title":"Post-airdrop recipient vetting","prompt":"We just got a batch of withdrawal requests and I want to check one: is 0xDeadBeef... a legit address or could it be a poisoned lookalike of a wallet my account 0xFeedFace... has paid before?"}],"resultDescription":"A JSON object containing: the 'to' and 'from' addresses, a 'risk' field ('low', 'medium', or 'high'), a 'reasons' array explaining the assessment, a 'seenBefore' boolean indicating if the recipient was found in prior transactions, a 'lookalikes' array of any suspicious similar addresses found, and a 'coverage' object describing how many blocks and RPC calls were scanned and what percentage of history was covered.","failureModes":["Invalid Ethereum address format for 'to' or 'from' — returns validation error","Payment not received or insufficient USDC payment — x402 payment required response","RPC rate limits or node unavailability causing partial scan (reflected in coverage.complete=false)","Very new addresses with no history returning low coverage percentage","Network congestion on Base causing slow or timed-out RPC calls"],"whenToPreferThis":"Use this endpoint when you need a fast, low-cost ($0.001) preliminary poisoning check before a USDC transfer on Base, and you don't need full historical coverage (which the sibling full-history endpoint provides at $0.05). Ideal for real-time pre-transfer validation in wallets, bots, or agent workflows where speed matters and a 36% history window scan is sufficient signal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T06:37:34.907Z","isFirstParty":false,"canonicalSlug":"x402-address-poisoning-check-base-usdc-889423fb"}