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.
OTC DESK	3021	Service providers offering OTC intermediary platforms, e.g., Binance, Coinbase.
GOVERNMENT	3022	Government institutions.
STAKING	3023	Staking-related projects.
STABLE COIN	3024	Stablecoin-related projects, including collateralized and algorithmic stablecoins.
LENDING	3025	Lending platforms.
YIELD FARMING	3026	Yield farming projects.
YIELD AGGREGATOR	3027	Yield aggregators.
DERIVATIVES	3028	Derivative trading platforms.
SERVICES	3029	One-stop DeFi service platforms offering LaunchPad, Staking, Swap, and other services.
LAUNCHPAD	3030	ICO platforms.
INDEXES	3031	Projects similar to traditional finance index funds.
PRIVACY	3032	Protocols that hide transaction information.
SYNTHETICS	3033	Synthetic asset-related projects.
INSURANCE	3034	Insurance-related projects.
SOCIALFI	3035	On-chain social networking.
GAMING	3036	Gaming-related projects.
ORACLE	3037	Projects connecting on-chain and off-chain data.
TRADING	3038	Projects that perform trading or help users trade (trading platforms).
UTILITY TOOL	3039	Practical blockchain tools for token management, distribution, etc.
NFT	3040	NFT projects.
DAO	3041	DAO organizations.
SCAM	3042	Scam-related groups.
LIQUIDITY MANAGER	3043	Liquidity management projects.
Options	3044	Options-related projects.
RWA	3045	Real-world asset-related projects.
RESERVE CURRENCY	3046	Reserve currency-related projects.
INDIVIDUAL	3047	Individual related accounts.
CELEBRITY	3048	Celebrities, etc.

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.
SUSPICIOUS	4017	Addresses showing unusual patterns that may indicate illegal activities or money laundering attempts.However, it is not currently possible to determine what type of illegal activity this is.
EXPLOIT	4018	Address involved in one or more attacks.
WHITE HAT	4019	The 'White Hat' attribute designates an address associated with individuals or entities known for ethical practices in cybersecurity, typically engaging in activities that aid in identifying and resolving security vulnerabilities lawfully and constructively.

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.