メインコンテンツへスキップ
POST
curl

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

ボディ

application/json
wallet_address
string
必須

スクリーニング対象の暗号資産アドレスまたはネットワーク識別子。選択したネットワークと一致する必要があります(例:EVMチェーンの場合は0xで始まる40文字の16進数アドレス)。エイリアス:address。

例:

"0x94f1b9b64e2932f6a2db338f616844400cd58e8a"

blockchain
enum<string>

任意のネットワーク識別子です。省略した場合、ネットワークはアドレスの形式から判定されます。bc1、1、3で始まるアドレスはBitcoin(BTC)、Tで始まるアドレスはTron(TRX)、base58の公開鍵はSolana(SOL)と判定されます。0xアドレスはすべてのEVMネットワークで有効なため、このアドレスでblockchainを省略すると、候補となるネットワークをcandidate_chainsに含めた422が返されます。マネージドスクリーニングは、BTC、ETH、LTC、XRP、BCH、DOGE、TRX、SOL、MATIC、BNB、BASE(Base)、OP(Optimism)、ARB(Arbitrum One)、AVAX(Avalanche C-Chain)、ADA(Cardano)、XLM(Stellar)、HBAR(Hedera)に対応しています。USDTとUSDCは従来のEthereumのエイリアスであり、複数のネットワークにまたがる検索ではありません。接続済みプロバイダーの対応範囲はプロバイダーによって異なります。LIGHTNINGには対応する接続済みプロバイダーが必要です。CELO(Celo)、MODE(Mode)、PLUME(Plume)は接続済みのTRM Labsアカウントを通じてスクリーニングされ、マネージドスクリーニングではこれらに対して400が返されます。エイリアス:currency。

利用可能なオプション:
BTC,
LIGHTNING,
ETH,
LTC,
XRP,
BCH,
DOGE,
TRX,
SOL,
MATIC,
BNB,
USDT,
USDC,
BASE,
OP,
ARB,
AVAX,
ADA,
XLM,
HBAR,
CELO,
MODE,
PLUME
例:

"ETH"

direction
enum<string>

任意。アドレスを受信(入金)側と送信(出金)側のどちらの取引相手としてスクリーニングするかを指定します。inbound、outbound、deposit、withdrawalのいずれかを指定できます。省略した場合は、中立的な送金前スクリーニングになります。この値はコンテキストとしてプロバイダーに渡されるだけで、返されるrisk_score、severity、およびsource_of_funds/destination_of_fundsの内訳は変わりません。これらの内訳はdirectionに関係なく常に両方返されます。そのため、directionを変更または省略しても、アドレスを再スクリーニングする必要はありません。

利用可能なオプション:
inbound,
outbound,
deposit,
withdrawal

レスポンス

正規化されたウォレットスクリーニングの結果。

provider
string
必須

スクリーニングを実行したプロバイダーです(例:merklescience、crystal)。

screening_type
enum<string>
必須

このエンドポイントでは常にWALLET_SCREENINGです。

利用可能なオプション:
WALLET_SCREENING
risk_score
integer
必須

0〜100に正規化されたリスクスコア。値が高いほど、リスクのあるエンティティへのエクスポージャーが大きいことを意味します。Merkle Scienceはアドレスを0〜5で評価し、それぞれ0、15、35、55、75、95に対応します。

severity
enum<string>
必須

risk_scoreから導出されるリスク区分です。0-9はUNKNOWN、10-39はLOW、40-69はMEDIUM、70-89はHIGH、90-100はCRITICALです。UNKNOWNは最も低い区分であり、データなしを表す別の状態ではありません。risk_scoreが0(問題のないアドレスでよくあるケース)の場合は不利な評価がないことを意味し、1から9の範囲のゼロ以外のスコアはLOW未満ではあるものの実際のシグナルです。区分だけでなくrisk_scoreを確認してください。UNKNOWNを低リスクや問題なしという積極的な評価として扱わないでください。合格として表示しないでください。

利用可能なオプション:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
status
enum<string>
必須

スクリーニング結果のステータス。

利用可能なオプション:
SCREENED,
PENDING,
ERROR
summary
string
必須

