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 la Liste des Chaînes Prises en Charge

Obtenir des Étiquettes d'Adresse

Obtenir des Étiquettes d'Adresse en Lot

Obtenir des Étiquettes d'Adresse sur Plusieurs Chaînes en Lot

Le quota consommé est calculé comme suit :

Quota = Nombre d'Adresses × Nombre de Chaînes.

Par exemple, interroger 3 adresses sur 2 chaînes consomme un total de 6 quotas (3 × 2 = 6).

Obtenir des Informations sur l'Entité

PreviousAPI d'étiquettes d'adresse NextAPI de filtrage de portefeuilles

Last updated 22 days ago

Get a list of supported chains

Retrieve a list of all blockchains supported by the address label APIs

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

Authorization

Response

Body

codeall of

Error code, 200000 means no error

dataany

messagestring

Prompt message

request_idstring

The unique ID of the request

dataarray of object

Request

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

Response

{
  "request_id": "12cf29e910584a23",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "chain_id": -3,
      "chain_name": "SOLANA"
    },
    {
      "chain_id": -2,
      "chain_name": "TRON"
    },
    {
      "chain_id": -1,
      "chain_name": "BITCOIN"
    },
    {
      "chain_id": 1,
      "chain_name": "ETHEREUM"
    },
    {
      "chain_id": 10,
      "chain_name": "OPTIMISM"
    },
    {
      "chain_id": 25,
      "chain_name": "CRONOS"
    },
    {
      "chain_id": 56,
      "chain_name": "BNB SMART CHAIN"
    },
    {
      "chain_id": 100,
      "chain_name": "GNOSIS"
    },
    {
      "chain_id": 137,
      "chain_name": "POLYGON"
    },
    {
      "chain_id": 169,
      "chain_name": "MANTA PACIFIC"
    },
    {
      "chain_id": 199,
      "chain_name": "BITTORRENT"
    },
    {
      "chain_id": 250,
      "chain_name": "FANTOM OPERA"
    },
    {
      "chain_id": 288,
      "chain_name": "BOBA"
    },
    {
      "chain_id": 324,
      "chain_name": "ZKSYNC"
    },
    {
      "chain_id": 1024,
      "chain_name": "CLV PARACHAIN"
    },
    {
      "chain_id": 1101,
      "chain_name": "POLYGON ZKEVM"
    },
    {
      "chain_id": 1111,
      "chain_name": "WEMIX3.0 MAINNET"
    },
    {
      "chain_id": 1284,
      "chain_name": "MOONBEAM"
    },
    {
      "chain_id": 1285,
      "chain_name": "MOONRIVER"
    },
    {
      "chain_id": 5000,
      "chain_name": "MANTLE"
    },
    {
      "chain_id": 8453,
      "chain_name": "BASE"
    },
    {
      "chain_id": 42161,
      "chain_name": "ARBITRUM ONE"
    },
    {
      "chain_id": 42220,
      "chain_name": "CELO"
    },
    {
      "chain_id": 43114,
      "chain_name": "AVALANCHE C-CHAIN"
    },
    {
      "chain_id": 59144,
      "chain_name": "LINEA"
    },
    {
      "chain_id": 81457,
      "chain_name": "BLAST"
    },
    {
      "chain_id": 1313161554,
      "chain_name": "AURORA"
    }
  ]
}

Get the label of a single address.

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

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

Authorization

Body

Request body with chain and address

address*string

Example: "0x3d12e63d4313f850d23cead57ef0c29e94c9551d"

chain_id*integer

Example: 1

Response

Body

codeall of

Error code, 200000 means no error

dataany

messagestring

Prompt message

request_idstring

The unique ID of the request

Request

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

Response

{
  "request_id": "c82817c2fec843ce",
  "code": 200000,
  "message": "Success",
  "data": {
    "chain_id": 1,
    "address": "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
    "main_entity": "Binance",
    "main_entity_info": {
      "entity": "Binance",
      "categories": [
        {
          "name": "EXCHANGE",
          "code": 3011
        },
        {
          "name": "OTC DESK",
          "code": 3021
        }
      ],
      "attributes": null,
      "description": {
        "website": "https://www.binance.com/",
        "twitter": "https://twitter.com/binance",
        "telegram": "",
        "discord": ""
      }
    },
    "comp_entities": [
      "Alameda Research"
    ],
    "attributes": [
      {
        "name": "DEPOSIT ADDRESS",
        "code": 4007,
        "comp_info": [
          "BINANCE DEPOSIT ADDRESS"
        ]
      }
    ],
    "name_tag": "Binance: Deposit Address"
  }
}

Get the labels of multiple addresses on the same chain in batch

Retrieve detailed label information of a list of addresses on a particular chain.

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

Authorization

Body

Request body with chain and addresses

addresses*array of string

Example: ["0x3d12e63d4313f850d23cead57ef0c29e94c9551d","0xbe0eb53f46cd790cd13851d5eff43d12404d33e8"]

chain_id*integer

Example: 1

Response

Body

codeall of

Error code, 200000 means no error

dataany

messagestring

Prompt message

request_idstring

The unique ID of the request

dataarray of object

Request

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

Response

