1 of 1

APIs

Abonnement

Abonnez-vous à notre plan pour utiliser cette API dans votre service afin d'aider à répondre aux exigences de conformité et de préserver les actifs des utilisateurs.

Obtenir les chaînes prises en charge

Obtenir les étiquettes d'adresse

Remarque : Si l'adresse que vous interrogez ne possède pas d'étiquettes sur la blockchain spécifiée, l'API renverra des informations sur les étiquettes provenant de chaînes compatibles pour cette adresse.

Par exemple, si vous demandez les informations d'étiquette pour l'adresse "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43" sur la chaîne Ethereum et que nous n'avons pas d'informations d'étiquette pour cette adresse sur Ethereum, l'API vérifiera les informations d'étiquette sur des chaînes compatibles avec EVM. Si des informations d'étiquette existent pour cette adresse sur des chaînes compatibles, l'API renverra les étiquettes d'adresse de toutes les chaînes compatibles.

Remarque : Cette opération sera comptée comme un seul appel API, et vous ne serez pas facturé plusieurs points pour le retour d'informations provenant de plusieurs chaînes compatibles.

Paramètres de la requête :

{
  "chain_id": 1,
  "address": "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43"
}

Réponse :

{
    "request_id": "c9d690acba6d466d",
    "code": 200000,
    "message": "Succès",
    "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": "ATTAQUANT",
                        "code": 4001,
                        "comp_info": [
                            "EXPLOIT"
                        ]
                    }
                ]
            }
        ]
    }
}

Vous pouvez remarquer que la structure de la réponse inclut un champ supplémentaire compatible_chains, qui stocke des informations sur l'adresse sur les chaînes compatibles. Ce champ est structuré comme un tableau, contenant les informations d'étiquette de l'adresse sur plusieurs chaînes compatibles.

Obtenir les étiquettes d'adresse en lot

Obtenir des informations sur l'entité

APIs

Abonnement

Abonnez-vous à notre plan pour utiliser cette API dans votre service afin d'aider à répondre aux exigences de conformité et de préserver les actifs des utilisateurs.

Obtenir les chaînes prises en charge

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

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

Authorization

Header parameters

API-KEY*string

Response

A successful request

Body

request_idstring

Example: "a11b2d3cf7834e0f"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

chain_idinteger

Unique identifier for the chain. In accordance with the chain IDs listed in the 'Supported Networks' section.

chain_namestring

The short name of the chain. In accordance with the short names listed in the 'Supported Networks' section.

Request

Response

Obtenir les étiquettes d'adresse

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

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

Authorization

Header parameters

API-KEY*string

Body

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

A successful request

Body

request_idstring

Example: "5e2edad6d5154daf"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataobject

addressstring

The queried address.

Example: "0x3d12e63d4313f850d23cead57ef0c29e94c9551d"

main_entitystring

The primary entity associated with the address.

Example: "BINANCE"

comp_entitiesarray of string

Complementary entities associated with the address.

itemsstring

Example: "ALAMEDA RESEARCH"

attributesarray of object

A list of attributes associated with the address. The structure of each attribute is as follows.

namestring

Attribute string

Example: "DEPOSIT ADDRESS"

codeinteger

Attribute code

Example: 4007

comp_infoarray of string

A supplementary description for the assigned attribute to this address.

itemsstring

Example: "BINANCE DEPOSIT ADDRESS"

name_tagstring

The name tag

Example: "Binance_Deposit_0x3d12"

Request

Response

Remarque : Cette opération sera comptée comme un seul appel API, et vous ne serez pas facturé plusieurs points pour le retour d'informations provenant de plusieurs chaînes compatibles.

Paramètres de la requête :

{
  "chain_id": 1,
  "address": "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43"
}

Réponse :

{
    "request_id": "c9d690acba6d466d",
    "code": 200000,
    "message": "Succès",
    "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": "ATTAQUANT",
                        "code": 4001,
                        "comp_info": [
                            "EXPLOIT"
                        ]
                    }
                ]
            }
        ]
    }
}

