ADDRESS LABELS API · GraphQL · MCP · Bulk export

Address Labels API — the entity behind any wallet or contract

Skip scraping label clouds and stitching vendor CSVs. Bitquery labels addresses on Ethereum, BNB Chain, Tron, Bitcoin, Solana, Arbitrum, Base and more — exchange hot and cold wallets, per-user deposit addresses, gambling, mixers, sanctioned entities and issuer-frozen funds — and returns them for any address in one GraphQL query, through the MCP server for AI agents, or as a bulk export into your warehouse.

Powering attribution forChainalysis logoTRM Labs logoNansen logoLukka logo
Metadata.LabelsEvery label recorded for one address, newest first.Docs
address_labels.graphqlCopy
{
  Metadata {
    Labels(
      where: {Address: {is: "0x28c6c06298d514db089934071355e5743bf21d60"}}
      limitBy: {by: [Address, Chain, Label_Type], count: 1}
      orderBy: {descending: RecordedAt}
    ) {
      Address
      Chain
      Label { Type Value }
      RecordedAt
    }
  }
}
responseSTREAMING
AddressTypeValue
200 · GraphQL · ~120msstreaming.bitquery.io
Trusted by 40,000+ developers & teams like
Binance logoChainalysis logoTRM Labs logoNansen logo0x logoCoinMarketCap logoCoin Metrics logoBybit logoLukka logo3Commas logoNexo logoTether logo
40+
Chains supported
1PB+
Blockchain data indexed
10B+
API calls / month
99.9%
Production uptime
01
Forget label clouds and vendor CSVs

Whose address is this? should be one query, not a research project.

Answering it yourself means scraping explorer label clouds, buying and reconciling vendor lists in three formats, clustering exchange deposit sweeps by hand and watching issuer blacklist events on every chain — and a label that is a week stale is a compliance miss. Bitquery runs the pipeline that records these labels and serves them from one cube.

What you need
Do it yourself
Address Labels API
Whose wallet is this?
Scrape explorer label clouds
Type + value for any address, one query
Is it an exchange deposit address?
Cluster sweep patterns by hand
cex-deposit-address, with the exchange named
Has Tether or Circle frozen it?
Watch blacklist events per chain
issuer-blocked-usdt / issuer-blocked-usdc labels
Screen a hundred counterparties
A hundred explorer tabs
Batch lookup, one call
Bitcoin, Tron and Solana too
Three vendors, three formats
One cube, every chain
Feed labels to an AI agent
Write your own tool wrapper
MCP tools, ready to call
Load the whole label set
Not for sale
Bulk export to your warehouse
02
Coverage by chain

Deepest where the money actually moves.

Coverage follows exchange flow: Tron and Ethereum carry the deposit addresses of every major exchange, Bitcoin carries the long history of exchange, mining-pool, mixer and darknet wallets, and BNB Chain, Solana, Arbitrum and Base carry hot wallets, deposits and protocol labels. Every row below is one address we have put a name on.

ChainLabelled addressesWhat's dense here
Tron71.6MDeposit addresses at every major exchange, gambling, payment processors, USDT freezes
BNB Chain29.8MExchange hot wallets and deposit addresses, token contracts
Ethereum25.8MExchange deposits and hot wallets, DeFi protocols, issuer freezes, sanctioned entities
Bitcoin25.0MExchange and mining-pool wallets, mixers, darknet markets, ransomware
Solana7.8MExchange hot wallets and deposits, gambling, token and program labels
Arbitrum7.2MExchange deposits and hot wallets, DeFi protocols
Base2.2MExchange deposits and hot wallets, DeFi protocols
Polygon · Avalanche · Fantom · Cronos · MoonbeamearlyExchange wallets and contracts — growing
Read the chain and filter reference
03
Label taxonomy

45 label types. Values are entity slugs you can read.

Every label is a type plus a value. The type says what kind of thing the address is; the value names the entity — binance-deposit, kraken-hot-1, stake-com-hot, banned-by-usdt, helix. Filter on either, on any chain. The taxonomy is open: new types appear as the pipeline records them, so handle unknown types gracefully.

Exchanges

139M addresses
cex-deposit-address 119.5Mcex-hot-wallet 20.2Mcex-cold-walletcex-withdrawal-addresscex-unknown-type

Per-user deposit addresses are the largest set — the address a customer is given at Binance, OKX, HTX, Bybit, WhiteBIT, ChangeNOW and dozens more, detected from sweep behaviour into verified hot wallets.

