Skip to main content

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.TypeMeaningExample Label.Value
darknet-marketDarknet market walletdarknet-silk-road, darknet-market-hydra-market
scamScam addressscam-address-poisoning, scam-sextortion, scam-fraud
phishingPhishing or wallet-drainer addressphishing-unspecified, phishing-wallet-drainer
hackerAddress used in an exchange or protocol hackhacker-upbit-2019, hacker-lazarus-group
ransomwareRansomware payment addressransomware-locky, ransomware-cryptolocker
money-launderingAddress used to launder fundsmoney-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:

Run in Bitquery IDE

{
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​

FieldMeaning
AddressThe address you queried
ChainChain the label applies to
Label.TypeOne of the crime types above
Label.ValueThe incident, group or scam kind
RecordedAtWhen 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:

Run in Bitquery IDE

{
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 hacker and scam at once. Keep Label_Type in limitBy.
  • 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.

Build with Bitquery

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.