1 of 9

v2（廃止）

APIの旧バージョン

これは私たちのAPIの旧バージョンです。

2024年7月1日をもって、このAPIのメンテナンスを停止しました。最新バージョンをご参照ください。

この移行に関してご質問がある場合は、お気軽に（ms_support@blocksec.com）までご連絡ください。

始めに

MetaSleuth APIドキュメントへようこそ！

BlockSecアドレスラベルデータベースとリスク評価アルゴリズムによって強化された強力なAPIの可能性を解き放ちましょう。

: オンチェーンアドレスの詳細情報とラベルにアクセスします。特定のアドレスのアイデンティティと活動を説明し、ブロックチェーンをより簡単に理解するのを助けます。
: アドレスのリスクレベルと指標を評価し、コンプライアンス要件をより効果的に評価できるようにします。不正資金との関与を効果的に検出および防止し、規制要件に準拠します。

認証

APIキーは、APIインターフェースにアクセスするために使用される一意の識別子です。すべてのインターフェースはアクセスのためにAPIキー認証を必要とします。データのセキュリティを確保するために、APIキーを他者と共有しないでください。

APIキーの取得方法

APIキーを生成するには、まずMetaSleuthアカウントに登録してください。登録後、_設定_セクションのAPIパネルにアクセスし、簡単にAPIキーを生成できます。

APIキーの使用方法

各APIリクエストでは、HTTPリクエストヘッダーに「API-KEY」ヘッダーを含め、APIキーをその値として提供してください。

レート制限

APIの過負荷を防ぎ、最適な処理速度と応答時間を確保するため、APIコールに対するアクセス制限を実施しています。

アドレスラベルAPI: 1秒あたり5回まで。
コンプライアンススコアAPI: 1秒あたり5回まで。

異なるサブスクリプションプランに基づいた1日のリクエスト制限に関する情報は、API価格プランをご覧ください。

対応するチェーン

リクエストを行う際には、提供されたチェーン名（大文字小文字関係なし）を使用してください。

チェーン

チェーンID

チェーン名

Bitcoin

btc

Ethereum

eth

BNB Smart Chain

bsc

TRON

tron

Fantom

250

fantom

Arbitrum One

42161

arbitrum

Avalanche C-Chain

43114

avalanche

Optimism

optimism

Polygon

137

polygon

Cronos

cronos

Base

8453

base

Linea

59144

linea

Moonbeam

1284

moonbeam

Moonriver

1285

moonriver

Polygon zkEVM

1101

polygon zkevm

Celo

42220

celo

CLV

1024

clv

Gnosis

100

gnosis

Bittorrent

199

bittorrent

Boba

288

boba

Wemix3.0

1111

wemix

zkSync Era

324

zksync era

Aurora

1313161554

aurora

APIエンドポイント

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

アドレスラベル

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

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

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

パスパラメータ

名前

タイプ

説明

ヘッダー

名前

タイプ

説明

サンプルレスポンス

code: Integer。エラーコード。
- 200: エラーなし。
- その他: エラーが発生しました。
msg: String
- code が 200 でない場合、このフィールドは詳細なエラー情報を示します。
data: Array

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

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

パスパラメータ

名前

タイプ

説明

ヘッダー

サンプルリクエスト

サンプルレスポンス

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

code: Integer。エラーコード。
- 200: エラーなし。
- その他: エラーが発生しました。
msg: String
- code が 200 でない場合、このフィールドは詳細なエラー情報を示します。
data: Array

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

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

コンプライアンススコア

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

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

パスパラメータ

名前

タイプ

説明

ヘッダー

名前

タイプ

説明

サンプルリクエスト

サンプルレスポンス

code: Integer. エラーコード。
- 200: エラーなし。
- other: エラーが発生しました。
msg: String
- codeが200でない場合、このフィールドは詳細なエラー情報を示します。
data: Object

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

フィールド

タイプ

説明

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

付録

付録 1: 用語集

エンティティ

指定されたアドレスの管理者。EOAアドレスの場合、エンティティは通常、プライベートキーを管理するアイデンティティです。契約の場合、エンティティは通常、高い特権を持つデプロイヤーやオーナーです。

セカンダリエンティティ

指定されたアドレスのユーザーで、プライベートキーを管理していません。例えば、取引所がユーザーに入金用のアドレスを配布します。ユーザーはそのようなアドレスを使用して支払いを受け取ることができますが、プライベートキーにアクセスすることはできません。

ネームタグ

アドレスの一意の識別子として機能します。

アドレスの特性

「HOT WALLET」や「BLOCKED BY USDT」のように、アドレスに関連する特徴を示すのに使われます。

エンティティの特性

「NO KYC」や「OFAC SANCTIONED」のように、エンティティによって示される属性を特徴付けるのに使用されます。

信頼スコア

スコア範囲は1から10です。デフォルトでは、信頼スコアが5以上のラベルのみが返されます。

リスクスコア

スコア範囲は1から5です。評価が4以上のアドレスは、重大なコンプライアンスリスクがあるとみなされます。

付録 2: リスク要因のカテゴリー

対応するチェーン

リクエストを行う際には、提供されたチェーン名（大文字小文字関係なし）を使用してください。

チェーン

チェーンID

チェーン名

Bitcoin

btc

Ethereum

eth

BNB Smart Chain

bsc

TRON

tron

Fantom

250

fantom

Arbitrum One

42161

arbitrum

Avalanche C-Chain

43114

avalanche

Optimism

optimism

Polygon

137

polygon

Cronos

cronos

Base

8453

base

Linea

59144

linea

Moonbeam

1284

moonbeam

Moonriver

1285

moonriver

Polygon zkEVM

1101

polygon zkevm

Celo

42220

celo

CLV

1024

clv

Gnosis

100

gnosis

Bittorrent

199

bittorrent

Boba

288

boba

Wemix3.0

1111

wemix

zkSync Era

324

zksync era

Aurora

1313161554

aurora

アドレスラベル

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

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

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

パスパラメータ

名前

タイプ

説明

ヘッダー

名前

タイプ

説明

サンプルレスポンス

code: Integer。エラーコード。
- 200: エラーなし。
- その他: エラーが発生しました。
msg: String
- code が 200 でない場合、このフィールドは詳細なエラー情報を示します。
data: Array
- 要求アドレスのラベル情報のリスト。を参照してください。

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

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

パスパラメータ

名前

タイプ

説明

ヘッダー

名前

タイプ

説明

サンプルリクエスト

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
- 要求アドレスのラベル情報のリスト。を参照してください。

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

フィールド

タイプ

説明

斜体の単語の説明については、を参照してください。

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

フィールド

タイプ

説明