GET /apiv2/screening/providers

وہ فراہم کنندگان (providers) جو آپ کے اکاؤنٹ کے لیے دستیاب ہیں، قیمتوں، ان نیٹ ورکس جن کا ہر ایک احاطہ کرتا ہے اور وہ پیمانہ جس پر اس کے اسکور کی پیمائش کی جاتی ہے، کے ساتھ۔

یہ ورژن 2 کا معاہدہ ہے۔ یہ GET /apiv2/aml/providers کی جگہ لیتا ہے، جو بدستور کام کر رہا ہے۔

اینڈ پوائنٹ URL

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

درخواست کے ہیڈرز

ہیڈر	لازمی	تفصیل
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"]
}

فیلڈ	قسم	تفصیل
providers[].provider	string	فراہم کنندہ کا نام، جیسا کہ جانچ کے باڈی میں بھیجا جاتا ہے
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

قیمتیں اعشاری سٹرنگز اسی وجہ سے ہیں جس وجہ سے اسکریننگ کے نتیجے میں آنے والے اعداد ہیں — ملاحظہ فرمائیں اعداد سٹرنگز ہیں۔ score_scale فراہم کنندہ کے اعداد و شمار کے بجائے ہمارا اپنا ہے، اس لیے یہ JSON نمبر ہی رہتا ہے۔

یہ اینڈ پوائنٹ کس مقصد کے لیے ہے

یہ فراہم کنندگان کی فہرست ہے۔ جانچ کا provider فیلڈ اسکیما میں ایک آزاد نوعیت کا سٹرنگ (free-form string) ہے بجائے کسی گنتی (enumeration) کے، تاکہ کوئی نیا فراہم کنندہ جوابات کی توثیق کرنے والے کسی بھی صارف کے نظام کو متاثر نہ کرے۔ اس کا نتیجہ یہ ہے کہ موجودہ فہرست ڈیٹا میں رہتی ہے، اسکیما میں نہیں: اسے یہاں پڑھیں۔

یہ نیٹ ورکس کی فہرست بھی ہے۔ جوڑا اہمیت رکھتا ہے — ایک فراہم کنندہ لازمی طور پر ہر نیٹ ورک کا احاطہ نہیں کرتا۔ کسی ایسے جوڑے کے لیے جانچ کا آرڈر دینا جس کا احاطہ نہیں کیا گیا ہے، کوئی بھی چارج لاگو ہونے سے پہلے 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 کو مسترد کر دیتا ہے۔

ذیلی صارف کا منافع (markup) price_trx میں شامل ہے، بالکل اسی طرح جیسے یہ وصول کی گئی رقم میں شامل ہے۔

غلطیاں

RFC 9457، application/problem+json۔

کوڈ	HTTP	کب
4010 / 4011	401	کوئی API کلید نہیں، یا ایسی کلید یا IP جو قابل قبول نہیں ہے

شرح کی حدود

دیگر تمام AML راستوں کے ساتھ مشترک: 5 درخواستیں فی سیکنڈ، 150 فی منٹ۔