1 of 3

APIエンドポイント

MetaSleuth APIエンドポイントの概要。

アドレスラベル

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

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

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キー

サンプルリクエスト

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

各ラベルの信頼度

コンプライアンススコア

単一のアドレスのコンプライアンスリスク情報を取得

GET https://aml.blocksec.com/api/risk/v1/address

パスパラメータ

名前

タイプ

説明

chain *

String

address*

String

ターゲットアドレス

ヘッダー

名前

タイプ

説明

API-KEY*

String

あなたのAPIキー

サンプルリクエスト

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

サンプルレスポンス

{
	"code": 200,
	"msg": "OK",
	"data": {
    	"address": "0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc",
    	"chain": "ETH",
    	"is_address_valid": true,
    	"entity_info": {
        	"entity": "TORNADO.CASH",
        	"name_tag": "Tornado.Cash: 0.1 ETH",
        	"contract_name": "TornadoCash_Eth_01"
    	},
    	"risk_indicators": [
        	{
            	"risk_type": "Ownership",
            	"risk_label": "OFAC SANCTIONED",
            	"risk_category": "SANCTIONED"
        	},
        	{
            	"risk_type": "Ownership",
            	"risk_label": "TORNADO.CASH",
            	"risk_category": "MIXER"
        	}
    	],
    	"risk_level": 5
	}
}

code: Integer. エラーコード。
- 200: エラーなし。
- other: エラーが発生しました。
msg: String
- codeが200でない場合、このフィールドは詳細なエラー情報を示します。
data: Object
- ターゲットアドレスの詳細なリスク情報、詳細は'レスポンスデータパラメータ'を参照。

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

フィールド

タイプ

説明

address

String

ターゲットアドレス

chain

String

ターゲットチェーン

is_address_valid

Boolean

アドレスがターゲットブロックチェーンのアドレス形式に準拠しているか

entity_info

Object

アドレスエンティティ情報、以下のサブフィールドを参照

> entity

String

_エンティティ_の名前

> name_tag

String

ネームタグ

> contract_name

String

コントラクト名

> token_name

String

トークンコントラクトの場合のトークン名

risk_indicators

Array

risk_level

Integer

リスクスコア

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

risk_indicatorsフィールドのサブフィールド

フィールド

タイプ

説明

risk_type

string

リスクの種類。所有権（エンティティリスク）やリスキーなアドレスとの直接的なインタラクションを含む

risk_label

string

リスクラベル

risk_category

string

リスクラベルのカテゴリ

risk_source

object

risk_typeが'Counterparty'の場合、以下のサブフィールドでリスクソース情報を提供します。

> chain

string

リスクソースが位置するチェーン。

> address

string

リスクソースのアドレス

> entity

string

エンティティ名のリスクソース

コンプライアンススコア

単一のアドレスのコンプライアンスリスク情報を取得

GET https://aml.blocksec.com/api/risk/v1/address

パスパラメータ

名前

タイプ

説明

chain *

String

チェーン名、を参照

address*

String

ターゲットアドレス

ヘッダー

名前

タイプ

説明

API-KEY*

String

あなたのAPIキー

サンプルリクエスト

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

サンプルレスポンス

{
	"code": 200,
	"msg": "OK",
	"data": {
    	"address": "0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc",
    	"chain": "ETH",
    	"is_address_valid": true,
    	"entity_info": {
        	"entity": "TORNADO.CASH",
        	"name_tag": "Tornado.Cash: 0.1 ETH",
        	"contract_name": "TornadoCash_Eth_01"
    	},
    	"risk_indicators": [
        	{
            	"risk_type": "Ownership",
            	"risk_label": "OFAC SANCTIONED",
            	"risk_category": "SANCTIONED"
        	},
        	{
            	"risk_type": "Ownership",
            	"risk_label": "TORNADO.CASH",
            	"risk_category": "MIXER"
        	}
    	],
    	"risk_level": 5
	}
}

code: Integer. エラーコード。
- 200: エラーなし。
- other: エラーが発生しました。
msg: String
- codeが200でない場合、このフィールドは詳細なエラー情報を示します。
data: Object
- ターゲットアドレスの詳細なリスク情報、詳細は'レスポンスデータパラメータ'を参照。

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

フィールド

タイプ

説明

address

String

ターゲットアドレス

chain

String

ターゲットチェーン

is_address_valid

Boolean

アドレスがターゲットブロックチェーンのアドレス形式に準拠しているか

entity_info

Object

アドレスエンティティ情報、以下のサブフィールドを参照

> entity

String

_エンティティ_の名前

> name_tag

String

ネームタグ

> contract_name

String

コントラクト名

> token_name

String

トークンコントラクトの場合のトークン名

risk_indicators

Array

リスクアイテムのリスト、以下の''表を参照

risk_level

Integer

リスクスコア

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

risk_indicatorsフィールドのサブフィールド

フィールド

タイプ

説明

risk_type

string

リスクの種類。所有権（エンティティリスク）やリスキーなアドレスとの直接的なインタラクションを含む

risk_label

string

リスクラベル

risk_category

string

リスクラベルのカテゴリ

risk_source

object

risk_typeが'Counterparty'の場合、以下のサブフィールドでリスクソース情報を提供します。

> chain

string

リスクソースが位置するチェーン。

> address

string

リスクソースのアドレス

> entity

string

エンティティ名のリスクソース

アドレスラベル

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

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

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キー

サンプルリクエスト

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

各ラベルの信頼度