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

Responses

200

OK

application/json

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

500

Internal Server Error

application/json

get

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

Body

addressstringRequiredExample: 0x3d12e63d4313f850d23cead57ef0c29e94c9551d

chain_idintegerRequiredExample: 1

Responses

200

OK

application/json

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

500

Internal Server Error

application/json

post

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

Body

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

chain_idintegerRequiredExample: 1

Responses

200

OK

application/json

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

500

Internal Server Error

application/json

post

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

Body

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

chainsinteger[]RequiredExample: [1,56]

Responses

200

Successfully returned address labels

application/json

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

400

Invalid request parameters

application/json

500

Internal server error

application/json

post

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

Body

entitystringRequiredExample: TORNADO.CASH

Responses

200

OK

application/json

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

400

Parameter error

application/json

500

Internal service error

application/json

post

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