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" в сети Ethereum и у нас нет информации о метках для этого адреса в 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"
        ]
      }
    ]
  }
}