GET /apiv2/screening/providers

وہ فراہم کنندگان (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 میں بھی فراہم کیا جاتا ہے، لہٰذا وہ انضمام جو صرف نتائج پڑھتا ہے اسے اس اینڈ پوائنٹ کی بالکل ضرورت نہیں ہوتی۔

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

غلطیاں

RFC 9457، application/problem+json۔

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

شرح کی حدود

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