GET /apiv2/billing/rate

Your current rate: how much one TRX is worth in the currency of your contract. Every account has its own contract currency, so the pair and the rate are your own. Use it to check the amounts in your own records. Part of postpaid billing.

Endpoint URL

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

Request headers

Header	Required	Description
X-API-KEY	yes	API key with the billing.read permission
X-Real-IP	yes	An address from the key whitelist

The request has no parameters. The currency is taken from your contract.

Example

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

Response fields

Field	Description
asset	the currency of your contract, as in settlement.asset in account
pair	TRX/ and the currency of your contract
rate	how much one TRX is worth in the currency of your contract, a decimal string with 18 decimal places
at	the moment of the rate, UTC; null when the currency of your contract is TRX

If the currency of your contract is TRX, rate is "1".

The rate changes over time. It is the rate at the moment of at, not a promise of the rate of a future order: a recorded charge keeps the rate of its own time — see recorded exchange rate.

Errors

HTTP	code	Meaning
401	-1, -2	the key is missing or invalid, or the IP is not whitelisted — answered by the API gateway, see response format
403	billing_read_required	the key has no billing.read permission
403	postpaid_required	the account has no postpaid billing
503	rate_unavailable	the rate is temporarily unavailable — retry later

All codes are listed in postpaid billing.