GET /apiv2/billing/rate

อัตราแลกเปลี่ยนปัจจุบันของคุณ: หนึ่ง TRX มีมูลค่าเท่าใดในสกุลเงินตามสัญญาของคุณ แต่ละบัญชีจะมีสกุลเงินตามสัญญาเป็นของตนเอง ดังนั้นคู่สกุลเงินและอัตราแลกเปลี่ยนจึงเป็นของคุณโดยเฉพาะ ใช้สำหรับตรวจสอบจำนวนเงินในบันทึกของคุณเอง ส่วนหนึ่งของ postpaid billing

URL ของ Endpoint

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

Headers ของคำขอ

ส่วนหัว	จำเป็น	คำอธิบาย
X-API-KEY	ใช่	คีย์ API ที่มีสิทธิ์ billing.read
X-Real-IP	ใช่	ที่อยู่ IP จากรายการที่อนุญาต (whitelist) ของคีย์

คำขอนี้ไม่มีพารามิเตอร์ สกุลเงินจะถูกนำมาจากสัญญาของคุณ

ตัวอย่าง

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

{
  "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	สกุลเงินตามสัญญาของคุณ เช่นเดียวกับใน settlement.asset ใน account
pair	TRX/ และสกุลเงินตามสัญญาของคุณ
rate	มูลค่าของหนึ่ง TRX ในสกุลเงินตามสัญญาของคุณ ข้อความทศนิยมที่มีทศนิยม 18 ตำแหน่ง
at	เวลาของอัตราแลกเปลี่ยนนี้ ในรูปแบบ UTC; จะเป็น null เมื่อสกุลเงินตามสัญญาของคุณคือ TRX

หากสกุลเงินตามสัญญาของคุณคือ TRX ค่าของ rate จะเป็น "1"

อัตราแลกเปลี่ยนจะเปลี่ยนแปลงไปตามเวลา โดยเป็นอัตรา ณ เวลาของ at ไม่ใช่การรับประกันอัตราแลกเปลี่ยนสำหรับคำสั่งซื้อในอนาคต: ค่าใช้จ่ายที่ถูกบันทึกไว้จะใช้อัตราแลกเปลี่ยน ณ เวลาของตัวเอง — ดูที่ recorded exchange rate

ข้อผิดพลาด

HTTP	code	ความหมาย
401	-1, -2	คีย์หายไปหรือไม่ถูกต้อง หรือ IP ไม่อยู่ในรายการที่อนุญาต — ตอบกลับโดย API gateway ดูที่ response format
403	billing_read_required	คีย์ไม่มีสิทธิ์ billing.read
403	postpaid_required	บัญชีนี้ไม่มี postpaid billing
503	rate_unavailable	อัตราแลกเปลี่ยนไม่พร้อมใช้งานชั่วคราว — โปรดลองอีกครั้งในภายหลัง

รหัสทั้งหมดมีระบุไว้ใน postpaid billing