# bluepages.fyi - Crypto Address ↔ Twitter Lookup

> bluepages.fyi - Crypto Address ↔ Twitter Lookup is a paid API for AI agents from bluepages.fyi, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Look up the Twitter handle, Farcaster username, and ENS name associated with an Ethereum address (or vice versa) using aggregated on-chain and social data sources.

## Facts

- Endpoint: GET https://bluepages.fyi/data?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bluepages-fyi-crypto-address-twitter-lookup-6fee7cd0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rvvL8tLdPCj4LW-q8iV-Z

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-crypto-address-twitter-lookup-6fee7cd0
```

Example prompt: Can you look up the Twitter handle and ENS name associated with the Ethereum address 0x1Db3439a222C519ab44bb1144fC28167b4Fa6EE6 on bluepages?

## When to prefer this

Use this endpoint when you need to resolve a single Ethereum address to its associated social identities (Twitter, Farcaster, ENS) or look up the wallet address of a known Twitter user. Prefer this over the batch endpoint for one-off lookups. Ideal for enriching on-chain data with social context, identifying governance participants, or verifying who controls a wallet.

## Known failure modes

- Address not found in database — returns empty or null fields
- Invalid Ethereum address format — returns 400 or error response
- Twitter handle not recognized or not linked to any address
- Payment not fulfilled — x402 payment required before data is returned
- Rate limiting or quota exceeded

## 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

Returns a JSON object containing the Ethereum address, Twitter handle, Farcaster username, ENS name, and the data source (e.g. tally, farcaster, manual) that provided the match, sourced from Farcaster, Tally governance, Friend.tech, and social media aggregation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "address": {
       "type": "string",
       "description": "Cryptocurrency address to query"
      },
      "identity": {
       "type": "string",
       "description": "Twitter/identity to search"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string",
       "description": "Cryptocurrency address"
      },
      "cluster": {
       "type": "object",
       "description": "Cluster information"
      },
      "identities": {
       "type": "array",
       "description": "Linked identities"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "found": true,
  "labels": [
   {
    "name": "Binance",
    "type": "cex",
    "detail": "Binance 1",
    "source": "hildobby"
   }
  ],
  "address": "0xabcd1234abcd1234abcd1234abcd1234abcd1234",
  "cluster": {
   "id": "twitter:@example",
   "source": "shared_twitter",
   "rawData": {
    "sharedTwitter": "@example"
   },
   "addresses": [
    "0xabcd1234...",
    "0xef567890..."
   ],
   "truncated": false,
   "identified": true,
   "transitive": false,
   "totalAddresses": 2
  },
  "sanctions": [
   {
    "active": true,
    "entity": "CRYPTEX OTC S.R.O.",
    "source": "ofac_sdn",
    "addedAt": "2024-09-26",
    "programs": [
     "CYBER2"
    ],
    "removedAt": null
   }
  ],
  "identities": [
   {
    "type": "twitter",
    "value": "example",
    "source": "uniswap-sybil",
    "priority": 20
   },
   {
    "type": "twitter",
    "value": "example",
    "source": "tally",
    "priority": 20
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bluepages-fyi-crypto-address-twitter-lookup-6fee7cd0/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)