GET /apiv2/screening/providers

आपके खाते के लिए उपलब्ध प्रदाता, उनकी कीमतों, प्रत्येक द्वारा समर्थित नेटवर्क और उस पैमाने के साथ जिस पर उनका स्कोर मापा जाता है।

यह संस्करण 2 का अनुबंध है। यह GET /apiv2/aml/providers की जगह लेता है, जो काम करना जारी रखता है।

एंडपॉइंट URL

GET https://netts.io/apiv2/screening/providers

अनुरोध हेडर

Header	Required	Description
X-API-KEY	हाँ	Netts डैशबोर्ड से आपकी API कुंजी

उदाहरण अनुरोध

curl https://netts.io/apiv2/screening/providers \
  -H "X-API-KEY: your_api_key"

प्रतिक्रिया

{
  "schema_version": 2,
  "providers": [
    {
      "provider": "elliptic",
      "price_usdt": "0.98",
      "price_trx": "2.884881",
      "available": true,
      "networks": ["ada", "algo", "apt", "arb", "atom", "avax", "base", "bch",
                   "bnb", "bsc", "btc", "celo", "cro", "doge", "dot", "dydx",
                   "etc", "eth", "fil", "flr", "ftm", "gnosis", "hbar", "hype",
                   "icp", "inj", "linea", "ltc", "matic", "mob", "near", "okb",
                   "op", "sei", "sol", "strk", "sui", "tao", "ton", "trx",
                   "xdc", "xlm", "xrp", "xtz", "zec", "zen", "zil", "zksync"],
      "score_scale": { "min": 0, "max": 10 }
    }
  ],
  "trx_rate_usd": "0.339702",
  "supported_languages": ["en"]
}

Field	Type	Description
providers[].provider	string	प्रदाता का नाम, जैसा कि जांच के मुख्य भाग (body) में भेजा जाता है
providers[].price_usdt	string	एक जांच की सूची मूल्य, USDT में
providers[].price_trx	string | null	वर्तमान दर पर परिवर्तित समान मूल्य। null जब दर अनुपलब्ध हो
providers[].available	boolean	क्या अभी जांच का ऑर्डर दिया जा सकता है
providers[].reason	string	केवल तब मौजूद होता है जब available का मान false हो। वर्तमान में quota_exhausted
providers[].networks	array	नेटवर्क टिकर जिन्हें यह प्रदाता कवर करता है
providers[].score_scale	object	प्रदाता के अपने स्कोर पैमाने के min और max
trx_rate_usd	string | null	रूपांतरण के लिए उपयोग की जाने वाली दर
supported_languages	array	रिपोर्ट की भाषाएँ। वर्तमान में केवल en

कीमतें उसी कारण से दशमलव स्ट्रिंग (decimal strings) हैं जिस कारण से स्क्रीनिंग परिणाम में संख्याएँ होती हैं — देखें Numbers are strings। score_scale किसी प्रदाता के बजाय हमारा आंकड़ा है, इसलिए यह एक JSON संख्या ही रहता है।

यह एंडपॉइंट किस लिए है

यह प्रदाताओं की सूची है। किसी जांच का provider फ़ील्ड स्कीमा में एक गणना (enumeration) के बजाय एक मुक्त-रूप (free-form) स्ट्रिंग है, ताकि कोई नया प्रदाता प्रतिक्रियाओं को मान्य करने वाले किसी भी सिस्टम को प्रभावित न करे। इसका परिणाम यह है कि वर्तमान सूची डेटा में मौजूद है, स्कीमा में नहीं: इसे यहाँ पढ़ें।

यह नेटवर्क की सूची भी है। पेयरिंग महत्वपूर्ण है — जरूरी नहीं कि कोई प्रदाता हर नेटवर्क को कवर करता हो। किसी ऐसे पेयर के लिए जांच का ऑर्डर देना जो समर्थित नहीं है, कुछ भी शुल्क लेने से पहले 4004 लौटाता है।

और यहीं से पैमाना प्राप्त होता है। एक प्रदाता से 7 और दूसरे से 0.7 का स्कोर एक समान रीडिंग नहीं हैं, और संख्या में ऐसा कुछ भी नहीं है जो यह बताए कि यह किस पैमाने से संबंधित है। यह पैमाना प्रत्येक स्क्रीनिंग परिणाम के अंदर risk.scale में भी आता है, इसलिए ऐसा एकीकरण जो केवल परिणाम पढ़ता है उसे इस एंडपॉइंट की बिल्कुल भी आवश्यकता नहीं है।

जिस प्रदाता का उपयोग आपका खाता नहीं कर सकता, वह यहाँ सूचीबद्ध नहीं है। BitOK प्रतिबंधित है, और इसकी अनुमति सूची (allowlist) से बाहर के खाते इसे यहाँ नहीं देखते हैं और POST /apiv2/screening पर 4002 के साथ अस्वीकार कर दिए जाते हैं।

संस्करण 1 से क्या बदला

संस्करण 1 supported_formats भी लौटाता है। वह फ़ील्ड संस्करण 1 के अनुरोध मॉडल से संबंधित है, जहाँ ऑर्डर बनाए जाने पर प्रारूप तय किया गया था; संस्करण 2 में अनुरोध में ऐसा कोई फ़ील्ड नहीं है, क्योंकि परिणाम पढ़ते समय प्रस्तुति का चयन किया जाता है, इसलिए सूची हटा दी गई है।

13 सितंबर 2026 तक उस सूची में चार प्रारूपों का नाम था — rate, full, md और pdf — जिनमें से केवल दो ही कभी तैयार किए गए थे। pdf का अनुरोध करने पर चुपचाप सामान्य full लौटा दिया जाता था। दोनों एंडपॉइंट अब केवल वही नाम देते हैं जो वे वास्तव में लौटाते हैं, और संस्करण 1 किसी अनुरोध में चुपचाप कुछ और बदलने के बजाय md और pdf को अस्वीकार कर देता है।

सब-यूज़र मार्कअप price_trx में शामिल है, ठीक वैसे ही जैसे यह चार्ज की गई राशि में शामिल होता है।

त्रुटि प्रतिक्रियाएं

RFC 9457, application/problem+json।

Code	HTTP	When
4010 / 4011	401	कोई API कुंजी नहीं, या ऐसी कुंजी या IP जिसे स्वीकार नहीं किया गया है

दर सीमाएं

अन्य सभी AML पाथ के साथ साझा: 5 अनुरोध प्रति सेकंड, 150 प्रति मिनट।