> For the complete documentation index, see [llms.txt](https://docs.metasleuth.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metasleuth.io/zh_cn/blocksec-fan-xi-qian-api/address-label-api.md).

# 地址标签 API

地址标签 API 使用户能够获取地址标签，并从多个角度全面理解地址。[它目前支持超过 25](#zhi-chi-de-wang-luo) 条不同的区块链，包括 Solana、Bitcoin、Tron、Ethereum、BSC 和其他 EVM 兼容链。

## 地址标签 <a href="#di-zhi-biao-qian" id="di-zhi-biao-qian"></a>

在使用我们的 API 查询地址时，**我们将返回三种类型的标签来描述该地址**。

### 实体

我们使用 ***Entity*** 来描述地址的所有者或控制者。如果是一个 EoA 地址，这意味着控制该 EoA 地址的实体（掌握私钥）。对于智能合约，实体可以指代其部署者（项目）。

**一个地址可能有多个实体。**

> 为一个地址分配实体主要是为了在加密货币地址与已知组织或个人之间建立联系。然而，某些情况下，一个地址可以与多个实体相关联。在这些情况下，我们将分配 **主要实体和补充实体**。
>
> 例如，考虑 Alameda 在 Binance 的存款地址。我们可以说明 Binance 控制该地址的私钥，或者该地址被 Alameda 使用。在这种情况下，**我们将 Binance 设定为该地址的主要实体，同时将 Alameda 视为次要或补充实体**。

#### 实体类别

大多数实体是组织或服务，仅有少数代表个人。大多数实体被分类为以下类别，这可以帮助您了解它们的性质。

<table><thead><tr><th width="172">类别</th><th width="92">代码</th><th>描述</th></tr></thead><tbody><tr><td>ASSET MANAGEMENT</td><td>3001</td><td>专门代表客户管理和投资资产的金融机构。</td></tr><tr><td>BRIDGE</td><td>3002</td><td>促进资产和数据在不同区块链网络之间流动的协议。</td></tr><tr><td>CHILD ABUSE MATERIAL</td><td>3003</td><td>协助买卖和传播儿童虐待材料的论坛和网站。</td></tr><tr><td>CLOUD MINING</td><td>3004</td><td>允许个人租用远程数据中心的算力来挖掘加密货币，而无需自行管理硬件的服务。</td></tr><tr><td>DAPP</td><td>3005</td><td>去中心化应用（dApp）是在去中心化网络上开发的应用，结合智能合约与用户界面。如果 dApp 不属于 DEFI 等特定类别，则归入这一通用类别；未来新增类别后，也可能重新分类。</td></tr><tr><td>DARK MARKET</td><td>3006</td><td>协助买卖非法商品和服务的暗网网站，涉及毒品、武器、假币和被盗数据等。</td></tr><tr><td>DEFI</td><td>3007</td><td>DeFi 应用即去中心化金融应用，在公有区块链上提供点对点金融服务。如果 DeFi dApp 不属于 DEX（去中心化交易所）等特定类别，则归入这一通用类别；未来新增类别后，也可能重新分类。</td></tr><tr><td>DEX</td><td>3008</td><td>加密货币交易者之间直接进行交易的点对点市场。</td></tr><tr><td>DEX AGGREGATOR</td><td>3009</td><td>从多个去中心化交易所获取流动性，以在价格和滑点方面提供最优交易执行的平台。</td></tr><tr><td>ECOMMERCE</td><td>3010</td><td>支持加密货币的电子商务平台。</td></tr><tr><td>EXCHANGE</td><td>3011</td><td>供个人买卖和交易各类加密货币的中心化平台。</td></tr><tr><td>FAUCET</td><td>3012</td><td>向完成简单任务的用户发放少量加密货币作为奖励的应用或网站。</td></tr><tr><td>GAMBLING</td><td>3013</td><td>允许用户使用加密货币进行赌博的在线平台。</td></tr><tr><td>INFRASTRUCTURE</td><td>3014</td><td>部署在区块链上的基础服务或程序，例如 ENS（以太坊域名服务）和 Solana 系统程序。</td></tr><tr><td>NFT MARKETPLACE</td><td>3015</td><td>支持非同质化代币（NFT）买卖和创建的平台。</td></tr><tr><td>MINING POOL</td><td>3016</td><td>多个独立的加密货币矿工汇集资源，以提高获得区块奖励概率的矿池。</td></tr><tr><td>MIXER</td><td>3017</td><td>将多个用户的加密货币混合，以掩盖资金来源和所有者的服务。</td></tr><tr><td>PAYMENT PROCESSOR</td><td>3018</td><td>处理数字货币支付，并使商家能够接受加密货币付款的服务。</td></tr><tr><td>RANSOMWARE</td><td>3019</td><td>利用勒索软件进行敲诈勒索的犯罪团伙。</td></tr><tr><td>WALLET</td><td>3020</td><td>供用户存储和使用加密货币的软件或硬件。</td></tr><tr><td>OTC DESK</td><td>3021</td><td>提供 OTC 中介平台的服务商，例如 Binance、Coinbase。</td></tr><tr><td>GOVERNMENT</td><td>3022</td><td>政府机构。</td></tr><tr><td>STAKING</td><td>3023</td><td>质押相关项目。</td></tr><tr><td>STABLE COIN</td><td>3024</td><td>稳定币相关项目，包括抵押型和算法型稳定币。</td></tr><tr><td>LENDING</td><td>3025</td><td>借贷平台。</td></tr><tr><td>YIELD FARMING</td><td>3026</td><td>收益耕作相关项目。</td></tr><tr><td>YIELD AGGREGATOR</td><td>3027</td><td>收益聚合器。</td></tr><tr><td>DERIVATIVES</td><td>3028</td><td>衍生品交易平台。</td></tr><tr><td>SERVICES</td><td>3029</td><td>提供 LaunchPad、Staking、Swap 等服务的一站式 DeFi 平台。</td></tr><tr><td>LAUNCHPAD</td><td>3030</td><td>ICO 平台。</td></tr><tr><td>INDEXES</td><td>3031</td><td>类似传统金融指数基金的项目。</td></tr><tr><td>PRIVACY</td><td>3032</td><td>隐藏交易信息的协议。</td></tr><tr><td>SYNTHETICS</td><td>3033</td><td>合成资产相关项目。</td></tr><tr><td>INSURANCE</td><td>3034</td><td>保险相关项目。</td></tr><tr><td>SOCIALFI</td><td>3035</td><td>链上社交网络。</td></tr><tr><td>GAMING</td><td>3036</td><td>游戏相关项目。</td></tr><tr><td>ORACLE</td><td>3037</td><td>连接链上和链下数据的项目。</td></tr><tr><td>TRADING</td><td>3038</td><td>执行交易或帮助用户交易的项目（交易平台）。</td></tr><tr><td>UTILITY TOOL</td><td>3039</td><td>用于代币管理、分发等用途的实用区块链工具。</td></tr><tr><td>NFT</td><td>3040</td><td>NFT 项目。</td></tr><tr><td>DAO</td><td>3041</td><td>DAO 组织。</td></tr><tr><td>SCAM</td><td>3042</td><td>与诈骗有关的团体。</td></tr><tr><td>LIQUIDITY MANAGER</td><td>3043</td><td>流动性管理项目。</td></tr><tr><td>Options</td><td>3044</td><td>期权相关项目。</td></tr><tr><td>RWA</td><td>3045</td><td>现实世界资产相关项目。</td></tr><tr><td>RESERVE CURRENCY</td><td>3046</td><td>储备货币相关项目。</td></tr><tr><td>INDIVIDUAL</td><td>3047</td><td>与个人有关的账户。</td></tr><tr><td>CELEBRITY</td><td>3048</td><td>名人等。</td></tr><tr><td>TERRORIST</td><td>3049</td><td>为实现政治或意识形态目标，使用暴力或威胁恐吓民众或政府的实体。</td></tr></tbody></table>

### 特征

我们使用 ***Attribute*** 来描述与特定地址或实体相关的行为或动作。所有特征均列在下表中。

<table><thead><tr><th width="172">属性</th><th width="92">代码</th><th>描述</th></tr></thead><tbody><tr><td>ATTACKER</td><td>4001</td><td>涉及攻击事件的地址，例如合约漏洞利用、私钥被盗或敲诈勒索。</td></tr><tr><td>BLOCKED</td><td>4002</td><td>被关键合约封锁的地址，主要涉及 USDT 和 USDC。</td></tr><tr><td>COLD WALLET</td><td>4004</td><td>冷钱包是离线存储、不连接互联网的加密货币钱包。</td></tr><tr><td>DARKWEB BUSINESS</td><td>4006</td><td>涉及暗网业务的地址，包括毒品、武器、虐待及其他非法活动。</td></tr><tr><td>DEPOSIT ADDRESS</td><td>4007</td><td>这里的充值地址指中心化平台用来接收用户充值的地址，通常每位用户会获分配一个专属地址。</td></tr><tr><td>HOT WALLET</td><td>4009</td><td>热钱包是连接互联网、用于交易和日常加密货币管理的钱包。</td></tr><tr><td>LAUNDERING</td><td>4011</td><td>与此属性关联的地址和实体被认为参与洗钱活动。</td></tr><tr><td>MIXING</td><td>4012</td><td>此标签用于被认为具有掩盖资金流向能力的服务或地址，主要是合约。</td></tr><tr><td>NO KYC</td><td>4013</td><td>与地址关联的 VASP（虚拟资产服务提供商）未实施 KYC（了解你的客户）程序。</td></tr><tr><td>RETURN FUNDS</td><td>4014</td><td>用于实施攻击或漏洞利用、随后返还资金的地址。相关人员可能是白帽黑客，或已与项目团队达成和解。</td></tr><tr><td>SANCTIONED</td><td>4015</td><td>与受制裁的个人或组织关联的加密货币地址。</td></tr><tr><td>SCAM</td><td>4016</td><td>与参与诈骗活动的个人或组织关联的地址，涉及钓鱼、蜜罐、庞氏骗局等。</td></tr><tr><td>SUSPICIOUS</td><td>4017</td><td>呈现异常模式、可能涉及非法活动或洗钱企图的地址；目前尚无法确定具体的非法活动类型。</td></tr><tr><td>EXPLOIT</td><td>4018</td><td>涉及一次或多次攻击的地址。</td></tr><tr><td>WHITE HAT</td><td>4019</td><td>WHITE HAT 属性标识与遵循网络安全道德规范的个人或实体关联的地址；这些个人或实体通常以合法、建设性的方式协助发现和解决安全漏洞。</td></tr></tbody></table>

### 名称标签

名称用于以人类可读的信息描述一个加密货币地址。命名通常考虑到与地址相关的实体及其特定特征，例如 Binance 热钱包 1 或 Vitalik 2。

## 支持的网络 <a href="#zhi-chi-de-wang-luo" id="zhi-chi-de-wang-luo"></a>

地址标签 API 支持 25 条不同的链，列于下表中。我们还提供一个 [API](/zh_cn/blocksec-fan-xi-qian-api/address-label-api/apis.md#get-supported-chains)，允许您获取所有支持链的列表，让您能够及时了解任何新增链。

{% hint style="info" %}
在发出 API 请求时，请使用 **Chain ID** 指定所需的链。
{% endhint %}

| 网络名称                     | 简称            | 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 |

## 订阅

{% hint style="success" %}
订阅 [我们的计划](https://metasleuth.io/plans#apis) 以使用此 API，在您的服务中帮助满足合规性要求并保护用户资产。
{% endhint %}