1 of 2

地址标签 API

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

地址标签

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

实体

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

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

为一个地址分配实体主要是为了在加密货币地址与已知组织或个人之间建立联系。然而，某些情况下，一个地址可以与多个实体相关联。在这些情况下，我们将分配 主要实体和补充实体。

例如，考虑 Alameda 在 Binance 的存款地址。我们可以说明 Binance 控制该地址的私钥，或者该地址被 Alameda 使用。在这种情况下，我们将 Binance 设定为该地址的主要实体，同时将 Alameda 视为次要或补充实体。

实体类别

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

特征

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

名称标签

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

支持的网络

地址标签 API 支持 25 条不同的链，列于下表中。我们还提供一个 API，允许您获取所有支持链的列表，让您能够及时了解任何新增链。

在发出 API 请求时，请使用 Chain ID 指定所需的链。

网络名称

简称

Chain ID

Solana

SOLANA

-3

Tron

TRX

-2

Bitcoin Mainnet

BTC

-1

Ethereum Mainnet

ETH

Optimism Mainnet

OPTIMISM

Cronos Mainnet

CRONOS

BNB Smart Chain Mainnet

BSC

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

API

获取支持的链

获取地址标签

注意：如果您查询的地址在指定的区块链上没有标签，API将返回该地址在兼容链上的标签信息。

例如，如果您请求Ethereum链上地址"0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43"的标签信息，而我们没有该地址在Ethereum上的标签信息，API会检查EVM兼容链上的标签信息。如果该地址在任何兼容链上有标签信息，API会返回所有兼容链上的地址标签。

注意：此操作将被视为单次API调用，返回来自多个兼容链的信息不会导致被多次计点。

请求参数：

{
  "chain_id": 1,
  "address": "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43"
}

响应：

{
    "request_id": "c9d690acba6d466d",
    "code": 200000,
    "message": "Success",
    "data": {
        "chain_id": 1,
        "address": "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43",
        "main_entity": "",
        "comp_entities": null,
        "name_tag": "",
        "attributes": null,
        "compatible_chains": [
            {
                "chain_id": 10,
                "address": "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43",
                "main_entity": "",
                "comp_entities": null,
                "name_tag": "Sonne Finance Exploiter",
                "attributes": [
                    {
                        "name": "ATTACKER",
                        "code": 4001,
                        "comp_info": [
                            "EXPLOIT"
                        ]
                    }
                ]
            }
        ]
    }
}

您可以注意到响应结构包含了一个额外的compatible_chains字段，该字段存储了关于兼容链上的地址信息。这个字段被结构化为一个数组，包含了地址在多个兼容链上的标签信息。

批量获取地址标签

获取实体信息

地址标签 API

地址标签

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

实体

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

实体类别

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

特征

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

名称标签

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

支持的网络

地址标签 API 支持 25 条不同的链，列于下表中。我们还提供一个 API，允许您获取所有支持链的列表，让您能够及时了解任何新增链。

在发出 API 请求时，请使用 Chain ID 指定所需的链。

网络名称

简称

Chain ID

Solana

SOLANA

-3

Tron

TRX

-2

Bitcoin Mainnet

BTC

-1

Ethereum Mainnet

ETH

Optimism Mainnet

OPTIMISM

Cronos Mainnet

CRONOS

BNB Smart Chain Mainnet

BSC

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

API

获取支持的链

Get the list of supported chains for the Address Labels APIs.

GEThttps://aml.blocksec.com/address-label/api/v3/chain-list

Authorization

Header parameters

API-KEY*string

Response

A successful request

Body

request_idstring

Example: "a11b2d3cf7834e0f"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

chain_idinteger

Unique identifier for the chain. In accordance with the chain IDs listed in the 'Supported Networks' section.

chain_namestring

The short name of the chain. In accordance with the short names listed in the 'Supported Networks' section.

Request

Response

获取地址标签

Retrieve detailed label information of a specific address on a particular chain.

POSThttps://aml.blocksec.com/address-label/api/v3/labels

