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.
{
Metadata {
Labels(
where: {Address: {is: "0x28c6c06298d514db089934071355e5743bf21d60"}}
limitBy: {by: [Address, Chain, Label_Type], count: 1}
orderBy: {descending: RecordedAt}
) {
Address
Chain
Label { Type Value }
RecordedAt
}
}
}
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. 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.
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.
78 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
147M addressesPer-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 setIssuer freezes are read from Tether's and Circle's own blacklist events; sanctioned-entity values name the sanctioned company (sanctioned-htx, sanctioned-rapira).
Services & entities
18M+ addressesGambling 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+ contractsContract 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.
Query it, ask an agent, or load the whole table.
Same labels, three delivery paths. Design your lookup once in GraphQL, hand the same tools to an AI agent over MCP, or take the full dataset into your warehouse and join it onto your own transfer data.
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.
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. You see the moment stolen or laundered funds reach an exchange, with the exchange named.
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 in one call, then clear, review or block.
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.
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."
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.
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.
Bitquery provides the infrastructure we rely on every day. Fast, reliable, and comprehensive across the chains that matter to our business.
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 whole table is also sold as a Parquet file in the Data Store.
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 →200k MCP credits per month, and every Bitquery MCP tool for Claude, Cursor and any MCP client: money-flow tracing, address profiles, onchain SQL and the four label tools. Trading MCP ($19) does not include labels.
See MCP plans →The complete label table, all chains and all types, delivered as Parquet or CSV to S3, Snowflake, BigQuery or Azure and kept current through Datashares. Bundled with Coinpath, Kafka and full-history data on a committed plan.
Talk to sales →Address labels as files
Need history for a backtest or an audit? Buy it as Parquet files you keep instead of paging through the API. Every dataset has a free sample file, and you can pay by card or bank transfer.
Need other tables or a custom range? Request a custom extract
Address label questions, answered.
What is the Address Labels API?
Which label types are available?
Which chains are covered?
How do I tell whether an address belongs to an exchange?
Can I check whether Tether or Circle has frozen an address?
How much does it cost?
Can I export all labels in bulk?
Can AI agents use the labels?
Do labels stream in real time?
How are labels produced?
Put a name on every address this week.
Start a 7-day free trial on any plan, add multi-chain labels for $99 per month, and batch-label your first hundred counterparties in a single call. Or talk to us about the full dataset in your warehouse.