Address Label API
The Address Label API enables users to fetch address labels and comprehensively understand an address from various perspectives. It currently supports more than 25 different blockchains, including Solana, Bitcoin, Tron, Ethereum, BSC and other EVM-compatible chains.
Address Label
When using our API to look up an address, we will return three types of labels to describe the address.
Entity
We use Entity to describe an address's owner or controller. If it's an EoA address, this means the entity that controls this EoA address (with the private key). For a smart contract, the entity can refer to their deployers (projects).
An address may have more than one entity.
Assigning an entity to an address is primarily to establish a connection between a cryptocurrency address and a known organization or individual. However, there are cases where an address can be associated with multiple entities. In these cases, we will assign the Main Entity and Complementary Entities.
For instance, consider Alameda's deposit address on Binance. We can state that Binance exercises control over the private key of this address or that Alameda utilizes it. In such situations, we designate Binance as the primary entity for this address while considering Alameda as a secondary or complementary entity.
Entity Category
Most entities are organizations or services, while only a few represent individuals. Most entities are categorized into the following categories, which can help you understand their nature.
ASSET MANAGEMENT
3001
Financial institutions that specialize in managing and investing assets on behalf of clients.
BRIDGE
3002
Protocols that facilitate the movement of assets and data between different blockchain networks.
CHILD ABUSE MATERIAL
3003
Forums and websites that facilitate the buying, selling, and distribution of child abuse material.
CLOUD MINING
3004
Services that allow individuals to rent processing power from remote data centers to mine cryptocurrency without managing physical hardware.
DAPP
3005
A decentralized application (dApp) is an application developed on a decentralized network, integrating a smart contract and a user interface. When a dApp does not fit into specific categories such as DEFI, it is placed under this general category. However, it may be categorized under newly added categories in the future.
DARK MARKET
3006
Illicit websites on the dark web that facilitate the buying and selling of illegal goods and services, including drugs, weapons, counterfeit currency, and stolen data.
DEFI
3007
DeFi apps, which are decentralized finance applications, provide peer-to-peer financial services on public blockchains. When a DeFi dApp does not fall into specific categories like DEX (Decentralized Exchange), it is placed under this general category. However, it may be categorized under newly added categories in the future.
DEX
3008
Peer-to-peer marketplaces where transactions occur directly between crypto traders.
DEX AGGREGATOR
3009
A platform that sources liquidity from various decentralized exchanges to provide optimal trade execution in terms of price and slippage
ECOMMERCE
3010
E-commerce platforms that support cryptocurrencies.
EXCHANGE
3011
Centralized platforms that enable individuals to buy, sell, and trade various cryptocurrencies.
FAUCET
3012
An app or a website that distributes small amounts of cryptocurrencies as a reward for completing easy tasks.
GAMBLING
3013
Online platforms that allow users to gamble using cryptocurrencies.
INFRASTRUCTURE
3014
Basic services or programs deployed on the blockchain, such as the ENS (Ethereum Name Service) service and Solana system programs.
NFT MARKETPLACE
3015
Platforms that facilitate the buying, selling, and creation of Non-Fungible Tokens (NFTs).
MINING POOL
3016
A mining pool is when individual crypto miners join together and pool their resources in order to improve their chances of obtaining a block reward.
MIXER
3017
A service that blends the cryptocurrencies of many users together to obfuscate the origins and owners of the funds.
PAYMENT PROCESSOR
3018
A service that processes payments in digital currencies and allows merchants to accept cryptocurrency payments.
RANSOMWARE
3019
Criminal gangs conducting extortion through ransomware.
WALLET
3020
Softwares or hardwares that enable users to store and use cryptocurrency.
Attribute
We use Attribute to describe the behavior or action associated with a specific address or entity. All attributes are listed in the table below.
ATTACKER
4001
Addresses involved in attack events, such as contract exploits, private key hacks, or extortions.
BLOCKED
4002
Addresses that have been blocked by critical contracts, primarily USDT and USDC.
COLD WALLET
4004
A cold wallet refers to a type of cryptocurrency wallet that is stored offline and is not connected to the internet.
DARKWEB BUSINESS
4006
Addresses involved in dark web businesses, encompassing activities such as drugs, weapons, abuse, and other illicit practices.
DEPOSIT ADDRESS
4007
The deposit address here refers to the address used by the centralized platform to receive user deposits, and typically, each user is assigned their own unique deposit address.
HOT WALLET
4009
A hot wallet is a type of cryptocurrency wallet that is connected to the internet and is actively used for transactions and day-to-day cryptocurrency management.
LAUNDERING
4011
The addresses and entities associated with this attribute are believed to engage in money laundering activities.
MIXING
4012
This label is attributed to services or addresses (primarily contracts) that are believed to possess the capability to obfuscate fund flows.
NO KYC
4013
The VASP (Virtual Asset Service Provider) associated with the address does not have a KYC (Know Your Customer) procedure in place.
RETURN FUNDS
4014
Address utilized for executing an attack or exploit, followed by the subsequent return of funds. This individual could be a white hat hacker or someone who reached a settlement with the project team.
SANCTIONED
4015
The cryptocurrency address associated with individuals or organizations subject to sanctions.
SCAM
4016
The addresses associated with individuals or organizations involved in fraudulent activities, including phishing, honeypots, Ponzi schemes, and more.
Name Tag
A name is utilized to describe a cryptocurrency address with human-readable information. Assigning names usually considers the entity associated with the address and its specific attributes, such as Binance Hot Wallet 1 or Vitalik 2.
Supported Networks
The Address Label API supports 25 different chains, which are listed in the chart below. We also provide an API that allows you to retrieve a list of all supported chains, enabling you to stay informed about any newly added chains.
When making an API request, please use the Chain ID to specify the desired chain.
Solana
SOLANA
-3
Tron
TRX
-2
Bitcoin Mainnet
BTC
-1
Ethereum Mainnet
ETH
1
Optimism Mainnet
OPTIMISM
10
Cronos Mainnet
CRONOS
25
BNB Smart Chain Mainnet
BSC
56
Gnosis
GNOSIS
100
Polygon Mainnet
POLYGON
137
BitTorrent Chain Mainnet
BITTORRENT
199
Fantom
FANTOM
250
Boba Network
BOBA
288
zkSync Era Mainnet
ZKSYNC ERA
324
CLV Parachain
CLV
1024
Polygon zkEvm
POLYGON ZKEVM
1101
WEMIX3.0 Mainnet
WEMIX
1111
Moonbeam
MOONBEAM
1284
Moonriver
MOONRIVER
1285
Base
BASE
8453
Arbitrum One
ARBITRUM
42161
Celo Mainnet
CELO
42220
Avalanche C-Chain
AVALANCHE
43114
Linea
LINEA
59144
Blast Mainnet
BLAST
81457
Aurora Mainnet
AURORA
1313161554
Subscription
Subscribe to our plan to use this API in your service to help meet the compliance requirements and secure users' assets.
Last updated