Crime and Illicit Activity Labels API
Check whether an address is linked to a scam, a hack, ransomware, a darknet market or money laundering. Bitquery labels more than 2 million addresses tied to illicit activity across Bitcoin, Tron, Ethereum, BNB Chain and Solana.
ProductUsing this in production? See the Address Labels API page for plans, free trial and enterprise delivery options.
What it is
Label.Type | Meaning | Example Label.Value |
|---|---|---|
darknet-market | Darknet market wallet | darknet-silk-road, darknet-market-hydra-market |
scam | Scam address | scam-address-poisoning, scam-sextortion, scam-fraud |
phishing | Phishing or wallet-drainer address | phishing-unspecified, phishing-wallet-drainer |
hacker | Address used in an exchange or protocol hack | hacker-upbit-2019, hacker-lazarus-group |
ransomware | Ransomware payment address | ransomware-locky, ransomware-cryptolocker |
money-laundering | Address used to launder funds | money-laundering-lazarus-group |
Sanctions and general risk flags are on Sanctions and Risk Labels.
How to get it
Query the Metadata.Labels cube of the Address Labels API with the crime types:
{
Metadata {
Labels(
where: {
Address: {in: [
"1112CGBRVh3aWKUznfw52QzybpB7yofnJo",
"1123pJv8jzeFQaCV4w644pzQJzVWay2zcA",
"T9yDNAbctN9ncNnXFFJRXQjSFiak7jCeUz",
"0x8ad8717f20169df861ee8c30f6d6a410a3e48797"
]}
Label: {Type: {in: ["darknet-market", "scam", "phishing", "hacker", "ransomware", "money-laundering"]}}
}
limitBy: {by: [Address, Chain, Label_Type], count: 1}
orderBy: {descending: RecordedAt}
) {
Address
Chain
Label {
Type
Value
}
RecordedAt
}
}
}
The response returns a Silk Road darknet address, a Locky ransomware address, a Tron address-poisoning address and an Ethereum address tagged hacker and scam.
How it is derived
Bitquery's labelling pipeline compiles each label from many inputs and returns one finished result: a type, a value and the date it was recorded. Responses carry the label itself, not a per-label source reference.
Fields
| Field | Meaning |
|---|---|
Address | The address you queried |
Chain | Chain the label applies to |
Label.Type | One of the crime types above |
Label.Value | The incident, group or scam kind |
RecordedAt | When the label was added to Bitquery's label table |
Examples
Detect address poisoning before a payout
Address poisoning plants a look-alike address in a wallet's history. Check the destination before you send:
{
Metadata {
Labels(
where: {
Address: {is: "T9yDNAbctN9ncNnXFFJRXQjSFiak7jCeUz"}
Label: {Value: {includes: "address-poisoning"}}
}
limitBy: {by: [Chain, Label_Value], count: 1}
orderBy: {descending: RecordedAt}
) {
Chain
Label {
Type
Value
}
}
}
}
Follow stolen funds
Trace the hacker address with the Transfers cube or MoneyFlow Lite, then label every hop here. A hop that returns cex-deposit-address is where the funds reached an exchange.
Pitfalls
- A label is a signal, not a verdict. It says Bitquery holds this classification for the address. Review the on-chain activity before you act on it.
- Several labels per address are normal. A hack address is often tagged
hackerandscamat once. KeepLabel_TypeinlimitBy. - Coverage follows activity. Darknet and ransomware labels are mostly Bitcoin. Address-poisoning labels are mostly Tron and Ethereum.
- No row is not a clearance.
Get the full dataset
Building a scam or fraud model, or screening at scale? The full label set, including every crime type on this page, is sold as the Address Labels dataset on the Bitquery Data Store.
Frequently Asked Questions
How do I check if a wallet address is a scam?
Query Metadata.Labels with the address and filter Label Type to scam and phishing. A returned row names the scam kind in Label.Value, for example scam-address-poisoning.
Does Bitquery label hacker wallets?
Yes. The hacker type covers addresses used in exchange and protocol hacks, and the value names the incident or group when it is known.
Which chains have crime labels?
Bitcoin, Tron, Ethereum and BNB Chain have the most. Solana and other EVM chains are covered at lower density.
Related
Ready to run this in production?
Get an API key and run these queries in minutes, or talk to us about plans and enterprise delivery.