❓ Frequently Asked Questions

Everything you need to know about bluepages.fyi

General Questions

What is Bluepages?

Bluepages is a cryptocurrency address to Twitter account lookup service. We maintain a database of verified mappings between Ethereum addresses and Twitter handles, allowing you to look up one from the other.

How much does it cost?

• Check if exists: $0.001 USDC (verify if an address/Twitter is in our database)
• Get full data: $0.05 USDC (retrieve complete mapping with metadata)
• Opt-out: FREE (remove your data from our database)

All payments are made via x402 protocol using USDC on Base mainnet.

Are there bulk discounts?

We currently offer batch API endpoints that allow you to query up to 50 addresses or Twitter handles in a single request. We plan to add bulk discounts for large-scale users in the future. For now, each query is priced individually as listed above.

What payment methods do you accept?

We use the x402 payment protocol with USDC on Base mainnet. You'll need a compatible Web3 wallet (MetaMask, WalletConnect, etc.) to make payments.

Data & Privacy

How did you get my data?

All of our data is sourced from data that the end user posted on social media themselves. We aggregate publicly available information that users have voluntarily shared, including:

• Twitter profiles with ENS names (e.g., @username.eth)
• Public social media posts linking crypto addresses to Twitter accounts
• ENS (Ethereum Name Service) records publicly available on-chain
• Friend.tech and similar social dapp profiles
• Other public blockchain and social media data

We do not scrape private accounts, hack databases, or use any non-public information sources.

Can I remove my data?

Yes! We provide a free opt-out feature. Here's how:

1. Visit /opt-out.html on our website
2. Connect your wallet (MetaMask or WalletConnect)
3. Sign a message to prove you own the address
4. Your data will be immediately removed from our database

Once you opt out:

• Your address will no longer appear in query results
• All Twitter accounts linked to that address will be removed
• All OTHER addresses linked to those same Twitter accounts will also be removed
• This ensures complete privacy across all your linked identities
• The opt-out is permanent and cannot be reversed
• No fees are charged for opting out

Example: If you opt out with Address A, which is linked to Twitter @handle1, and @handle1 is also linked to Address B and C, then all three addresses (A, B, C) and @handle1 will be removed from our database.

How can I improve my privacy?

If you're concerned about your cryptocurrency addresses being linked to your identity, there are several privacy-enhancing tools you can use:

Privacy Protocols

• Tornado Cash - A privacy protocol that breaks the on-chain link between source and destination addresses using zero-knowledge proofs.
• Railgun - A privacy system that allows you to shield your assets and use DeFi applications privately while keeping your balances and transaction amounts hidden.
• Privacy Pools - An evolution of privacy protocols that allows users to prove they aren't mixing with illicit funds while still maintaining privacy.

Best Practices

1. Use separate wallets: Keep your public identity wallet separate from your private transaction wallets
2. Fresh addresses: Generate new addresses for sensitive transactions
3. Avoid linking: Don't post your address on social media or link it to your real identity
4. Privacy coins: Consider using privacy-focused cryptocurrencies for sensitive transactions
5. Opt out: Use our free opt-out feature to remove existing linkages from our database

Data Questions

What data sources do you use?

Our database includes mappings from multiple sources with different reliability levels:

• Tally Governance: High reliability - On-chain governance participant data from Tally.xyz
• Farcaster: High reliability - Verified social connections from Farcaster protocol
• Manual Entry: High reliability - Manually verified mappings
• Friend.tech: High reliability - Direct platform data from friend.tech
• ENS + Twitter: Medium reliability - Twitter profiles with .eth in their name
• Friend.tech Heuristic: Medium reliability - Discovered owners via blockchain transaction analysis
• Social media: Variable reliability - Public posts linking addresses to Twitter accounts

Each result includes source information so you can evaluate reliability. We use a priority system where higher-quality sources take precedence when conflicts occur.

Will you get more data?

Yes, we are actively obtaining new data sources which will be added to both our current endpoints and a new Premium endpoint.

Is the data accurate?

We strive for accuracy, but different sources have different reliability levels:

• ✅ ENS-based and governance data are highly reliable (from on-chain sources)
• ✅ Manually verified entries are confirmed accurate
• ⚠️ Social media-based mappings depend on user-posted information
• ⚠️ Heuristic-based mappings use blockchain analysis but aren't 100% certain
• ⚠️ Users can change Twitter handles over time
• ⚠️ Multiple people could claim the same address/handle relationship

We provide source metadata and priority information with each result so you can evaluate reliability yourself. We're constantly working on adding more complex heuristics to improve data quality and discover new connections.

What do you log?

For service improvement, we log the addresses and Twitter handles queried, along with basic request information (timestamp, IP address, payment details). This helps us:

• Identify which ecosystems and communities need better data coverage
• Discover patterns that guide future improvements
• Focus our data collection on high-demand areas
• Detect and prevent abuse of the service

Logs are retained for 12 hours and then permanently deleted. We do not sell or share query logs with third parties. See our Terms of Service for complete details.

Support

I found incorrect data. How do I report it?

If you believe data about you is incorrect, please use the opt-out feature to remove it from our database. We don't manually correct individual entries.

My payment failed. What should I do?

Common payment issues and solutions:

• Insufficient USDC: Make sure you have enough USDC on Base mainnet
• Wrong network: Ensure your wallet is connected to Base mainnet (Chain ID 8453)

Note: This is alpha software and sometimes the x402 facilitator we use has outages, so please try again later if your payment fails.

Can I get a refund?

No. All payments are final and non-refundable. The low cost ($0.001 for checks, $0.05 for data) makes refund processing impractical. Please use the free check endpoint first to verify data exists before purchasing.

Need support or have questions?

Join our Telegram community for support, questions, and updates: t.me/+883fNL0gr2g5M2Q8