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

ステートレスである理由

スタンドアロンのウォレットスクリーニングは取引テーブルに何も書き込まないため、このエンドポイントがPDFを生成する元となる保存済みのレコードはありません。代わりに、POST /v3/wallet-screening/から受け取ったJSONをそのまま再送信すると、Diditはプロバイダーを再度呼び出すことなく、そのペイロードをPDFとして生成します。

report_signatureフィールド

すべてのPOST /v3/wallet-screening/レスポンスには、report_signatureフィールドが含まれるようになりました。これはアプリケーションに紐づく不透明な署名です。このエンドポイントはPDFを生成する前にこの署名を検証します。そのため、呼び出し元がrisk_score、severity、sanctions_hitなどのフィールドを編集して、Diditが実際には出していない結果について、見た目上は問題のないDiditブランドのPDFを取得することはできません。 report_signatureを含むレスポンス本文全体を、必ず変更せずに再送信してください。キーの順序を入れ替えることは問題ありませんが、署名された値を変更することはできません。

請求

プロバイダーの呼び出しは行われず、請求も一切発生しません。このエンドポイントは、POST /v3/wallet-screening/を呼び出した時点で支払い済みの結果を再表示するだけです。

エラー

次のステップ

ウォレットのスクリーニング

元となるオンデマンドのウォレットスクリーニングを実行し、ここに再投稿するJSON結果を取得します。

オンデマンドのウォレットスクリーニング

スタンドアロンのウォレットスクリーニングエンドポイントと結果モデルの概要です。

承認

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

POST /v3/wallet-screening/から返された、変更を加えていないJSONオブジェクト(report_signatureを含む)。

POST /v3/wallet-screening/のレスポンスと同じ形式です。report_signatureを含め、そのレスポンス本文をそのまま渡してください。

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

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

レスポンス

レンダリングされたPDF書類。バイナリのapplication/pdfとして直接返されます。JSONラッパーはありません。

The response is of type file.

最終更新日 2026年11月1日