{"uid":"cap_UOteQuM-v75Sl9x6VAqxH","slug":"blockrun-ai-9e0fad65","name":"BlockRun.AI Batch Wallet Label Lookup","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/surf/wallet/labels/batch","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-09-13T18:50:12.364Z","isFirstParty":false}