{"uid":"cap_OEaSV2dURpMqXN9Z7GMBT","slug":"x402node-bulk-onchain-address-label-api-6268f208","name":"x402node Bulk Onchain Address Label API","description":"Bulk onchain address labeling: POST up to 50 Base/EVM addresses, returns curated entity labels (CEX hot wallet, DEX router, bridge, stablecoin, lending protocol, plus sanctioned/mixer/scam flags) with tag, name, category, confidence and source. For AI agent due diligence, counterparty screening, automated KYC-lite and payment-routing risk gating. null = address not in the curated label set.","url":"https://api.x402node.dev/wallet/label-bulk?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"addresses":{"type":"string","description":"Comma-separated addresses (optional)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aZWv8LbWSHCqepCSTndNu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Accepts up to 50 EVM/Base blockchain addresses in a single POST and returns curated entity labels including category, name, confidence, source, and risk flags such as sanctioned, mixer, or scam.","exampleAgentPrompt":"Can you label these 5 wallet addresses for me and flag any that are sanctioned, mixers, or scams before I process a payment to them: 0xabc...1, 0xdef...2, 0xghi...3, 0xjkl...4, 0xmno...5?","exampleUseCases":[{"title":"Counterparty screening before DeFi payment","prompt":"Before I send USDC to these 10 wallet addresses, check if any of them are sanctioned entities, known mixers, or scam wallets — and tell me what category each one belongs to if it's a known entity."},{"title":"CEX hot wallet identification for analytics","prompt":"I have a list of 30 addresses that are interacting with our protocol — can you label each one and tell me which are CEX hot wallets, DEX routers, or bridges so I can segment them in my analytics dashboard?"},{"title":"Automated KYC-lite for onboarding flow","prompt":"We're onboarding new users who've submitted their wallet addresses — run these 25 addresses through a bulk label check and flag any that come back as scam, mixer, or sanctioned so we can review them before approving."}],"resultDescription":"A JSON response mapping each submitted address to its label object (tag, name, category, confidence, source) or null if the address is not in the curated label set. Risk flags such as sanctioned, mixer, and scam are included where applicable.","failureModes":["Batch exceeds 50 addresses — request rejected with validation error","Address not found in label set — returns null for that entry rather than an error","Invalid address format — may return error or null depending on implementation","Payment not included or insufficient — 402 Payment Required response","Network or provider downtime — 5xx error with no label data returned"],"whenToPreferThis":"Choose this endpoint when you need to screen or label multiple EVM/Base wallet addresses in a single call for compliance, due diligence, or payment-routing risk gating. It is ideal for agentic workflows that need to classify counterparties at scale (up to 50 at once) without running individual lookups. Prefer this over single-address lookups when processing batches, and over generic blockchain explorers when you need curated entity labels with confidence scores and risk flags rather than raw transaction data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T19:02:37.307Z","isFirstParty":false,"canonicalSlug":"x402node-bulk-onchain-address-label-api-6268f208"}