地址标签

---
layout:
  title:
    visible: true
  description:
    visible: true
  tableOfContents:
    visible: true
  outline:
    visible: true
  pagination:
    visible: false
---

# 地址标签

## 获取单个地址的标签

返回目标地址的标签信息

<mark style="color:blue;">`GET`</mark> `https://aml.blocksec.com/api/aml/v2/address`

#### 路径参数

| 名称                                      | 类型   | 描述                                                                    |
| ----------------------------------------- | ------ | ----------------------------------------------------------------------- |
| chain<mark style="color:red;">\*</mark>   | String | blockchain名称，请参见[支持的chains](../getting-started/supported-chains.md) |
| address<mark style="color:red;">\*</mark> | String | 目标地址                                                                |

#### 请求头

| 名称                                      | 类型   | 描述       |
| ----------------------------------------- | ------ | ---------- |
| API-KEY<mark style="color:red;">\*</mark> | String | 您的API密钥 |

<div data-gb-custom-block data-tag="tabs">

<div data-gb-custom-block data-tag="tab" data-title='请求'>

<div data-gb-custom-block data-tag="code" data-overflow='wrap'>

```powershell
curl --location 'https://aml.blocksec.com/api/aml/v2/address/eth/0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff' \
--header 'API-KEY: $ApiKey'

示例响应

{
    "code": 200,
    "data": [
        {
            "address": "0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": false,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "HUOBI",
                        "category": "CEX",
                        "confidence": 8
                    }
                ],
                "property_info": [
                    {
                        "address_property": "DEPOSIT ADDRESS",
                        "confidence": 8
                    },
                    {
                        "address_property": "EXPLOIT",
                        "category": "ATTACKER",
                        "confidence": 9
                    }
                ],
                "name_tag": "Ronin Bridge Exploiter 27",
                "others": [
                    {
                        "label": "RONIN BRIDGE EXPLOIT",
                        "confidence": 9
                    }
                ]
            },
            "risk": 5
        }
    ]
}

code: Integer。错误代码。
- 200：无错误。
- 其他：发生错误。
msg: String
- 如果code不是200，则此字段表示详细的错误信息。
data: Array
- 请求地址的标签信息列表。详情请参见响应数据参数。

获取多个地址的标签

GET https://aml.blocksec.com/api/aml/v2/addresses

路径参数

名称

类型

描述

chain*

String

blockchain名称，请参见支持的chains

addresses*

String

目标地址，使用“, ”连接成一个字符串。单个请求中的地址数量不应超过100。

请求头

名称

类型

描述

API-KEY*

String

您的API密钥

示例请求

curl --location 'https://aml.blocksec.com/api/aml/v2/addresses/eth/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0x0191e884bf8e21e138e161da520f94d4bbc79c1c' \
--header 'API-KEY: $ApiKey'

示例响应

{
    "code": 200,
    "data": [
        {
            "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": true,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "CENTRE",
                        "confidence": 9
                    }
                ],
                "contract_info": {
                    "contract_name": "FiatTokenProxy",
                    "token_name": "USD Coin (USDC)"
                },
                "name_tag": "Circle: USDC Token",
                "others": [
                    {
                        "label": "CIRCLE",
                        "confidence": 9
                    },
                    {
                        "label": "STABLECOIN",
                        "confidence": 9
                    },
                    {
                        "label": "TOKEN CONTRACT",
                        "confidence": 9
                    },
                    {
                        "label": "USDC",
                        "confidence": 9
                    }
                ]
            },
            "risk": 2
        },
        {
            "address": "0x8672867cb976c723d600d810b419d439133fca7a",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": true,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "BITTREX",
                        "category": "CEX",
                        "confidence": 9
                    }
                ],
                "property_info": [
                    {
                        "address_property": "DEPOSIT ADDRESS",
                        "confidence": 9
                    }
                ],
                "contract_info": {
                    "contract_name": "UserWallet"
                }
            },
            "risk": 1
        }
    ]
}

响应格式与单地址查询返回的结果一致。

code: Integer。错误代码。
- 200：无错误。
- 其他：发生错误。
msg: String
- 如果code不是200，则此字段表示详细的错误信息。
data: Array
- 请求地址的标签信息列表。详情请参见响应数据参数。

响应数据参数

字段

类型

描述

address

String

目标地址

is_address_valid

Boolean

地址是否符合目标blockchain的地址格式

chain

String

目标blockchain

is_contract

Boolean

目标地址是否为合约

*labels

Object

标签信息，详情参见标签字段的子字段

compatible_chain_labels

Array

如果目标chain没有信息，则返回兼容chains上的标签信息。详情参见标签字段的子字段

risk

Integer

风险评分

对于斜体字，请参见附录 1: 词汇表以获取解释。

标签字段的子字段

字段

类型

描述

chain

String

地址所属的chain。适用于compatible_chain_labels

entity_info

Object

实体信息，子字段如下

> entity_type

String

‘first’表示实体, ‘second’表示二级实体

> entity

String

实体的名称

> category

String

实体的类别

> entity_property

String

实体属性

> confidence

Integer

实体信息的信任度

property_info

Object

属性信息，子字段如下

> address_property

String

地址属性

> category

String

地址属性的类别

> confidence

Integer

地址属性的信任度

contract_info

Object

如果是合约地址，则为合约信息，子字段如下

> contract_name

String

合约名称

> token_name

String

如果是token合约，则为token名称

name_tag

String

名称标签

others

Array

标签信息列表，子字段如下

> label

String

不属于上述字段的标签

> confidence

Integer

每个标签的信任度

```

PreviousAPI 端点 Next合规评分

Last updated 5 days ago