API

サブスクリプション

このAPIをサービスで使用するためにプランをサブスクライブして、コンプライアンス要件を満たし、ユーザーの資産を保護します。

サポートされているチェーンを取得

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

アドレスラベルを取得

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

注: クエリしているアドレスが指定されたブロックチェーンでラベルを持っていない場合、APIはそのアドレスに対して互換性のあるチェーンからラベル情報を返します。

たとえば、「0xae4a7cde7c99fb98b0d5fa414aa40f0300531f43」というアドレスのラベル情報をEthereumチェーンでリクエストし、このアドレスに関するラベル情報がEthereumでない場合、APIはEVM互換チェーンに対してラベル情報をチェックします。このアドレスに対して、任意の互換チェーンでラベル情報が存在する場合、APIはすべての互換チェーンからアドレスラベルを返します。

注: この操作は単一のAPI呼び出しとしてカウントされ、複数の互換チェーンから情報を返すために複数のポイントが請求されることはありません。

リクエストパラメーター:

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

レスポンス:

{
    "request_id": "c9d690acba6d466d",
    "code": 200000,
    "message": "Success",
    "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 Exploiter",
                "attributes": [
                    {
                        "name": "ATTACKER",
                        "code": 4001,
                        "comp_info": [
                            "EXPLOIT"
                        ]
                    }
                ]
            }
        ]
    }
}

レスポンスの構造には、互換チェーン上のアドレスに関する情報を保存するための追加のcompatible_chainsフィールドが含まれていることがわかります。このフィールドは配列として構造化されており、複数の互換チェーン上のアドレスのラベル情報が含まれています。

バッチでアドレスラベルを取得

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

エンティティ情報を取得

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