Risk & compliance

Screening set
sanctioned-entityissuer-blocked-usdtissuer-blocked-usdcmixer 495Kdarknet-market 2.3Mscamphishingransomwarehackermoney-launderingtaintedrisk-flagterroristno-kyc

Issuer freezes are read from Tether's and Circle's own blacklist events; sanctioned-entity values name the sanctioned operator (sanctioned-htx, sanctioned-rapira).

Services & entities

18M+ addresses
gambling 8.4Mpayment-processor 5.9Meoa-entity 4.0Mmining-pool 407Kasset-managere-commerceotc-deskmarket-makerserviceinfrastructuregovernmentutility-toolteam-wallet

Gambling covers hot wallets and deposit addresses at Stake, Roobet, 1xBet, BC.Game and others; payment processors include CoinPayments, BitPay, Alphapo and Wirex.

Protocols & contracts

1.5M+ contracts
contract 1.5Mtoken-contractdex-routerdex-pooldex-aggregatorlending-protocol 393Kstaking-protocolyield-aggregatorderivatives-protocolbridgelaunchpadrwa-protocolmultisig

Contract labels tell a token contract from a user smart wallet, a forwarder or a router, so a counterparty list stops being a wall of hex.

05
Build it this sprint

What teams ship on the labels.

Each one is a filter on the same label data — call GraphQL on demand, subscribe to the underlying transfers for live triggers, or let an agent do the lookups.

GraphQL · Cash-out detection

Catch funds the moment they reach an exchange

Take the receivers from a Transfers query, batch them through Labels and flag any cex-deposit-address or cex-hot-wallet — the moment stolen or laundered funds reach an exchange, with the exchange named.

Label: { Type: { in: ["cex-deposit-address","cex-hot-wallet"] } }
Read the docs
GraphQL · Screening at onboarding

Clear, review or block before the deposit lands

Before accepting a deposit, check the wallet for issuer-blocked-usdt, issuer-blocked-usdc, sanctioned-entity, mixer and darknet-market labels — one call, then clear, review or block.

Label: { Type: { startsWith: "issuer-blocked" } }
Add risk scoring with Coinpath
MCP · AI investigations

Label-aware AI investigations

Let Claude or Cursor call address_labels and labels_for_addresses while it traces a money flow, so the graph it draws shows "OKX deposit" and "Bitcoin Fog" instead of hex.

labels_for_addresses(addresses: "0x…, T…, bc1…")
Explore the MCP server

What teams say about our data

"We did a thorough search of the market for the best onchain data. Bitquery came out on top — and now powers all live prices across Nansen. We don't think of them as a vendor. They're a partner."

A
Alexander Karsten
Nansen
169M+
Labelled addresses across 12 chains
45
Label types, open taxonomy
100
Addresses per call, batch lookups

Bitquery does the hard work of parsing blockchain transaction data into a usable form so that we don't have to. We use their interface to diagnose issues with complex transactions and their analytics as a starting point for our own.

0x Protocol logo
Alex Knaggs
0x Protocol

They proved they had the technology to deliver sophisticated data solutions. We extended our support through the Binance X fellowship — building an open-source library of visualization widgets on their blockchain data.

Director, Binance X logo
Flora Sun
Director, Binance X

The complex raw data is available at different levels of detail and from different viewpoints — whether we need simple aggregated transfers or parameters for failed contract calls. The support is responsive, friendly and quick.

Backend Developer, Blockpit logo
Jan Dreske
Backend Developer, Blockpit

Partnering with Bitquery has been highly cost-effective — leveraging their established infrastructure rather than building our own let us rapidly expand our blockchain support and reach a much broader segment of on-chain users.

Co-Founder, Syla logo
Nick Christie
Co-Founder, Syla

Bitquery's products are very intuitive and easy to use. We currently use their products to obtain DEX-related trading and liquidity information, which saves us the manpower and tedious technical details required to develop our own system. Their excellent technical team deserves special praise; they provide near-24/7 support and resolve issues quickly. I greatly appreciate their products and work ethic.

Ourbit logo
Data Team
Ourbit

Bitquery provides the infrastructure we rely on every day. Fast, reliable, and comprehensive across the chains that matter to our business.

Webacy
Webacy
webacy.com
06
Pricing

Labels are one add-on, not a per-chain bill.

Address labels are sold as a single multi-chain dataset that stacks on any self-service plan, or as tools inside the AI Investigation MCP plan. The full dataset ships in bulk on Enterprise.

