API

訂閱

訂閱 我們的計劃 以便在您的服務中使用此 API，幫助滿足合規要求並保護用戶資產。

獲取支持的鏈

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

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

Authorization

APIKey

Header parameters

Response

200

A successful request

Body

application/json

request_idstring

Example: "a11b2d3cf7834e0f"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://aml.blocksec.com/address-label/api/v3/chain-list', {
    method: 'GET',
    headers: {
      "API-KEY": "text"
    },
});
const data = await response.json();

Response

200

{
  "request_id": "a11b2d3cf7834e0f",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "chain_id": -3,
      "chain_name": "SOLANA"
    },
    {
      "chain_id": -2,
      "chain_name": "TRON"
    },
    {
      "chain_id": -1,
      "chain_name": "BTC"
    },
    {
      "chain_id": 1,
      "chain_name": "ETH"
    }
  ]
}

獲取地址標籤

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

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

Authorization

APIKey

Header parameters

Body

application/json

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

200

A successful request

Body

application/json

request_idstring

Example: "5e2edad6d5154daf"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://aml.blocksec.com/address-label/api/v3/labels', {
    method: 'POST',
    headers: {
      "API-KEY": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "chain_id": 1,
      "address": "0x3d12e63d4313f850d23cead57ef0c29e94c9551d"
    }),
});
const data = await response.json();

Response

200

{
  "request_id": "5e2edad6d5154daf",
  "code": 200000,
  "message": "Success",
  "data": {
    "address": "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
    "main_entity": "BINANCE",
    "comp_entities": [
      "ALAMEDA RESEARCH"
    ],
    "attributes": [
      {
        "name": "DEPOSIT ADDRESS",
        "code": 4007,
        "comp_info": [
          "BINANCE DEPOSIT ADDRESS"
        ]
      }
    ],
    "name_tag": "Binance_Deposit_0x3d12"
  }
}

注意：如果您查詢的地址在指定的區塊鏈上沒有標籤，API 將返回該地址在兼容鏈上的標籤信息。

例如，如果您請求以太坊鏈上地址 "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43" 的標籤信息，而我們在以太坊上沒有該地址的標籤信息，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 字段，該字段存儲有關兼容鏈上地址的信息。這個字段被結構化為一個數組，包含該地址在多個兼容鏈上的標籤信息。

批量獲取地址標籤

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

Body

application/json

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.

Response

200

A successful request

Body

application/json

request_idstring

Example: "afe065e89fbb4106"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://aml.blocksec.com/address-label/api/v3/batch-labels', {
    method: 'POST',
    headers: {
      "API-KEY": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "chain_id": 1,
      "addresses": [
        "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
        "0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8"
      ]
    }),
});
const data = await response.json();

Response

200

{
  "request_id": "afe065e89fbb4106",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "address": "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
      "main_entity": "Binance",
      "comp_entities": [
        "Alameda Research"
      ],
      "name_tag": "Binance_Deposit_0x3d12",
      "attributes": [
        {
          "name": "DEPOSIT ADDRESS",
          "code": 4007,
          "comp_info": [
            "Binance DEPOSIT ADDRESS"
          ]
        }
      ]
    },
    {
      "address": "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8",
      "main_entity": "Binance",
      "comp_entities": null,
      "name_tag": "Binance 7",
      "attributes": [
        {
          "name": "COLD WALLET",
          "code": 4004,
          "comp_info": null
        }
      ]
    }
  ]
}

獲取實體信息

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

Authorization

APIKey

Header parameters

Body

application/json

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

200

A successful request

Body

application/json

request_idstring

codeinteger

messagestring

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://aml.blocksec.com/address-label/api/v3/entity', {
    method: 'POST',
    headers: {
      "API-KEY": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "entity": "TORNADO.CASH"
    }),
});
const data = await response.json();

Response

200

{
  "request_id": "text",
  "code": 0,
  "message": "text",
  "data": {
    "entity": "TORNADO.CASH",
    "categories": [
      {
        "name": "MIXER",
        "code": 3017
      }
    ],
    "attributes": [
      {
        "name": "SANCTIONED",
        "code": 4015,
        "comp_info": [
          "OFAC SANCTIONED"
        ]
      }
    ]
  }
}