GET /apiv2/billing/rate

Sua taxa atual: quanto vale um TRX na moeda do seu contrato. Cada conta tem sua própria moeda de contrato, portanto, o par e a taxa são próprios seus. Use-a para conferir os valores em seus próprios registros. Parte do faturamento pós-pago.

URL do endpoint

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

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
X-API-KEY	sim	Chave de API com a permissão billing.read
X-Real-IP	sim	Um endereço da lista de permissões da chave

A requisição não tem parâmetros. A moeda é obtida a partir do seu contrato.

Exemplo

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

Campos de resposta

Campo	Descrição
asset	a moeda do seu contrato, como em settlement.asset em conta
pair	TRX/ e a moeda do seu contrato
rate	quanto vale um TRX na moeda do seu contrato, uma string decimal com 18 casas decimais
at	o momento da taxa, UTC; null quando a moeda do seu contrato for TRX

Se a moeda do seu contrato for TRX, rate é "1".

A taxa varia ao longo do tempo. É a taxa no momento de at, não uma promessa da taxa de um pedido futuro: uma cobrança registrada mantém a taxa de seu próprio momento — consulte taxa de câmbio registrada.

Erros

HTTP	code	Significado
401	-1, -2	a chave está ausente ou inválida, ou o IP não está na lista de permissões — respondido pelo gateway de API, consulte formato de resposta
403	billing_read_required	a chave não possui a permissão billing.read
403	postpaid_required	a conta não possui faturamento pós-pago
503	rate_unavailable	a taxa está temporariamente indisponível — tente novamente mais tarde

Todos os códigos estão listados em faturamento pós-pago.