# 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](#supported-networks) 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).

{% hint style="info" %}
**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**.
{% endhint %}

#### 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.

<table><thead><tr><th width="172">Category</th><th width="92">Code</th><th>Description</th></tr></thead><tbody><tr><td>ASSET MANAGEMENT</td><td>3001</td><td>Financial institutions that specialize in managing and investing assets on behalf of clients.</td></tr><tr><td>BRIDGE</td><td>3002</td><td>Protocols that facilitate the movement of assets and data between different blockchain networks.</td></tr><tr><td>CHILD ABUSE MATERIAL</td><td>3003</td><td>Forums and websites that facilitate the buying, selling, and distribution of child abuse material.</td></tr><tr><td>CLOUD MINING</td><td>3004</td><td>Services that allow individuals to rent processing power from remote data centers to mine cryptocurrency without managing physical hardware.</td></tr><tr><td>DAPP</td><td>3005</td><td>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.</td></tr><tr><td>DARK MARKET</td><td>3006</td><td>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.</td></tr><tr><td>DEFI</td><td>3007</td><td>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.</td></tr><tr><td>DEX</td><td>3008</td><td>Peer-to-peer marketplaces where transactions occur directly between crypto traders.</td></tr><tr><td>DEX AGGREGATOR</td><td>3009</td><td>A platform that sources liquidity from various decentralized exchanges to provide optimal trade execution in terms of price and slippage</td></tr><tr><td>ECOMMERCE</td><td>3010</td><td>E-commerce platforms that support cryptocurrencies.</td></tr><tr><td>EXCHANGE</td><td>3011</td><td>Centralized platforms that enable individuals to buy, sell, and trade various cryptocurrencies.</td></tr><tr><td>FAUCET</td><td>3012</td><td>An app or a website that distributes small amounts of cryptocurrencies as a reward for completing easy tasks.</td></tr><tr><td>GAMBLING</td><td>3013</td><td>Online platforms that allow users to gamble using cryptocurrencies.</td></tr><tr><td>INFRASTRUCTURE</td><td>3014</td><td>Basic services or programs deployed on the blockchain, such as the ENS (Ethereum Name Service) service and Solana system programs.</td></tr><tr><td>NFT MARKETPLACE</td><td>3015</td><td>Platforms that facilitate the buying, selling, and creation of Non-Fungible Tokens (NFTs).</td></tr><tr><td>MINING POOL</td><td>3016</td><td>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.</td></tr><tr><td>MIXER</td><td>3017</td><td>A service that blends the cryptocurrencies of many users together to obfuscate the origins and owners of the funds.</td></tr><tr><td>PAYMENT PROCESSOR</td><td>3018</td><td>A service that processes payments in digital currencies and allows merchants to accept cryptocurrency payments.</td></tr><tr><td>RANSOMWARE</td><td>3019</td><td>Criminal gangs conducting extortion through ransomware.</td></tr><tr><td>WALLET</td><td>3020</td><td>Softwares or hardwares that enable users to store and use cryptocurrency.</td></tr><tr><td>OTC DESK</td><td>3021</td><td>Service providers offering OTC intermediary platforms, e.g., Binance, Coinbase.</td></tr><tr><td>GOVERNMENT</td><td>3022</td><td>Government institutions.</td></tr><tr><td>STAKING</td><td>3023</td><td>Staking-related projects.</td></tr><tr><td>STABLE COIN</td><td>3024</td><td>Stablecoin-related projects, including collateralized and algorithmic stablecoins.</td></tr><tr><td>LENDING</td><td>3025</td><td>Lending platforms.</td></tr><tr><td>YIELD FARMING</td><td>3026</td><td>Yield farming projects.</td></tr><tr><td>YIELD AGGREGATOR</td><td>3027</td><td>Yield aggregators.</td></tr><tr><td>DERIVATIVES</td><td>3028</td><td>Derivative trading platforms.</td></tr><tr><td>SERVICES</td><td>3029</td><td>One-stop DeFi service platforms offering LaunchPad, Staking, Swap, and other services.</td></tr><tr><td>LAUNCHPAD</td><td>3030</td><td>ICO platforms.</td></tr><tr><td>INDEXES</td><td>3031</td><td>Projects similar to traditional finance index funds.</td></tr><tr><td>PRIVACY</td><td>3032</td><td>Protocols that hide transaction information.</td></tr><tr><td>SYNTHETICS</td><td>3033</td><td>Synthetic asset-related projects.</td></tr><tr><td>INSURANCE</td><td>3034</td><td>Insurance-related projects.</td></tr><tr><td>SOCIALFI</td><td>3035</td><td>On-chain social networking.</td></tr><tr><td>GAMING</td><td>3036</td><td>Gaming-related projects.</td></tr><tr><td>ORACLE</td><td>3037</td><td>Projects connecting on-chain and off-chain data.</td></tr><tr><td>TRADING</td><td>3038</td><td>Projects that perform trading or help users trade (trading platforms).</td></tr><tr><td>UTILITY TOOL</td><td>3039</td><td>Practical blockchain tools for token management, distribution, etc.</td></tr><tr><td>NFT</td><td>3040</td><td>NFT projects.</td></tr><tr><td>DAO</td><td>3041</td><td>DAO organizations.</td></tr><tr><td>SCAM</td><td>3042</td><td>Scam-related groups.</td></tr><tr><td>LIQUIDITY MANAGER</td><td>3043</td><td>Liquidity management projects.</td></tr><tr><td>Options</td><td>3044</td><td>Options-related projects.</td></tr><tr><td>RWA</td><td>3045</td><td>Real-world asset-related projects.</td></tr><tr><td>RESERVE CURRENCY</td><td>3046</td><td>Reserve currency-related projects.</td></tr><tr><td>INDIVIDUAL</td><td>3047</td><td>Individual related accounts.</td></tr><tr><td>CELEBRITY</td><td>3048</td><td>Celebrities, etc.</td></tr><tr><td>TERRORIST</td><td>3049</td><td>Entities that use violence or threats to intimidate populations or governments for political or ideological aims.</td></tr></tbody></table>

