GET /apiv2/screening/price

کسی ایک فراہم کنندہ (provider) سے ایک جانچ کی قیمت، اور آیا آپ کا بیلنس اسے پورا کرتا ہے۔

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

اینڈپوائنٹ URL

GET https://netts.io/apiv2/screening/price?provider=elliptic

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

ہیڈر	درکار ہے	تفصیل
X-API-KEY	ہاں	Netts ڈیش بورڈ سے آپ کی API کی

کوئری پیرامیٹرز

پیرامیٹر	قسم	درکار ہے	تفصیل
provider	سٹرنگ	ہاں	elliptic یا bitok۔ کوئی طے شدہ (default) قدر نہیں ہے

ورژن 1 میں یہ پیرامیٹر طے شدہ طور پر elliptic پر سیٹ ہوتا ہے، اس لیے جس کالر نے اسے چھوڑ دیا اسے ایک ایسے فراہم کنندہ کی قیمت بتا دی گئی جس کا اس نے نام نہیں لیا تھا۔ جانچ کی باڈی کا بھی یہی اصول ہے۔

مثالی درخواست

curl "https://netts.io/apiv2/screening/price?provider=elliptic" \
  -H "X-API-KEY: your_api_key"

جواب

{
  "schema_version": 2,
  "provider": "elliptic",
  "price_usdt": "0.98",
  "price_trx": "2.884881",
  "available": true,
  "networks": ["trx", "eth", "btc", "..."],
  "score_scale": { "min": 0, "max": 10 },
  "trx_rate_usd": "0.339702",
  "balance_trx": "113.910000",
  "can_afford": true
}

فیلڈ	قسم	تفصیل
provider	سٹرنگ	وہ فراہم کنندہ جس کے بارے میں دریافت کیا گیا
price_usdt	سٹرنگ	ایک جانچ کی لسٹ قیمت، USDT میں
price_trx	سٹرنگ | null	موجودہ شرح پر تبدیل شدہ وہی قیمت
available	بولین	آیا اس وقت جانچ کا آرڈر دیا جا سکتا ہے
reason	سٹرنگ	صرف تب موجود ہوتا ہے جب available کی قدر false ہو۔ فی الوقت quota_exhausted
networks	ارے	نیٹ ورک ٹکرز جن کا یہ فراہم کنندہ احاطہ کرتا ہے
score_scale	آبجیکٹ	فراہم کنندہ کے اپنے اسکور اسکیل کے min اور max
trx_rate_usd	سٹرنگ | null	تبادلے کے لیے استعمال ہونے والی شرح
balance_trx	سٹرنگ	آپ کا TRX بیلنس
can_afford	بولین	balance_trx کم از کم price_trx کے برابر ہے

can_afford صرف سہولت کے لیے ہے، کوئی ریزرویشن نہیں۔ شرح تبدیل ہو سکتی ہے اور اس کال اور جانچ کے درمیانی وقت میں بیلنس کہیں اور خرچ کیا جا سکتا ہے۔ حتمی جواب خود وہ جانچ ہے، جو 1004 کے ساتھ انکار کر دیتی ہے اور رقوم بیان کرتی ہے۔

رقوم چھ اعشاریائی مقامات تک بتائی جاتی ہیں — یہ وہ درستگی (precision) ہے جس پر بیلنس سے اصل میں TRX کاٹا جاتا ہے، نہ کہ محض ڈسپلے کا انتخاب۔ وہ اعشاریائی سٹرنگز ہیں اس وجہ سے جو نمبرز سٹرنگز ہیں میں بیان کی گئی ہے۔

ذیلی صارف کا مارک اپ price_trx میں شامل ہے، بالکل اسی طرح جیسے یہ چارج کی جانے والی رقم میں شامل ہوتا ہے۔

نقائص

RFC 9457، application/problem+json۔

کوڈ	HTTP	کب
4001	400	provider غائب ہے یا کوئی معروف فراہم کنندہ نہیں ہے
4002	403	فراہم کنندہ موجود ہے لیکن آپ کے اکاؤنٹ کے لیے دستیاب نہیں ہے
4010 / 4011	401	کوئی API کی نہیں ہے، یا ایسی کی یا IP ہے جو قابل قبول نہیں ہے
5030	503	فراہم کنندہ عارضی طور پر غیر دستیاب ہے

{
  "type": "https://doc.netts.io/api/v2/errors/provider-unavailable-for-account",
  "title": "Provider is not available for your account",
  "status": 403,
  "detail": "BitOK is not available for your account. Please use Elliptic.",
  "instance": "/apiv2/screening/price",
  "code": 4002
}

ریٹ کی حدیں

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