# bluepages.fyi Batch Crypto Address & Twitter Handle Lookup

> bluepages.fyi Batch Crypto Address & Twitter Handle Lookup is a paid API for AI agents from bluepages.fyi, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Batch check up to 50 cryptocurrency addresses and/or Twitter handles for existence across Twitter and Farcaster in a single request

## Facts

- Endpoint: POST https://bluepages.fyi/batch/check
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bluepages-fyi-batch-crypto-address-twitter-handle-lookup-a949e152
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_183Ln9ahXyjZkBaYydvm1

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 bluepages-fyi-batch-crypto-address-twitter-handle-lookup-a949e152 -d '<json body>'
```

Example prompt: Can you batch check these wallet addresses and Twitter handles on bluepages to see which ones have a Twitter or Farcaster presence: 0xabc123, 0xdef456, @vitalik, @naval, 0x789ghi?

## When to prefer this

Use this endpoint when you need to check more than one crypto address or Twitter handle at once and want the cost-efficient batch rate ($0.04 for up to 50 vs $0.05 per individual query). Ideal for enriching a list of wallet addresses with social identity signals, or validating whether a set of Twitter handles have on-chain presence, without making multiple individual API calls.

## Known failure modes

- Batch exceeds 50 items — returns validation error
- Invalid Ethereum address format — item may be skipped or flagged
- Twitter handle not found in bluepages database — returns exists: false
- Payment not included or insufficient — 402 payment required error
- Malformed request body missing both addresses and twitters arrays — 400 bad request

## How this service works

Look up cryptocurrency addresses linked to social accounts and curated labels. Paid API service using x402 protocol on Base mainnet.

## Output

An array of results for each queried address or Twitter handle, each containing boolean existence flags indicating whether the item is registered on Twitter and/or Farcaster within the bluepages identity graph.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addresses": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Array of addresses (up to 50)"
  },
  "identities": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Array of identities to look up (up to 50)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": {
   "addresses": {
    "0x1234...": {
     "types": [
      "twitter",
      "farcaster"
     ],
     "exists": true
    },
    "0x5678...": {
     "types": [],
     "exists": false
    }
   },
   "identities": {
    "@user1": {
     "types": [
      "twitter"
     ],
     "exists": true
    },
    "@user2": {
     "types": [],
     "exists": false
    }
   }
  },
  "success": true,
  "timestamp": "2025-12-23T12:00:00.000Z",
  "totalItems": 4
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bluepages-fyi-batch-crypto-address-twitter-handle-lookup-a949e152/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bluepages.fyi](https://www.zero.xyz/host/bluepages.fyi/llms.txt)