GET /apiv2/billing/rate

Kurs Anda saat ini: berapa nilai satu TRX dalam mata uang kontrak Anda. Setiap akun memiliki mata uang kontraknya sendiri, sehingga pasangan mata uang dan kurs tersebut khusus untuk Anda. Gunakan ini untuk memeriksa jumlah dalam catatan Anda sendiri. Bagian dari penagihan pascabayar.

URL Endpoint

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

Header Permintaan

Header	Diperlukan	Deskripsi
X-API-KEY	ya	Kunci API dengan izin billing.read
X-Real-IP	ya	Alamat dari daftar putih (whitelist) kunci

Permintaan ini tidak memiliki parameter. Mata uang diambil dari kontrak Anda.

Contoh

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"
}

Bidang Respons

Bidang	Deskripsi
asset	mata uang kontrak Anda, seperti pada settlement.asset di akun
pair	TRX/ dan mata uang kontrak Anda
rate	berapa nilai satu TRX dalam mata uang kontrak Anda, string desimal dengan 18 tempat desimal
at	waktu berlakunya kurs, UTC; null jika mata uang kontrak Anda adalah TRX

Jika mata uang kontrak Anda adalah TRX, rate bernilai "1".

Kurs berubah seiring waktu. Ini adalah kurs pada saat at, bukan jaminan untuk kurs pesanan di masa mendatang: biaya yang tercatat mempertahankan kurs pada waktunya sendiri — lihat kurs pertukaran tercatat.

Respons Kesalahan

HTTP	code	Arti
401	-1, -2	kunci tidak ada atau tidak valid, atau IP tidak masuk daftar putih — dijawab oleh gateway API, lihat format respons
403	billing_read_required	kunci tidak memiliki izin billing.read
403	postpaid_required	akun tidak memiliki penagihan pascabayar
503	rate_unavailable	kurs sementara tidak tersedia — coba lagi nanti

Semua kode tercantum dalam penagihan pascabayar.