1 of 9

v2 (已停用)

description: API的旧版本

v2（已退役）

这是我们API的旧版本。

自2024年7月1日起，我们已停止维护API。请参考最新版本。

如果您对本次迁移有任何疑问，请随时联系我们(ms_support@blocksec.com)。

入门

欢迎来到MetaSleuth API文档！

释放我们的强大API潜力，该API由BlockSec地址标签数据库和风险评估算法驱动。

地址标签API：获取链上地址的详细信息和标签。描述特定地址的身份和活动，帮助您更轻松地理解区块链。
合规评分API：评估地址的风险等级和指标，使您能够更有效地评估合规要求。有效检测、预防与非法资金的交互，符合监管要求。

身份验证

API 密钥是用于访问 API 接口的唯一标识符。所有接口都需要 API 密钥验证才能访问。为了确保您的数据安全，请不要与任何人共享您的 API 密钥。

如何获取 API 密钥？

要生成 API 密钥，请先注册一个 MetaSleuth 账户。注册后，访问设置部分中的 API 面板，您可以轻松生成您的 API 密钥。

如何使用 API 密钥

对于每次 API 请求，请确保在 HTTP 请求头中包含“API-KEY”头，并提供您的 API 密钥作为值。

速率限制

为了防止API过载并确保最佳处理速度和响应时间，我们对API调用实施了访问限制。

地址标签API：限制为每秒5次调用。
合规性评分API：限制为每秒5次调用。

有关基于不同订阅计划的每日请求限制的信息，请参考我们的API定价计划。

支持的链

提交请求时，请使用提供的链名称（不区分大小写）

链

链ID

链名称

Bitcoin

btc

Ethereum

eth

BNB Smart Chain

bsc

TRON

tron

Fantom

250

fantom

Arbitrum One

42161

arbitrum

Avalanche C-Chain

43114

avalanche

Optimism

optimism

Polygon

137

polygon

Cronos

cronos

Base

8453

base

Linea

59144

linea

Moonbeam

1284

moonbeam

Moonriver

1285

moonriver

Polygon zkEVM

1101

polygon zkevm

Celo

42220

celo

CLV

1024

clv

Gnosis

100

gnosis

Bittorrent

199

bittorrent

Boba

288

boba

Wemix3.0

1111

wemix

zkSync Era

324

zksync era

Aurora

1313161554

aurora

API 端点

MetaSleuth API端点概览。

地址标签

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

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

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

每个标签的信任度

```

合规评分

获取单个地址的合规风险信息

GET https://aml.blocksec.com/api/risk/v1/address

路径参数

名称

类型

描述

头部

名称

类型

描述

示例请求

示例响应

code: Integer。错误代码。
- 200: 无错误。
- 其他: 出现错误。
msg: String
- 如果code不是200，此字段表示详细的错误信息。
data: Object

响应数据参数

字段

类型

描述

风险指示器字段的子字段

附录

附录 1: 术语表

实体

指定地址的控制者。对于一个 EOA 地址，实体通常是控制私钥的身份。而对于一个合约，实体通常是具有高权限的部署者或所有者。

次级实体

指定地址的用户，但不控制私钥。例如，交易所为用户分配地址用于存款。用户可以使用这些地址接收付款，但无法访问私钥。

名称标签

作为地址的唯一标识符。

地址属性

用于指示与地址相关的特性，例如‘热钱包’或‘被 USDT 阻止’。

实体属性

用于描述实体所展示的属性，例如‘无 KYC’或‘OFAC 制裁’。

可信度得分

评分范围从 1 到 10。默认情况下，仅返回可信度得分高于 5 的标签。

风险得分

评分范围从 1 到 5。评分为 4 或更高的地址被视为具有显著合规风险。

附录 2: 风险因素类别

风险类别

描述

风险得分

已被攻破

例如，漏洞合约、公开披露的私钥地址等，不建议与此类地址互动。

赌博

支持加密货币的在线赌博平台，提供老虎机及体育/电子竞技博彩等服务。

攻击者

某一安全事件的肇事者，例如，在 Colonial Pipeline 黑客事件中的攻击者地址。

暗网市场

在暗网上出售毒品、被盗账户数据、武器、色情材料、黑客服务等的大型交易平台。

暗网业务

经营一个涉及以下一种或多种业务的暗网站点：毒品、被盗账户、武器、色情材料、黑客服务等。

非法个人 / 组织

参与非法活动，如欺诈、黑客攻击、钓鱼网站、暗网经营等的实体，缺乏准确的身份信息，但由情报来源指明。

混合器

使资金来源和去向模糊的服务。

勒索软件

通过勒索软件进行敲诈的犯罪团伙。

制裁

制裁发布机构管辖范围内的任何人，包括在别处经营的国民或直接在制裁发布主管辖范围内经营的海外公司，不得与受制裁实体进行业务往来。

骗局

由某个骗局（项目）控制的地址，例如，Plus Token 诈骗者的地址。

地址标签

---
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名称，请参见

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

每个标签的信任度

```