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将返回该地址在兼容链上的标签信息。

例如，如果您请求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字段，该字段存储了关于兼容链上的地址信息。这个字段被结构化为一个数组，包含了地址在多个兼容链上的标签信息。

批量获取地址标签

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"
        ]
      }
    ]
  }
}