GET /apiv2/billing/rate

Su tasa actual: cuánto vale un TRX en la moneda de su contrato. Cada cuenta tiene su propia moneda de contrato, por lo que el par y la tasa son propios. Utilícelo para verificar los importes en sus propios registros. Parte de la facturación pospago.

URL del endpoint

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

Encabezados de solicitud

Encabezado	Requerido	Descripción
X-API-KEY	sí	Clave de API con el permiso billing.read
X-Real-IP	sí	Una dirección de la lista blanca de la clave

La solicitud no tiene parámetros. La moneda se toma de su contrato.

Ejemplos

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 la respuesta

Campo	Descripción
asset	la moneda de su contrato, como en settlement.asset en cuenta
pair	TRX/ y la moneda de su contrato
rate	cuánto vale un TRX en la moneda de su contrato, una cadena decimal con 18 lugares decimales
at	el momento de la tasa, UTC; null cuando la moneda de su contrato es TRX

Si la moneda de su contrato es TRX, rate es "1".

La tasa cambia con el tiempo. Es la tasa en el momento de at, no una promesa de la tasa de una orden futura: un cargo registrado mantiene la tasa de su propio momento — consulte el tipo de cambio registrado.

Errores

HTTP	code	Significado
401	-1, -2	la clave falta o no es válida, o la IP no está en la lista blanca — respondido por la pasarela de la API, consulte el formato de respuesta
403	billing_read_required	la clave no tiene el permiso billing.read
403	postpaid_required	la cuenta no tiene facturación pospago
503	rate_unavailable	la tasa no está disponible temporalmente — inténtelo de nuevo más tarde

Todos los códigos se enumeran en la facturación pospago.