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

get

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

Authorizations

apiKey

API-KEYstringRequired

Responses

200

OK

application/json

500

Internal Server Error

application/json

get

/chain-list

HTTPcURLJavaScriptPython

GET /address-label/api/v3/chain-list HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Accept: */*

{
  "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.

post

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

Authorizations

apiKey

API-KEYstringRequired

Body

application/json

addressstringRequiredExample: 0x3d12e63d4313f850d23cead57ef0c29e94c9551d

chain_idintegerRequiredExample: 1

Responses

200

OK

application/json

500

Internal Server Error

application/json

post

/labels

HTTPcURLJavaScriptPython

POST /address-label/api/v3/labels HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 69

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

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

post

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

Authorizations

apiKey

API-KEYstringRequired

Body

application/json

addressesstring[]RequiredExample: ["0x3d12e63d4313f850d23cead57ef0c29e94c9551d","0xbe0eb53f46cd790cd13851d5eff43d12404d33e8"]

chain_idintegerRequiredExample: 1

Responses

200

OK

application/json

500

Internal Server Error

application/json

post

/batch-labels

HTTPcURLJavaScriptPython

POST /address-label/api/v3/batch-labels HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 118

{
  "chain_id": 1,
  "addresses": [
    "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
    "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8"
  ]
}

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

post

Retrieve address labels for multiple addresses across specified blockchain networks

Authorizations

apiKey

API-KEYstringRequired

Body

application/json

addressesstring[]RequiredExample: ["0xcf2f7f94dfd385c1a2a2090c971183a121f0de0b","0x32a5b2c435bf3d41a859b48ae307dfbf3b3b54e3"]

chainsinteger[]RequiredExample: [1,56]

Responses

200

Successfully returned address labels

application/json

400

Invalid request parameters

application/json

500

Internal server error

application/json

post

/multi-chains-labels

HTTPcURLJavaScriptPython

POST /address-label/api/v3/multi-chains-labels HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "chains": [
    1,
    56
  ],
  "addresses": [
    "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
    "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8"
  ]
}

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

post

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

Authorizations

apiKey

API-KEYstringRequired

Body

application/json

entitystringRequiredExample: TORNADO.CASH

Responses

200

OK

application/json

400

Parameter error

application/json

500

Internal service error

application/json

post

/entity

HTTPcURLJavaScriptPython

POST /address-label/api/v3/entity HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "entity": "TORNADO.CASH"
}

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