मुख्य सामग्री पर जाएं
POST
curl

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

बॉडी

application/json
wallet_address
string
आवश्यक

स्क्रीन करने के लिए क्रिप्टो पता या नेटवर्क पहचानकर्ता। चयनित नेटवर्क से मेल खाना चाहिए (उदाहरण के लिए, EVM चेन के लिए 0x-उपसर्ग वाला 40-हेक्स-वर्णों का पता)। उपनाम: 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>
आवश्यक

इस endpoint के लिए हमेशा 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[]
आवश्यक

पते ने कहाँ धन भेजा, निकाय द्वारा एट्रिब्यूट किया गया। exposure_direction = outgoing के साथ source_of_funds के समान आइटम संरचना।

counterparty_connections
object[]
आवश्यक

वे संस्थाएँ जिनसे प्रदाता जाँचे गए पते को संबद्ध करता है। Merkle Science के लिए ये पते के अपने स्वामी और उपयोगकर्ता टैग से आती हैं, इसलिए एक ही संस्था दो बार दिखाई दे सकती है, और वे कोई फ़ंड फ़्लो नहीं ले जाती हैं: 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
आवश्यक

उच्चतम भारित उच्च-जोखिम वाली श्रेणी, या कोई प्रमुख न होने पर null (उदा. sanctioned, mixer, stolen_funds)।

report_signature
string
आवश्यक

इस सटीक परिणाम पर अपारदर्शी HMAC-SHA256 हस्ताक्षर, जो आपके एप्लिकेशन तक सीमित है। अपने आप में इसका कोई अर्थ नहीं है — इसे PDF के रूप में प्रस्तुत करने के लिए पूरे रिस्पॉन्स बॉडी को, बिना किसी बदलाव के और इस फ़ील्ड सहित, POST /v3/wallet-screening/pdf/ पर पुनः पोस्ट करें। यदि report_signature मौजूद नहीं है या पुनः पोस्ट करने से पहले किसी भी हस्ताक्षरित फ़ील्ड (उदा. risk_score, severity, sanctions_hit) को संपादित किया गया था, तो PDF endpoint अनुरोध को 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 परिणाम उपलब्ध न हो तब null, जो कि आज का हर परिणाम है क्योंकि कोई भी प्रदाता इसकी रिपोर्ट नहीं करता; केवल एक स्पष्ट नकारात्मक स्क्रीनिंग परिणाम के लिए false। null को पूर्ण PEP जांच न समझें।

risk_factors
object[]

risk_score का क्रमबद्ध स्पष्टीकरण: इस निर्णय को उत्पन्न करने वाले कारक। प्रदाता अपने स्वयं के मॉडल पर पते का मूल्यांकन करते हैं और केवल एक निर्णय लौटाते हैं (Merkle Science एक पूर्णांक 0-5 लौटाता है), इसलिए केवल स्कोर पर कार्रवाई नहीं की जा सकती। पहले उच्च-जोखिम वाले, फिर प्रत्येक कारक के माध्यम से स्थानांतरित मूल्य के अनुसार क्रमित, अधिकतम पाँच सबसे मजबूत कारकों तक सीमित; source_of_funds और destination_of_funds में हमेशा पूरा ब्रेकडाउन होता है। बिना किसी is_high_risk प्रविष्टि वाले उच्च risk_score का अर्थ है कि प्रदाता ने किसी प्रतिबंध या संबद्ध-इकाई मिलान की सूचना नहीं दी और पते का मूल्यांकन विशुद्ध रूप से अपने स्वयं के एक्सपोज़र मॉडल पर किया - summary इसे स्पष्ट रूप से बताता है।

raw_response
object

प्रदाता का अपना payload। इसका आकार प्रदाता-विशिष्ट है और बिना किसी सूचना के बदल सकता है: इसे पार्स करने के बजाय सामान्यीकृत फ़ील्ड पढ़ें।

अंतिम संशोधन 7 नवंबर 2026