### 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.

<table><thead><tr><th width="163">Attribute</th><th width="92">Code</th><th>Description</th></tr></thead><tbody><tr><td>ATTACKER</td><td>4001</td><td>Addresses involved in attack events, such as contract exploits, private key hacks, or extortions.</td></tr><tr><td>BLOCKED</td><td>4002</td><td>Addresses that have been blocked by critical contracts, primarily USDT and USDC.</td></tr><tr><td>COLD WALLET</td><td>4004</td><td>A cold wallet refers to a type of cryptocurrency wallet that is stored offline and is not connected to the internet.</td></tr><tr><td>DARKWEB BUSINESS</td><td>4006</td><td>Addresses involved in dark web businesses, encompassing activities such as drugs, weapons, abuse, and other illicit practices.</td></tr><tr><td>DEPOSIT ADDRESS</td><td>4007</td><td>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.</td></tr><tr><td>HOT WALLET</td><td>4009</td><td>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.</td></tr><tr><td>LAUNDERING</td><td>4011</td><td>The addresses and entities associated with this attribute are believed to engage in money laundering activities.</td></tr><tr><td>MIXING</td><td>4012</td><td>This label is attributed to services or addresses (primarily contracts) that are believed to possess the capability to obfuscate fund flows.</td></tr><tr><td>NO KYC</td><td>4013</td><td>The VASP (Virtual Asset Service Provider) associated with the address does not have a KYC (Know Your Customer) procedure in place.</td></tr><tr><td>RETURN FUNDS</td><td>4014</td><td>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.</td></tr><tr><td>SANCTIONED</td><td>4015</td><td>The cryptocurrency address associated with individuals or organizations subject to sanctions.</td></tr><tr><td>SCAM</td><td>4016</td><td>The addresses associated with individuals or organizations involved in fraudulent activities, including phishing, honeypots, Ponzi schemes, and more.</td></tr><tr><td>SUSPICIOUS</td><td>4017</td><td>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.</td></tr><tr><td>EXPLOIT</td><td>4018</td><td>Address involved in one or more attacks.</td></tr><tr><td>WHITE HAT</td><td>4019</td><td>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.</td></tr></tbody></table>

### 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 [APIs](https://docs.metasleuth.io/blocksec-aml-api/apis#get-supported-chains) that allows you to retrieve a list of all supported chains, enabling you to stay informed about any newly added chains.

{% hint style="info" %}
When making an API request, please use the **Chain ID** to specify the desired chain.
{% endhint %}

| 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

{% hint style="success" %}
Subscribe to [our plan](https://metasleuth.io/plans#apis) to use this API in your service to help meet the compliance requirements and secure users' assets.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.metasleuth.io/blocksec-aml-api/address-label-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.