Yearly saves 20%
Add-on · any plan
Address Label Data (Multi-chain)
$99
per month

Every chain, every label type, batch lookups included. Stacks on Personal ($49), Pro ($99) or Scale ($299). Buy it in billing and query Metadata.Labels immediately.

Add in billing
Plan · AI agents
AI Investigation MCP
$149
per month

200k MCP credits a month and every Bitquery MCP tool — money-flow tracing, address profiles, onchain SQL and the four label tools — for Claude, Cursor and any MCP client. Trading MCP ($19) does not include labels.

See MCP plans
Enterprise
Bulk labels export
Talk to sales
committed pricing

The complete label table — all chains, all types, with RecordedAt history — delivered as Parquet or CSV to S3, Snowflake, BigQuery or Azure and refreshed on your schedule. Bundled with Coinpath, Kafka and full-history data on a committed plan.

Talk to sales
7-day free trial on paid plans
FAQ

Address label questions, answered.

What is the Address Labels API?
A GraphQL cube, Metadata.Labels, that returns the labels recorded for any address: the chain, a label type such as cex-hot-wallet or issuer-blocked-usdt, a value naming the entity such as binance-hot-1, and the time the label was recorded. It covers EVM chains, Bitcoin, Tron and Solana from one endpoint and accepts up to 100 addresses per query.
Which label types are available?
45 at the time of writing, grouped into exchanges (hot, cold, deposit and withdrawal addresses), risk and compliance (sanctioned entities, issuer-frozen USDT and USDC, mixers, darknet markets, scams, phishing, ransomware, hackers), services (gambling, payment processors, mining pools, OTC desks, market makers) and protocols (token contracts, DEX routers and pools, lending, staking, bridges, multisigs). The taxonomy is open and new types are added as the pipeline records them.
Which chains are covered?
Ethereum, BNB Chain, Tron, Bitcoin, Solana, Arbitrum, Base, Polygon, Avalanche, Fantom, Cronos and Moonbeam. Coverage is deepest on Tron, BNB Chain, Ethereum and Bitcoin. On EVM chains an address is the same owner everywhere, so query without a chain filter to catch a label recorded on another EVM chain.
How do I tell whether an address belongs to an exchange?
Filter Label.Type to cex-hot-wallet, cex-cold-wallet or cex-deposit-address; the value names the exchange, for example okx-deposit or kraken-hot-1. Deposit addresses are the largest set — well over a hundred million per-user addresses detected from sweep behaviour into verified exchange hot wallets.
Can I check whether Tether or Circle has frozen an address?
Yes. Frozen addresses carry issuer-blocked-usdt or issuer-blocked-usdc, read from the issuers' own blacklist events, so a startsWith: "issuer-blocked" filter screens both in one call.
How much does it cost?
The Address Label Data (Multi-chain) add-on is $99 a month, or $79.20 a month billed yearly, on top of any self-service plan from $49 a month. AI agents get the same labels through the AI Investigation MCP plan at $149 a month ($119 yearly). Bulk export is an Enterprise product with committed pricing.
Can I export all labels in bulk?
Yes. Enterprise customers receive the full label dataset — every chain, type and value with recorded-at history — as Parquet or CSV to S3, Snowflake, BigQuery or Azure, refreshed on a schedule, through Bitquery's Datashares and Data on Demand delivery. Talk to sales to scope it.
Can AI agents use the labels?
Yes. The Bitquery MCP server exposes address_labels, labels_for_addresses, addresses_by_label and find_label_values, so Claude, Cursor, ChatGPT or any MCP client can label counterparties mid-investigation. The tools are included in the AI Investigation MCP plan.
Do labels stream in real time?
The cube is query-only. Labels are append-only, so poll with a RecordedAt: {since: …} filter to pick up new labels for a watchlist, or subscribe to the underlying Transfers stream and resolve the counterparties through Labels as they appear.
How are labels produced?
From Bitquery's own on-chain detection — deposit-address sweep patterns anchored on verified exchange hot wallets, issuer blacklist events read from the stablecoin contracts, contract and token metadata — plus curated entity research. Every label carries the time it was recorded, so you can audit when an address was attributed.

Put a name on every address this week.

Start a 7-day free trial on any plan, add multi-chain labels for $99 a month, and batch-label your first hundred counterparties in a single call — or talk to us about the full dataset in your warehouse.

7-day free trial · Labels add-on $99/mo · Bulk export on Enterprise