docs/source/use-cases/crypto.rst
.. _use-case-crypto:
Blockchain transactions are public, but the people behind wallets are not. Maigret helps bridge this gap by finding Web3 accounts tied to a username, revealing the person behind a pseudonymous crypto persona.
Crypto investigations often start with a wallet address or an ENS name but hit a wall — the blockchain tells you what happened, not who did it. A username, however, is reused across platforms. If someone trades on OpenSea as zachxbt and posts on Warpcast as zachxbt, Maigret connects the dots and builds a full profile.
Common scenarios:
Maigret currently checks the following crypto and Web3 platforms:
.. list-table:: :header-rows: 1 :widths: 20 40 40
ZachXBT <https://twitter.com/zachxbt>_ is a well-known on-chain investigator. Let's see what Maigret can find from just the username zachxbt:
.. code-block:: console
maigret zachxbt --tags crypto
Maigret finds 5 accounts and automatically extracts structured data from each:
Fragment — confirms the Telegram username @zachxbt is claimed, reveals the TON wallet address (EQBisZrk...), purchase price (10 TON), and date (January 2023).
Paragraph — the richest result. Returns the real name used on the platform (ZachXBT), bio (Scam survivor turned 2D investigator), an Ethereum wallet address (0x23dBf066...), and a linked Twitter handle (zachxbt). The wallet_address field is especially valuable — it directly links the pseudonym to an on-chain identity.
Warpcast — Farcaster profile with a Farcaster ID (fid: 20931), profile image, and social graph (33K followers). Every Farcaster ID is tied to an Ethereum address via the on-chain ID registry, so this is another on-chain anchor.
OpenSea — NFT marketplace profile with bio (On-chain sleuth | 10x rug pull survivor), avatar (hosted on seadn.io with an Ethereum address in the URL path), and a link to an external investigations page.
Hive Blog — blockchain-based blog account created in March 2025. Low activity (1 post), but confirms the username is claimed across blockchain ecosystems.
From a single username, Maigret produces:
zachxbt (from Paragraph)@zachxbt (from Fragment)investigations.notion.site (from OpenSea)This is enough to pivot into blockchain analysis tools (Etherscan, Arkham, Nansen) using the wallet addresses, or into social media analysis using the Twitter handle.
Step 1: Search crypto platforms
.. code-block:: console
maigret <username> --tags crypto -v
Review the results. Pay attention to:
Step 2: Expand with extracted identifiers
Maigret automatically extracts additional identifiers from found profiles (real names, linked accounts, profile URLs) and recursively searches for them. This is enabled by default. If Maigret finds a linked Twitter handle on a Paragraph profile, it will automatically search for that handle across all sites.
Step 3: Cross-reference with non-crypto platforms
The real power is connecting crypto personas to mainstream accounts. Drop the tag filter:
.. code-block:: console
maigret <username> -a
This checks all 3000+ sites. A match on GitHub, Reddit, or a forum can reveal the person behind the wallet.
If you start with a wallet address rather than a username, you can use complementary tools to get a username first:
vitalik.eth). Then search that name in Maigret.Once you have a username candidate, feed it to Maigret.
Username reuse is the #1 signal. Crypto-native users often reuse their ENS name (alice.eth) or a variation (alice_eth, aliceeth) across platforms. Try all variations.
Fragment is uniquely valuable because it directly links Telegram usernames to TON wallet addresses — a rare on-chain / off-chain bridge.
Warpcast profiles are Ethereum-native. Every Farcaster account is tied to an Ethereum address via the ID registry contract. If you find a Warpcast profile, you implicitly have a wallet address.
Paragraph often has the richest data — wallet address, Twitter handle, bio, and activity timestamps in a single API response.
Use --exclude-tags to skip irrelevant sites when you're focused on crypto:
.. code-block:: console
maigret alice_eth --exclude-tags porn,dating,forum