Obtenir les étiquettes d'adresse en lot

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

API-KEY*string

Body

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.

itemsstring

Response

A successful request

Body

request_idstring

Example: "afe065e89fbb4106"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

addressstring

The queried address.

main_entitystring

The primary entity associated with the address.

comp_entitiesarray of string

Complementary entities associated with the address.

itemsstring

attributesarray of object

A list of attributes associated with the address. The structure of each attribute is as follows.

namestring

Attribute string

codeinteger

Attribute code

Example: 4007

comp_infoarray of string

A supplementary description for the assigned attribute to this address.

itemsstring

name_tagstring

The name tag

Request

Response

Obtenir des informations sur l'entité

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

Authorization

Header parameters

API-KEY*string

Body

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

A successful request

Body

request_idstring

codeinteger

messagestring

dataobject

entitystring

Entity names

Example: "TORNADO.CASH"

categoriesarray of object

List all categories to which the entity can be categorized. The structure of each category is as follows.

namestring

Category string

Example: "MIXER"

codeinteger

Category code

Example: 3017

attributesarray of object

A list of attributes associated with the entity. The structure of each attribute is as follows.

namestring

Attribute string

Example: "SANCTIONED"

codeinteger

Attribute code

Example: 4015

comp_infoarray of string

A supplementary description for the assigned attribute to this entity.

itemsstring

Example: "OFAC SANCTIONED"

Request

Response

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

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

Authorization

Header parameters

API-KEY*string

Response

A successful request

Body

request_idstring

Example: "a11b2d3cf7834e0f"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

chain_idinteger

Unique identifier for the chain. In accordance with the chain IDs listed in the 'Supported Networks' section.

chain_namestring

The short name of the chain. In accordance with the short names listed in the 'Supported Networks' section.

Request

Response

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

Authorization

Header parameters

API-KEY*string

Body

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

A successful request

Body

request_idstring

codeinteger

messagestring

dataobject

entitystring

Entity names

Example: "TORNADO.CASH"

categoriesarray of object

List all categories to which the entity can be categorized. The structure of each category is as follows.

namestring

Category string

Example: "MIXER"

codeinteger

Category code

Example: 3017

attributesarray of object

A list of attributes associated with the entity. The structure of each attribute is as follows.

namestring

Attribute string

Example: "SANCTIONED"

codeinteger

Attribute code

Example: 4015

comp_infoarray of string

A supplementary description for the assigned attribute to this entity.

itemsstring

Example: "OFAC SANCTIONED"

Request

Response

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

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

Authorization

Header parameters

API-KEY*string

Body

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

A successful request

Body

request_idstring

Example: "5e2edad6d5154daf"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataobject

addressstring

The queried address.

Example: "0x3d12e63d4313f850d23cead57ef0c29e94c9551d"

main_entitystring

The primary entity associated with the address.

Example: "BINANCE"

comp_entitiesarray of string

Complementary entities associated with the address.

itemsstring

Example: "ALAMEDA RESEARCH"

attributesarray of object

A list of attributes associated with the address. The structure of each attribute is as follows.

namestring

Attribute string

Example: "DEPOSIT ADDRESS"

codeinteger

Attribute code

Example: 4007

comp_infoarray of string

A supplementary description for the assigned attribute to this address.

itemsstring

Example: "BINANCE DEPOSIT ADDRESS"

name_tagstring

The name tag

Example: "Binance_Deposit_0x3d12"

Request

Response

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

API-KEY*string

Body

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.

itemsstring

Response

A successful request

Body

request_idstring

Example: "afe065e89fbb4106"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

addressstring

The queried address.

main_entitystring

The primary entity associated with the address.

comp_entitiesarray of string

Complementary entities associated with the address.

itemsstring

attributesarray of object

A list of attributes associated with the address. The structure of each attribute is as follows.

namestring

Attribute string

codeinteger

Attribute code

Example: 4007

comp_infoarray of string

A supplementary description for the assigned attribute to this address.

itemsstring

name_tagstring

The name tag

Request

Response

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