Cotizar energía

`GET /v2/energy/prices`

Precio de este momento para los montos populares en cada duración, más el precio por unidad.

Autenticación

Cabeceras app-id / app-secret, o Authorization: Bearer <token>.

Request

curl -X GET https://api.qvapay.com/v2/energy/prices \
  -H "app-id: tu-app-id" \
  -H "app-secret: tu-app-secret"

Response

{
  "data": [
    {
      "preset": "usdt_known",
      "title": "Una transferencia USDT (destino conocido)",
      "detail": "La dirección de destino ya recibió USDT alguna vez. Consume ~65.000 de energía.",
      "volume": 66000,
      "duration": "1h",
      "price_usd": 0.52,
      "unit_price_usd": 0.0000078788
    },
    {
      "preset": "usdt_new",
      "title": "Una transferencia USDT (destino nuevo)",
      "detail": "La dirección de destino nunca ha recibido USDT. Consume ~131.000 de energía porque hay que crear el slot del balance.",
      "volume": 132000,
      "duration": "1h",
      "price_usd": 1.00,
      "unit_price_usd": 0.0000075758
    }
  ],
  "meta": {
    "durations": ["1h", "1d", "3d", "7d"],
    "min_volume": 32000,
    "max_volume": 5000000,
    "note": "Precios orientativos: la energía sigue la demanda de la red TRON. Congela un precio con POST /v2/energy/quote."
  }
}

Usa unit_price_usd para estimar cualquier cantidad de esa duración. Es una estimación: el precio que se cobra es el de la cotización congelada o el vivo en el momento de alquilar.

Rate Limiting

3 requests cada 10 segundos por cuenta.

`POST /v2/energy/quote`

Congela un precio durante ~90 segundos y devuelve el quote_id con el que comprarlo.

Request

curl -X POST https://api.qvapay.com/v2/energy/quote \
  -H "app-id: tu-app-id" \
  -H "app-secret: tu-app-secret" \
  -H "Content-Type: application/json" \
  -d '{"volume": 132000, "duration": "1h"}'

Parámetros

Parámetro	Tipo	Requerido	Descripción
`volume`	number	Sí	Energía a alquilar: 32.000 – 5.000.000
`duration`	string	Sí	`1h`, `1d`, `3d` o `7d`

Response

{
  "data": {
    "quote_id": "6f9c2a1e-3b7d-4c08-9f21-2e5a7c0b1d44",
    "volume": 132000,
    "duration": "1h",
    "price_usd": 1.00,
    "expires_at": "2026-09-18T19:14:30.000Z"
  }
}

Campos de respuesta

Campo	Tipo	Descripción
`quote_id`	string	Pásalo a `POST /v2/energy/rent` para comprar a este precio
`price_usd`	number	Precio en USD que se cobrará de tu saldo
`expires_at`	string	Después de esta hora hay que cotizar de nuevo

La cotización es de un solo uso y solo la puede canjear la cuenta que la pidió.

Errores

Código	`code`	Descripción
`400`	`INVALID_VOLUME`	La cantidad está fuera de 32.000 – 5.000.000 o no es un entero
`400`	`INVALID_DURATION`	Duración no soportada
`400`	`PRICE_ABOVE_MAX`	El precio supera el máximo por operación
`429`	`RATE_LIMITED`	Demasiadas cotizaciones
`503`	`PROVIDER_UNAVAILABLE`	No se pudo calcular el precio ahora mismo

On this page