1 of 9

v2 （已淘汰）

舊版 API

這是我們 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 | 鏈名稱，參見[支持的鏈](../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='Request'>

<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：無錯誤。
- other：發生錯誤。
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：無錯誤。
- other：發生錯誤。
msg: String
- 如果code不是200，則此字段表示详细的错误信息。
data: Array
- 请求地址的标签信息列表。詳見响应数据参数。

响应数据参数

字段

类型

描述

address

String

目标地址

is_address_valid

Boolean

地址是否符合目标区块链的地址格式

chain

String

目标区块链

is_contract

Boolean

目标地址是否为合约

*labels

Object

compatible_chain_labels

Array

risk

Integer

风险评分

斜体字参见附录1：术语的解释。

标籤字段的子字段

字段

类型

描述

chain

String

地址所属的链。适用于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

如果是代币合约则有代币名称

name_tag

String

名称标签

others

Array

标籤信息的列表，子字段如下

> label

String

不属于上述字段的标籤

> confidence

Integer

每个标籤的置信度

```

合規分數

獲取單個地址的合規風險信息

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

路徑參數

名稱

類型

描述

chain *

String

address*

String

目標地址

標頭

名稱

類型

描述

API-KEY*

String

您的 API 密鑰

示例請求

curl --location 'https://aml.blocksec.com/api/risk/v1/address/eth/0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc' \
--header 'API-KEY: $ApiKey'

示例回應

{
	"code": 200,
	"msg": "OK",
	"data": {
    	"address": "0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc",
    	"chain": "ETH",
    	"is_address_valid": true,
    	"entity_info": {
        	"entity": "TORNADO.CASH",
        	"name_tag": "Tornado.Cash: 0.1 ETH",
        	"contract_name": "TornadoCash_Eth_01"
    	},
    	"risk_indicators": [
        	{
            	"risk_type": "Ownership",
            	"risk_label": "OFAC SANCTIONED",
            	"risk_category": "SANCTIONED"
        	},
        	{
            	"risk_type": "Ownership",
            	"risk_label": "TORNADO.CASH",
            	"risk_category": "MIXER"
        	}
    	],
    	"risk_level": 5
	}
}

code: Integer。錯誤代碼。
- 200: 無錯誤。
- other: 發生錯誤。
msg: String
- 如果 code 不是 200，則此欄位表示詳細錯誤信息。
data: Object
- 目標地址的詳細風險信息，詳細內容請參見 'Response Data Parameter'。

回應數據參數

欄位

類型

描述

address

String

目標地址

chain

String

目標鏈

is_address_valid

Boolean

該地址是否符合目標區塊鏈的地址格式

entity_info

Object

地址實體信息，子字段如下所列

> entity

String

實體名稱

> name_tag

String

名稱標籤

> contract_name

String

合約名稱

> token_name

String

如為代幣合約則為代幣名稱

risk_indicators

Array

risk_level

Integer

風險得分

對於斜體字詞的解釋，請參閱附錄1：詞彙表。

風險指標欄位的子字段

欄位

類型

描述

risk_type

string

風險類型，包括所有權（實體風險）和交易對手（與風險地址的直接交互）

risk_label

string

風險標籤

risk_category

string

風險標籤的類別

risk_source

object

當風險類型為 'Counterparty' 時，以下子字段提供風險來源信息。

> chain

string

風險來源所在的鏈。

> address

string

風險來源地址

> entity

string

實體名稱，風險來源的實體名稱

附錄

附錄 1: 詞彙表

實體

指定地址的控制者。對於 EOA 地址，實體通常是控制私鑰的身份。對於合約，實體通常是擁有高權限的部署者或擁有者。

次要實體

指定地址的使用者，無法控制私鑰。例如，交易所會分發地址給用戶進行存款。用戶可以使用此類地址接收付款，但無法訪問私鑰。

名字標籤

作為地址的唯一標識符。

地址屬性

用來指示地址相關的特徵，例如‘熱錢包’或‘被 USDT 阻止’。

實體屬性

用來描述實體的屬性，例如“無 KYC”或“受到 OFAC 制裁”。

信任分數

評分範圍為 1 到 10。默認情況下，只返回信任分數高於 5 的標籤。

風險評分

評分範圍為 1 到 5。評分為 4 或以上的地址被認為有重大合規風險。

附錄 2: 風險因素類別

合規分數

獲取單個地址的合規風險信息

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

路徑參數

名稱

類型

描述

chain *

String

鏈的名稱，請參閱

address*

String

目標地址

標頭

名稱

類型

描述

API-KEY*

String

您的 API 密鑰

示例請求

curl --location 'https://aml.blocksec.com/api/risk/v1/address/eth/0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc' \
--header 'API-KEY: $ApiKey'

示例回應

{
	"code": 200,
	"msg": "OK",
	"data": {
    	"address": "0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc",
    	"chain": "ETH",
    	"is_address_valid": true,
    	"entity_info": {
        	"entity": "TORNADO.CASH",
        	"name_tag": "Tornado.Cash: 0.1 ETH",
        	"contract_name": "TornadoCash_Eth_01"
    	},
    	"risk_indicators": [
        	{
            	"risk_type": "Ownership",
            	"risk_label": "OFAC SANCTIONED",
            	"risk_category": "SANCTIONED"
        	},
        	{
            	"risk_type": "Ownership",
            	"risk_label": "TORNADO.CASH",
            	"risk_category": "MIXER"
        	}
    	],
    	"risk_level": 5
	}
}

code: Integer。錯誤代碼。
- 200: 無錯誤。
- other: 發生錯誤。
msg: String
- 如果 code 不是 200，則此欄位表示詳細錯誤信息。
data: Object
- 目標地址的詳細風險信息，詳細內容請參見 'Response Data Parameter'。

回應數據參數

欄位

類型

描述

address

String

目標地址

chain

String

目標鏈

is_address_valid

Boolean

該地址是否符合目標區塊鏈的地址格式

entity_info

Object

地址實體信息，子字段如下所列

> entity

String

實體名稱

> name_tag

String

名稱標籤

> contract_name

String

合約名稱

> token_name

String

如為代幣合約則為代幣名稱

risk_indicators

Array

風險項目列表，格式詳見下表 ''

risk_level

Integer

風險得分

對於斜體字詞的解釋，請參閱附錄1：詞彙表。

風險指標欄位的子字段

欄位

類型

描述

risk_type

string

風險類型，包括所有權（實體風險）和交易對手（與風險地址的直接交互）

risk_label

string

風險標籤

risk_category

string

風險標籤的類別

risk_source

object

當風險類型為 'Counterparty' 時，以下子字段提供風險來源信息。

> chain

string

風險來源所在的鏈。

> address

string

風險來源地址

> entity

string

實體名稱，風險來源的實體名稱

地址標籤

---
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 | 鏈名稱，參見[支持的鏈](../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='Request'>

<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：無錯誤。
- other：發生錯誤。
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：無錯誤。
- other：發生錯誤。
msg: String
- 如果code不是200，則此字段表示详细的错误信息。
data: Array
- 请求地址的标签信息列表。詳見响应数据参数。

响应数据参数

字段

类型

描述

address

String

目标地址

is_address_valid

Boolean

地址是否符合目标区块链的地址格式

chain

String

目标区块链

is_contract

Boolean

目标地址是否为合约

*labels

Object

标籤信息，详见

compatible_chain_labels

Array

如果目标链没有信息，则返回兼容链上的标籤。详情见

risk

Integer

风险评分

斜体字参见附录1：术语的解释。

标籤字段的子字段

字段

类型

描述

chain

String

地址所属的链。适用于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

如果是代币合约则有代币名称

name_tag

String

名称标签

others

Array

标籤信息的列表，子字段如下

> label

String

不属于上述字段的标籤

> confidence

Integer

每个标籤的置信度

```