Authorization

Header parameters

API-KEY*string

Body

chain_idinteger

Chain ID. Please refer to the 'Supported Networks' section for specific IDs.

addressstring

The specific address you want to query. EVM addresses are case-insensitive, while non-EVM addresses are case-sensitive.

Response

A successful request

Body

request_idstring

Example: "5e2edad6d5154daf"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataobject

addressstring

The queried address.

Example: "0x3d12e63d4313f850d23cead57ef0c29e94c9551d"

main_entitystring

The primary entity associated with the address.

Example: "BINANCE"

comp_entitiesarray of string

Complementary entities associated with the address.

itemsstring

Example: "ALAMEDA RESEARCH"

attributesarray of object

A list of attributes associated with the address. The structure of each attribute is as follows.

namestring

Attribute string

Example: "DEPOSIT ADDRESS"

codeinteger

Attribute code

Example: 4007

comp_infoarray of string

A supplementary description for the assigned attribute to this address.

itemsstring

Example: "BINANCE DEPOSIT ADDRESS"

name_tagstring

The name tag

Example: "Binance_Deposit_0x3d12"

Request

Response

注意：如果您查询的地址在指定的区块链上没有标签，API将返回该地址在兼容链上的标签信息。

注意：此操作将被视为单次API调用，返回来自多个兼容链的信息不会导致被多次计点。

请求参数：

{
  "chain_id": 1,
  "address": "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43"
}

响应：

{
    "request_id": "c9d690acba6d466d",
    "code": 200000,
    "message": "Success",
    "data": {
        "chain_id": 1,
        "address": "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43",
        "main_entity": "",
        "comp_entities": null,
        "name_tag": "",
        "attributes": null,
        "compatible_chains": [
            {
                "chain_id": 10,
                "address": "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43",
                "main_entity": "",
                "comp_entities": null,
                "name_tag": "Sonne Finance Exploiter",
                "attributes": [
                    {
                        "name": "ATTACKER",
                        "code": 4001,
                        "comp_info": [
                            "EXPLOIT"
                        ]
                    }
                ]
            }
        ]
    }
}

批量获取地址标签

Retrieve detailed label information of a list of addresses on a particular chain.

POSThttps://aml.blocksec.com/address-label/api/v3/batch-labels

Header parameters

API-KEY*string

Body

chain_idinteger

Chain ID. Please refer to the 'Supported Networks' section for specific IDs.

addressesarray of string

A list of specific addresses you want to query. A maximum of 100 addresses can be included in a single request. EVM addresses are case-insensitive, while non-EVM addresses are case-sensitive.

itemsstring

Response

A successful request

Body

request_idstring

Example: "afe065e89fbb4106"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

addressstring

The queried address.

main_entitystring

The primary entity associated with the address.

comp_entitiesarray of string

Complementary entities associated with the address.

itemsstring

attributesarray of object

A list of attributes associated with the address. The structure of each attribute is as follows.

namestring

Attribute string

codeinteger

Attribute code

Example: 4007

comp_infoarray of string

A supplementary description for the assigned attribute to this address.

itemsstring

name_tagstring

The name tag

Request

Response

获取实体信息

POSThttps://aml.blocksec.com/address-label/api/v3/entity

Authorization

Header parameters

API-KEY*string

Body

entitystring

The name of the entity you want to query. Querying is only supported for entities returned by the labels API, and it is case-insensitive.

Response

A successful request

Body

request_idstring

codeinteger

messagestring

dataobject

entitystring

Entity names

Example: "TORNADO.CASH"

categoriesarray of object

List all categories to which the entity can be categorized. The structure of each category is as follows.

namestring

Category string

Example: "MIXER"

codeinteger

Category code

Example: 3017

attributesarray of object

A list of attributes associated with the entity. The structure of each attribute is as follows.

namestring

Attribute string

Example: "SANCTIONED"

codeinteger

Attribute code

Example: 4015

comp_infoarray of string

A supplementary description for the assigned attribute to this entity.

