GET /apiv2/billing/rate

Mevcut kurunuz: bir TRX'in sözleşmenizin para birimindeki değeri. Her hesabın kendi sözleşme para birimi vardır, bu nedenle parite ve kur size özeldir. Kendi kayıtlarınızdaki tutarları kontrol etmek için kullanın. Sonradan ödemeli faturalandırmanın bir parçasıdır.

Uç Nokta URL'si

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

İstek Başlıkları

Başlık	Zorunlu	Açıklama
X-API-KEY	evet	billing.read iznine sahip API anahtarı
X-Real-IP	evet	Anahtarın beyaz listesinde yer alan bir adres

İsteğin herhangi bir parametresi yoktur. Para birimi sözleşmenizden alınır.

Örnek

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

Yanıt Alanları

Alan	Açıklama
asset	hesap içindeki settlement.asset alanında olduğu gibi sözleşmenizin para birimi
pair	TRX/ ve sözleşmenizin para birimi
rate	bir TRX'in sözleşmenizin para birimindeki değeri; 18 ondalık basamaklı bir ondalık dize (decimal string)
at	kurun geçerli olduğu an, UTC; sözleşmenizin para birimi TRX olduğunda null

Sözleşmenizin para birimi TRX ise, rate değeri "1" olur.

Kur zaman içinde değişir. Bu değer, gelecekteki bir siparişin kur taahhüdü değil, at anındaki kurdur: kaydedilen bir ücretlendirme kendi zamanındaki kuru korur — bkz. kaydedilen döviz kuru.

Hatalar

HTTP	code	Anlamı
401	-1, -2	anahtar eksik veya geçersiz ya da IP beyaz listede değil — API ağ geçidi tarafından yanıtlanır, bkz. yanıt formatı
403	billing_read_required	anahtarın billing.read izni yok
403	postpaid_required	hesabın sonradan ödemeli faturalandırması yok
503	rate_unavailable	kur geçici olarak kullanılamıyor — daha sonra tekrar deneyin

Tüm kodlar sonradan ödemeli faturalandırma bölümünde listelenmiştir.