APIs

Subscription

Subscribe to our plan to use this API in your service to help meet the compliance requirements and save users' assets.

Get Supported Chains

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

apiKey

Response

200500

OK

Body

application/json

codeall of

Error code, 200000 means no error

messagestring

Prompt message

request_idstring

The unique ID of the request

dataarray of chain.ChainResponse (object)

Request

JavaScriptCurlPythonHTTP

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

Response

200500

{
  "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 Address Labels

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

apiKey

Body

application/json

Request body with chain and address

address*string

Example: "0x3d12e63d4313f850d23cead57ef0c29e94c9551d"

chain_id*integer

Example: 1

Response

200500

OK

Body

application/json

codeall of

Error code, 200000 means no error

messagestring

Prompt message

request_idstring

The unique ID of the request

datacommon.AddressResponse (object)

Detailed address information including chain and entity details

Request

JavaScriptCurlPythonHTTP

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

Response

200500

{
  "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 Address Labels in Batch

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

apiKey

Body

application/json

Request body with chain and addresses

addresses*array of string

chain_id*integer

Example: 1

Response

200500

OK

Body

application/json

codeall of

Error code, 200000 means no error

messagestring

Prompt message

request_idstring

The unique ID of the request

dataarray of common.AddressResponse (object)

Request

JavaScriptCurlPythonHTTP

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

Response

200500

{
  "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 in Batch

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

apiKey

Body

application/json

Multi-chain address label request

addresses*array of string

chains*array of integer

Response

200400500

Successfully returned address labels

Body

application/json

codeall of

Error code, 200000 means no error

messagestring

Prompt message

request_idstring

The unique ID of the request

dataarray of common.BatchAddressesResponse (object)

Request

JavaScriptCurlPythonHTTP

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

Response

200400500

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

The quota consumed is calculated as follows:

Quota = Number of Addresses × Number of Chains.

For example, querying 3 addresses on 2 chains consumes a total of 6 quotas (3 × 2 = 6).

Get Entity Info

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

apiKey

Body

application/json

Entity query request

entity*string

Example: "TORNADO.CASH"

Response

200400500

OK

Body

application/json

codeall of

Error code, 200000 means no error

messagestring

Prompt message

request_idstring

The unique ID of the request

datacommon.EntityResponse (object)

Entity information including name, categories, attributes and description

Request

JavaScriptCurlPythonHTTP

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

Response

200400500

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