GET /apiv2/billing/rate

آپ کی موجودہ شرح: آپ کے معاہدے کی کرنسی میں ایک TRX کی قدر کیا ہے۔ ہر اکاؤنٹ کی اپنی معاہدہ جاتی کرنسی ہوتی ہے، اس لیے جوڑا اور شرح آپ کے اپنے ہیں۔ اپنے ریکارڈز میں رقوم کی تصدیق کے لیے اسے استعمال کریں۔ postpaid billing کا حصہ۔

اینڈپوائنٹ URL

GET https://netts.io/apiv2/billing/rate

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

ہیڈر	درکار ہے	تفصیل
`X-API-KEY`	ہاں	`billing.read` اجازت کے ساتھ API کی
`X-Real-IP`	ہاں	کی کی وائٹ لسٹ سے ایک پتہ

اس درخواست کا کوئی پیرامیٹر نہیں ہے۔ کرنسی آپ کے معاہدے سے لی جاتی ہے۔

مثال

bash

curl -s 'https://netts.io/apiv2/billing/rate' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

json

{
  "success": true,
  "data": {
    "asset": "<currency of your contract>",
    "pair": "TRX/<currency of your contract>",
    "rate": "0.331515333133553092",
    "at": "2026-10-20T05:52:15.915512+00:00"
  },
  "timestamp": "2026-10-20T05:52:20+00:00"
}

جواب کے فیلڈز

فیلڈ	تفصیل
`asset`	آپ کے معاہدے کی کرنسی، جیسا کہ account میں `settlement.asset` میں ہے
`pair`	`TRX/` اور آپ کے معاہدے کی کرنسی
`rate`	آپ کے معاہدے کی کرنسی میں ایک TRX کی قدر، 18 اعشاریائی مقامات پر مشتمل اعشاریائی سٹرنگ
`at`	شرح کا وقت، UTC؛ `null` جب آپ کے معاہدے کی کرنسی TRX ہو

اگر آپ کے معاہدے کی کرنسی TRX ہے، تو rate کی قدر "1" ہوگی۔

شرح وقت کے ساتھ تبدیل ہوتی رہتی ہے۔ یہ at کے وقت کی شرح ہے، نہ کہ مستقبل کے کسی آرڈر کی شرح کا وعدہ: ریکارڈ شدہ چارج اپنے وقت کی شرح برقرار رکھتا ہے — ملاحظہ کریں recorded exchange rate۔

نقائص

HTTP	`code`	مطلب
401	`-1`, `-2`	کی غائب یا غلط ہے، یا IP وائٹ لسٹ میں شامل نہیں ہے — API گیٹ وے کی طرف سے جواب دیا گیا، دیکھیں response format
403	`billing_read_required`	کی کے پاس `billing.read` اجازت نہیں ہے
403	`postpaid_required`	اکاؤنٹ میں postpaid بلنگ فعال نہیں ہے
503	`rate_unavailable`	شرح عارضی طور پر دستیاب نہیں ہے — بعد میں دوبارہ کوشش کریں

تمام کوڈز postpaid billing میں درج ہیں۔

GET /apiv2/billing/rate ​

اینڈپوائنٹ URL ​

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

مثال ​

جواب کے فیلڈز ​