bluepages.fyi

// FAQ

Frequently asked questions

General

What is bluepages.fyi?

A crypto address ↔ identity and label lookup service. We maintain a database of verified mappings between Ethereum addresses and social accounts (Twitter, Farcaster, GitHub, Discord, and more), plus labels (e.g., CEX exchange wallets).

How much does it cost?

  • x402: Check $0.001, Data $0.05 USDC per request
  • API keys: Prepaid credit packages from $5 (5K credits) to $600 (1M credits), with bulk discounts up to 40% off. Pay nothing when data isn't found.
  • Opt-out: FREE

What payment methods?

  1. x402 protocol — Pay-per-request with USDC on Base. Connect MetaMask or WalletConnect — no account needed.
  2. API keys — Buy a credit package, then include your X-API-KEY header on every request. No wallet interaction, 2x rate limits. Get your API key →
Privacy

Where does the data come from?

All data comes from publicly available information — on-chain records, social platform APIs, governance systems, and investigation datasets. We cover 10+ identity types (Twitter, Farcaster, GitHub, Discord, Telegram, and more) plus address labels (CEX wallets, exchanges) across 30 sources.

Can I remove my data?

Yes. Visit /opt-out, connect your wallet, sign a message. Done.

Opt-out removes:

  • Your address
  • All linked social accounts
  • All other addresses linked to those accounts

Note: Labels (e.g., CEX wallet classifications) are not affected by opt-out. These classify the address type, not personal identity.

Data Sources

How do you rank sources?

Each source has a priority score — lower means more trusted. When multiple sources map the same address, the lowest-priority source wins as the primary result.

High Confidence

Verified on-chain data, signed proofs, and governance platforms. Includes on-chain signature verification, delegate registries, and investigation datasets.

Medium Confidence

OAuth-linked apps, platform-verified accounts, and curated third-party datasets. Identity links established through app-level verification rather than on-chain proofs.

Lower Confidence

Self-reported records (e.g. ENS text fields, public tweets), platform usernames that may not correspond to verified social accounts, and heuristic inference.

Every API response includes a source field and priority score so you can judge confidence yourself.

What are clusters?

Clusters group addresses controlled by the same entity. We detect them via:

  • clusters.xyz — Named clusters with multiple verified wallets
  • shared_twitter — Multiple addresses linked to the same Twitter handle

The API response includes cluster info with fields like transitive, identified, and truncated.

What are labels?

Labels classify what an address is — for example, a centralized exchange (CEX) wallet. Unlike identities (which link an address to a person's social account), labels identify the role of an address.

Labels are sourced from curated datasets like hildobby's CEX address list (4,800+ addresses across 148 exchanges).

Is the data accurate?

It depends on the source. Verified on-chain data and signed proofs are highly reliable. Self-reported records and platform usernames are less so. Every API response includes a source field and priority score so you can judge confidence yourself. Note that social handles can also change over time.

What do you log?

IP, timestamp, queries — deleted after 12 hours. No long-term tracking.

Support

Payment failed?

  • Check USDC balance on Base mainnet
  • Verify wallet is on Base (Chain ID 8453)
  • x402 facilitator may have outages — try again later

Refunds?

No. All sales final.

  • x402 users: Use /check first ($0.001) to verify data exists before calling /data ($0.05).
  • API key users: /data and /batch/data only charge when data is found, so there's nothing to refund for empty lookups.

Contact?

For support, email [email protected] or use the opt-out form. See the API docs for technical questions.