# x402node Bulk Onchain Address Label API

> x402node Bulk Onchain Address Label API is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-18).

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.

## Facts

- Endpoint: POST https://api.x402node.dev/wallet/label-bulk?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402node-bulk-onchain-address-label-api-6268f208
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OEaSV2dURpMqXN9Z7GMBT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402node-bulk-onchain-address-label-api-6268f208 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addresses": {
   "type": "string",
   "description": "Comma-separated addresses (optional)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402node-bulk-onchain-address-label-api-6268f208/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)