アドレスラベル

単一のアドレスのラベルを取得する

ターゲットアドレスのラベル情報を返す

GET https://aml.blocksec.com/api/aml/v2/address

パスパラメータ

名前	タイプ	説明
chain*	String	チェーン名、サポートされているチェーン を参照
address*	String	ターゲットアドレス

ヘッダー

名前	タイプ	説明
API-KEY*	String	あなたのAPIキー

リクエスト

curl --location 'https://aml.blocksec.com/api/aml/v2/address/eth/0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff' \
--header 'API-KEY: $ApiKey'

レスポンス

サンプルレスポンス

{
    "code": 200,
    "data": [
        {
            "address": "0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": false,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "HUOBI",
                        "category": "CEX",
                        "confidence": 8
                    }
                ],
                "property_info": [
                    {
                        "address_property": "DEPOSIT ADDRESS",
                        "confidence": 8
                    },
                    {
                        "address_property": "EXPLOIT",
                        "category": "ATTACKER",
                        "confidence": 9
                    }
                ],
                "name_tag": "Ronin Bridge Exploiter 27",
                "others": [
                    {
                        "label": "RONIN BRIDGE EXPLOIT",
                        "confidence": 9
                    }
                ]
            },
            "risk": 5
        }
    ]
}

• code: Integer。エラーコード。

  • 200: エラーなし。

  • その他: エラーが発生しました。

• msg: String

  • code が 200 でない場合、このフィールドは詳細なエラー情報を示します。

• data: Array

  • 要求アドレスのラベル情報のリスト。レスポンスデータパラメータを参照してください。

複数アドレスのラベルを取得する

GET https://aml.blocksec.com/api/aml/v2/addresses

パスパラメータ

名前	タイプ	説明
chain*	String	チェーン名、サポートされているチェーン を参照
addresses*	String	ターゲットアドレスを , を区切りとして結合した単一の文字列。1つのリクエスト内のアドレス数は100を超えてはいけません。

ヘッダー

名前	タイプ	説明
API-KEY*	String	あなたのAPIキー

200: OK

リクエスト

サンプルリクエスト

curl --location 'https://aml.blocksec.com/api/aml/v2/addresses/eth/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0x0191e884bf8e21e138e161da520f94d4bbc79c1c' \
--header 'API-KEY: $ApiKey'

レスポンス

サンプルレスポンス

{
    "code": 200,
    "data": [
        {
            "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": true,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "CENTRE",
                        "confidence": 9
                    }
                ],
                "contract_info": {
                    "contract_name": "FiatTokenProxy",
                    "token_name": "USD Coin (USDC)"
                },
                "name_tag": "Circle: USDC Token",
                "others": [
                    {
                        "label": "CIRCLE",
                        "confidence": 9
                    },
                    {
                        "label": "STABLECOIN",
                        "confidence": 9
                    },
                    {
                        "label": "TOKEN CONTRACT",
                        "confidence": 9
                    },
                    {
                        "label": "USDC",
                        "confidence": 9
                    }
                ]
            },
            "risk": 2
        },
        {
            "address": "0x8672867cb976c723d600d810b419d439133fca7a",
            "is_address_valid": true,
            "chain": "ETH",
            "is_contract": true,
            "labels": {
                "entity_info": [
                    {
                        "entity_type": "first",
                        "entity": "BITTREX",
                        "category": "CEX",
                        "confidence": 9
                    }
                ],
                "property_info": [
                    {
                        "address_property": "DEPOSIT ADDRESS",
                        "confidence": 9
                    }
                ],
                "contract_info": {
                    "contract_name": "UserWallet"
                }
            },
            "risk": 1
        }
    ]
}

レスポンスフォーマットは、単一アドレスクエリで返される結果と一貫しています。

• code: Integer。エラーコード。

  • 200: エラーなし。

  • その他: エラーが発生しました。

• msg: String

  • code が 200 でない場合、このフィールドは詳細なエラー情報を示します。

• data: Array

  • 要求アドレスのラベル情報のリスト。レスポンスデータパラメータを参照してください。

レスポンスデータパラメータ

フィールド	タイプ	説明
address	String	ターゲットアドレス
is_address_valid	Boolean	アドレスがターゲットブロックチェーンのアドレス形式に適合するかどうか
chain	String	ターゲットブロックチェーン
is_contract	Boolean	ターゲットアドレスがコントラクトであるかどうか
*labels	Object	ラベル情報、詳細はラベルフィールドのサブフィールドを参照
compatible_chain_labels	Array	ターゲットチェーンに情報がない場合、互換性のあるチェーンのラベルを返す. 詳細はラベルフィールドのサブフィールドを参照
risk	Integer	リスクスコア

斜体の単語の説明については、付録1: 用語集を参照してください。

ラベルフィールドのサブフィールド

フィールド	タイプ	説明
chain	String	アドレスが所属するチェーン。compatible_chain_labelsで利用可能
entity_info	Object	エンティティ情報、以下にサブフィールドを示す
> entity_type	String	‘first’ は エンティティを示し、‘second’ は セカンダリエンティティを示します
> entity	String	エンティティの名前
> category	String	エンティティのカテゴリー
> entity_property	String	エンティティプロパティ
> confidence	Integer	エンティティ情報の信頼度
property_info	Object	プロパティ情報、以下にサブフィールドを示す
> address_property	String	アドレスプロパティ
> category	String	アドレスプロパティのカテゴリー
> confidence	Integer	アドレスプロパティの信頼度
contract_info	Object	コントラクトアドレスの場合のコントラクト情報、以下にサブフィールドを示す
> contract_name	String	コントラクト名
> token_name	String	トークンコントラクトの場合のトークン名
name_tag	String	ネームタグ
others	Array	ラベル情報のリスト、以下にサブフィールドを示す
> label	String	上記のフィールドに当てはまらないラベル
> confidence	Integer	各ラベルの信頼度