itemsstring

Example: "OFAC SANCTIONED"

Request

Response

POSThttps://aml.blocksec.com/address-label/api/v3/entity

Authorization

Header parameters

API-KEY*string

Body

entitystring

The name of the entity you want to query. Querying is only supported for entities returned by the labels API, and it is case-insensitive.

Response

A successful request

Body

request_idstring

codeinteger

messagestring

dataobject

entitystring

Entity names

Example: "TORNADO.CASH"

categoriesarray of object

List all categories to which the entity can be categorized. The structure of each category is as follows.

namestring

Category string

Example: "MIXER"

codeinteger

Category code

Example: 3017

attributesarray of object

A list of attributes associated with the entity. The structure of each attribute is as follows.

namestring

Attribute string

Example: "SANCTIONED"

codeinteger

Attribute code

Example: 4015

comp_infoarray of string

A supplementary description for the assigned attribute to this entity.

itemsstring

Example: "OFAC SANCTIONED"

Request

Response

Retrieve detailed label information of a specific address on a particular chain.

POSThttps://aml.blocksec.com/address-label/api/v3/labels

Authorization

Header parameters

API-KEY*string

Body

chain_idinteger

Chain ID. Please refer to the 'Supported Networks' section for specific IDs.

addressstring

The specific address you want to query. EVM addresses are case-insensitive, while non-EVM addresses are case-sensitive.

Response

A successful request

Body

request_idstring

Example: "5e2edad6d5154daf"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataobject

addressstring

The queried address.

Example: "0x3d12e63d4313f850d23cead57ef0c29e94c9551d"

main_entitystring

The primary entity associated with the address.

Example: "BINANCE"

comp_entitiesarray of string

Complementary entities associated with the address.

itemsstring

Example: "ALAMEDA RESEARCH"

attributesarray of object

A list of attributes associated with the address. The structure of each attribute is as follows.

namestring

Attribute string

Example: "DEPOSIT ADDRESS"

codeinteger

Attribute code

Example: 4007

comp_infoarray of string

A supplementary description for the assigned attribute to this address.

itemsstring

Example: "BINANCE DEPOSIT ADDRESS"

name_tagstring

The name tag

Example: "Binance_Deposit_0x3d12"

Request

Response

Retrieve detailed label information of a list of addresses on a particular chain.

POSThttps://aml.blocksec.com/address-label/api/v3/batch-labels

Header parameters

API-KEY*string

Body

chain_idinteger

Chain ID. Please refer to the 'Supported Networks' section for specific IDs.

addressesarray of string

A list of specific addresses you want to query. A maximum of 100 addresses can be included in a single request. EVM addresses are case-insensitive, while non-EVM addresses are case-sensitive.

itemsstring

Response

A successful request

Body

request_idstring

Example: "afe065e89fbb4106"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

addressstring

The queried address.

main_entitystring

The primary entity associated with the address.

comp_entitiesarray of string

Complementary entities associated with the address.

itemsstring

attributesarray of object

A list of attributes associated with the address. The structure of each attribute is as follows.

namestring

Attribute string

codeinteger

Attribute code

Example: 4007

comp_infoarray of string

A supplementary description for the assigned attribute to this address.

itemsstring

name_tagstring

The name tag

Request

Response

地址标签 API

地址标签

实体

实体类别

特征

名称标签

支持的网络

订阅

API

订阅

获取支持的链

获取地址标签

批量获取地址标签

获取实体信息

地址标签 API

地址标签

实体

实体类别

特征

名称标签

支持的网络

订阅

API

订阅

获取支持的链

Get the list of supported chains for the Address Labels APIs.

获取地址标签

Retrieve detailed label information of a specific address on a particular chain.

批量获取地址标签

Retrieve detailed label information of a list of addresses on a particular chain.

获取实体信息

Get the list of supported chains for the Address Labels APIs.

Retrieve detailed label information of a specific address on a particular chain.

Retrieve detailed label information of a list of addresses on a particular chain.