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.
| Category | Code | Description |
|---|---|---|
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.
| Attribute | Code | Description |
|---|---|---|
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.
| Network Name | Short Name | Chain ID |
|---|---|---|
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