{"uid":"cap_UOteQuM-v75Sl9x6VAqxH","slug":"blockrun-ai-9e0fad65","name":"BlockRun.AI Batch Wallet Label Lookup","description":"BlockRun independently tests AI agents that move money: did they pay the right party the right amount, avoid being scammed, stay within their mandate, and tell the truth afterwards. Scored from the ledger, not by a model judge.","url":"https://blockrun.ai/api/v1/surf/wallet/labels/batch?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"addresses":{"type":"string","description":"Required query param"}}},"responseSchema":null,"example":{"request":{"addresses":"0x1234567890123456789012345678901234567890,0x0987654321098765432109876543210987654321,0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"},"response":{"data":[{"labels":[{"label":"Burn Address","confidence":1}],"address":"0x1234567890123456789012345678901234567890","entity_name":"OKX Deposit","entity_type":"cex_deposit"},{"labels":[],"address":"0x0987654321098765432109876543210987654321"}],"meta":{"limit":2,"total":2,"cached":false,"offset":0,"credits_used":1},"$schema":"https://api.asksurf.ai/schemas/DataResponseWalletLabelItem.json"}},"exampleRequest":{"addresses":"0x1234567890123456789012345678901234567890,0x0987654321098765432109876543210987654321,0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"},"tags":["x402"],"displayCostAmount":"0.0075","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0075/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EDwOgW4ZzZxSP1ZBvh4tQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns blockchain wallet labels (CEX, Whale, Bridge, MEV, etc.) for a batch of addresses in a single call.","exampleAgentPrompt":"Can you label these wallet addresses for me — 0xabc123, 0xdef456, 0x789ghi — and tell me which ones are CEX wallets, whales, bridges, or MEV bots?","exampleUseCases":null,"resultDescription":"Returns a mapping of each submitted wallet address to one or more labels such as CEX, Whale, Bridge, MEV, or other entity classifications recognized on-chain.","failureModes":["Missing or empty 'addresses' query parameter returns an error","Malformed or non-checksummed addresses may return no label or an error","Unknown addresses return empty or null labels rather than an error","Rate limiting or payment failure (402) if x402 payment is not provided","Batch too large may result in timeout or partial results"],"whenToPreferThis":"Use this endpoint when you need to classify multiple blockchain wallet addresses simultaneously by entity type (CEX, Whale, Bridge, MEV). Prefer it over single-address lookups when processing transaction lists, auditing DeFi interactions, or enriching on-chain data pipelines where batch efficiency matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:35:53.898Z","isFirstParty":false,"canonicalSlug":"blockrun-ai-9e0fad65"}