{
  "request_id": "faf08205f4364c8c",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "chain_id": 1,
      "address": "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8",
      "main_entity": "Binance",
      "main_entity_info": {
        "entity": "Binance",
        "categories": [
          {
            "name": "EXCHANGE",
            "code": 3011
          },
          {
            "name": "OTC DESK",
            "code": 3021
          }
        ],
        "attributes": null,
        "description": {
          "website": "https://www.binance.com/",
          "twitter": "https://twitter.com/binance",
          "telegram": "",
          "discord": ""
        }
      },
      "comp_entities": null,
      "attributes": [
        {
          "name": "COLD WALLET",
          "code": 4004,
          "comp_info": null
        }
      ],
      "name_tag": "Binance: Cold Wallet"
    },
    {
      "chain_id": 1,
      "address": "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
      "main_entity": "Binance",
      "main_entity_info": {
        "entity": "Binance",
        "categories": [
          {
            "name": "EXCHANGE",
            "code": 3011
          },
          {
            "name": "OTC DESK",
            "code": 3021
          }
        ],
        "attributes": null,
        "description": {
          "website": "https://www.binance.com/",
          "twitter": "https://twitter.com/binance",
          "telegram": "",
          "discord": ""
        }
      },
      "comp_entities": [
        "Alameda Research"
      ],
      "attributes": [
        {
          "name": "DEPOSIT ADDRESS",
          "code": 4007,
          "comp_info": [
            "BINANCE DEPOSIT ADDRESS"
          ]
        }
      ],
      "name_tag": "Binance: Deposit Address"
    }
  ]
}

Get address labels across multiple chains

Retrieve address labels for multiple addresses across specified blockchain networks

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

Authorization

Body

Multi-chain address label request

addresses*array of string

Example: ["0xcf2f7f94dfd385c1a2a2090c971183a121f0de0b","0x32a5b2c435bf3d41a859b48ae307dfbf3b3b54e3"]

chains*array of integer

Example: [1,56]

Response

Successfully returned address labels

Body

codeall of

Error code, 200000 means no error

dataany

messagestring

Prompt message

request_idstring

The unique ID of the request

dataarray of object

Request

const response = await fetch('https://aml.blocksec.com/address-label/api/v3/multi-chains-labels', {
    method: 'POST',
    headers: {
      "API-KEY": "apiKey <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "addresses": [
        "0xcf2f7f94dfd385c1a2a2090c971183a121f0de0b",
        "0x32a5b2c435bf3d41a859b48ae307dfbf3b3b54e3"
      ],
      "chains": [
        1,
        56
      ]
    }),
});
const data = await response.json();

Response

{
  "request_id": "6fc7387140e94b42",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "chain_id": 1,
      "addresses": [
        {
          "chain_id": 1,
          "address": "0xcf2f7f94dfd385c1a2a2090c971183a121f0de0b",
          "main_entity": "",
          "main_entity_info": null,
          "comp_entities": null,
          "attributes": null,
          "name_tag": ""
        },
        {
          "chain_id": 1,
          "address": "0x32a5b2c435bf3d41a859b48ae307dfbf3b3b54e3",
          "main_entity": "",
          "main_entity_info": null,
          "comp_entities": null,
          "attributes": null,
          "name_tag": ""
        }
      ]
    },
    {
      "chain_id": 56,
      "addresses": [
        {
          "chain_id": 56,
          "address": "0xcf2f7f94dfd385c1a2a2090c971183a121f0de0b",
          "main_entity": "PancakeSwap",
          "main_entity_info": {
            "entity": "PancakeSwap",
            "categories": [
              {
                "name": "DEX",
                "code": 3008
              },
              {
                "name": "OPTIONS",
                "code": 3044
              },
              {
                "name": "DERIVATIVES",
                "code": 3028
              }
            ],
            "attributes": null,
            "description": {
              "website": "https://pancakeswap.finance",
              "twitter": "",
              "telegram": "",
              "discord": ""
            }
          },
          "comp_entities": null,
          "attributes": null,
          "name_tag": "PancakeSwap V2: TRL 23"
        },
        {
          "chain_id": 56,
          "address": "0x32a5b2c435bf3d41a859b48ae307dfbf3b3b54e3",
          "main_entity": "PancakeSwap",
          "main_entity_info": {
            "entity": "PancakeSwap",
            "categories": [
              {
                "name": "DEX",
                "code": 3008
              },
              {
                "name": "OPTIONS",
                "code": 3044
              },
              {
                "name": "DERIVATIVES",
                "code": 3028
              }
            ],
            "attributes": null,
            "description": {
              "website": "https://pancakeswap.finance",
              "twitter": "",
              "telegram": "",
              "discord": ""
            }
          },
          "comp_entities": null,
          "attributes": null,
          "name_tag": "PancakeSwap V2: Daddymoney"
        }
      ]
    }
  ]
}

Get entity information by entity name

Retrieve detailed information based on the provided entity name, supporting suffix matching

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

Authorization

Body

Entity query request

entity*string

Example: "TORNADO.CASH"

Response

Body

codeall of

Error code, 200000 means no error

dataany

messagestring

Prompt message

request_idstring

The unique ID of the request

dataobject

Entity information including name, categories, attributes and description

Request

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

Response

{
  "request_id": "62e8586265bf4550",
  "code": 200000,
  "message": "Success",
  "data": {
    "entity": "Tornado Cash",
    "categories": [
      {
        "name": "MIXER",
        "code": 3017
      },
      {
        "name": "PRIVACY",
        "code": 3032
      }
    ],
    "attributes": [
      {
        "name": "SANCTIONED",
        "code": 4015,
        "comp_info": [
          "OFAC Sanctioned"
        ]
      }
    ],
    "description": {
      "website": "https://tornadocash-eth.ipns.dweb.link/",
      "twitter": "https://x.com/tornadocash",
      "telegram": "",
      "discord": ""
    }
  }
}