スクリーニング結果の、人が読める形式の概要。

wallet_address
string
必須

スクリーニングされたアドレスで、そのまま返されます。

blockchain
string
必須

スクリーニングされたブロックチェーン。

source_of_funds
object[]
必須

このアドレスが資金を受け取った送金元(エンティティ別に帰属を特定)。各エントリはエクスポージャーの内訳です。

destination_of_funds
object[]
必須

このアドレスが資金を送った送金先(エンティティ別に帰属を特定)。項目の形式はsource_of_fundsと同じで、exposure_direction = outgoingです。

counterparty_connections
object[]
必須

プロバイダーがスクリーニング対象のアドレスに紐付けたエンティティ。Merkle Scienceの場合、これらはアドレス自体の所有者タグとユーザータグから取得されるため、同じエンティティが2回表示されることがあり、資金フローは含まれません。received_usd、sent_usd、received_hops、sent_hopsはnullで、percentageは0です。ここではrisk_levelやis_directに基づいて処理を分岐しないでください。判定にはsanctions_hit、dominant_risk_category、risk_factors[].is_high_riskを、直接性の判断にはsource_of_funds/destination_of_funds内のexposure_typeを使用してください。

sanctions_hit
boolean
必須

アドレスに直接的または間接的な制裁エクスポージャーがある場合はtrue。

dominant_risk_category
string | null
必須

最も重みの高い高リスクカテゴリです(例: sanctioned、mixer、stolen_funds)。支配的なカテゴリがない場合はnullです。

report_signature
string
必須

この結果そのものに対する不透明なHMAC-SHA256署名で、アプリケーションにスコープされています。単体では意味を持ちません。PDFとして出力するには、このフィールドを含むレスポンス本文全体を変更せずにPOST /v3/wallet-screening/pdf/へ再送信してください。report_signatureが欠落している場合、または署名対象のフィールド(例: risk_score、severity、sanctions_hit)が再送信前に編集されていた場合、PDFエンドポイントはリクエストを400で拒否します。

transaction_hash
string | null

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常にnullです。

block_timestamp
string | null

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常にnullです。

total_value_usd
number | null

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常にnullです。

fee_usd
number | null

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常にnullです。

sender_rows
object[]

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常に空です。

receiver_rows
object[]

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常に空です。

transaction_flows
object[]

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常に空です。

transaction_flows_status
string | null

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常にnullです。

transaction_flows_error
string | null

取引スクリーニングのフィールドで、結果の形式と共通です。ウォレットスクリーニングの結果では常にnullです。

network_nodes
object[]

取引スクリーニング用のエクスポージャーグラフのノードです。ウォレットスクリーニングの結果では空になります。

network_edges
object[]

取引スクリーニング用のエクスポージャーグラフのエッジです。ウォレットスクリーニングの結果では空になります。

pep_counterparty
boolean | null

重要な公的地位を有する者 (PEP)への該当状況。PEPの検出結果がない場合はnullとなり、現時点ではPEPの結果を報告するプロバイダーがないため、すべての結果がこれに該当します。falseは、スクリーニングで明示的に否定的な結果が出た場合にのみ返されます。nullをPEPチェック完了と解釈しないでください。

risk_factors
object[]

risk_scoreの順位付きの説明で、この判定を導いた要因を示します。プロバイダーは独自のモデルでアドレスを評価し、判定のみを返すため(Merkle Scienceは0〜5の整数を返します)、スコアだけでは対応に活かせません。高リスクのものを先頭に、次に各ドライバーを経由した金額の大きい順に並べ、上位5件までに制限されます。source_of_fundsとdestination_of_fundsには常に完全な内訳が含まれます。risk_scoreが高いにもかかわらずis_high_riskのエントリがない場合は、プロバイダーが制裁や帰属エンティティとの一致を報告しておらず、独自のエクスポージャーモデルのみでアドレスを評価したことを意味します。このことはsummaryに明記されます。

raw_response
object

プロバイダー独自のペイロードです。形式はプロバイダーごとに異なり、予告なく変更される場合があります。解析せずに、正規化されたフィールドを参照してください。

最終更新日 2026年11月1日