APIs

Abonnement

Abonnieren Sie unseren Plan, um diese API in Ihrem Service zu nutzen, um die Compliance-Anforderungen zu erfüllen und die Vermögenswerte der Benutzer zu schützen.

Unterstützte Chains abrufen

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

Adresslabels abrufen

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

Hinweis: Wenn die Adresse, die Sie abfragen, auf der angegebenen Blockchain keine Labels hat, wird die API die Labelinformationen von kompatiblen Chains für diese Adresse zurückgeben.

Zum Beispiel, wenn Sie die Labelinformationen für die Adresse "0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43" auf der Ethereum-Chain anfordern und wir keine Labelinformationen für diese Adresse auf Ethereum haben, überprüft die API die Labelinformationen auf EVM-kompatiblen Chains. Wenn es Labelinformationen für diese Adresse auf kompatiblen Chains gibt, gibt die API die Adresslabels von allen kompatiblen Chains zurück.

Hinweis: Diese Operation zählt als ein einziger API-Aufruf, und Sie werden nicht mehrfach für die Rückgabe von Informationen von mehreren kompatiblen Chains belastet.

Anfrageparameter:

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

Antwort:

{
    "request_id": "c9d690acba6d466d",
    "code": 200000,
    "message": "Erfolg",
    "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 Ausbeuter",
                "attributes": [
                    {
                        "name": "ANGLREIFER",
                        "code": 4001,
                        "comp_info": [
                            "AUSBEUTEN"
                        ]
                    }
                ]
            }
        ]
    }
}

Sie können bemerken, dass die Antwortstruktur ein zusätzliches compatible_chains-Feld enthält, das Informationen über die Adresse auf kompatiblen Chains speichert. Dieses Feld ist als Array strukturiert und enthält die Labelinformationen der Adresse auf mehreren kompatiblen Chains.

Adresslabels im Batch abrufen

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

Entitätsinformationen abrufen

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