Cotizar Transacción

Devuelve el total exacto que Crear Transacción con el mismo cuerpo cobraría en este momento, sin registrar nada. A diferencia de Calcular Costo de Recursos, que muestra la tarifa publicada, esta es la cifra a la que se cobra la compra.

Para un pedido energy mayor que el servicio de energía más grande (hasta 20 000 000 por pedido), la respuesta también enumera las partes en las que se completará el pedido. Envíe el amount devuelto como expected_amount en /v1/transaction/new para que se cobre exactamente ese total; es opcional y recomendado para un pedido así.

POST /v1/transaction/quote

Solicitud

El cuerpo es el de Crear Transacción: service, params (y external_id, que aquí se ignora). Se valida en el mismo orden y con los mismos códigos de error.

{
  "service": "energy",
  "params": {
    "address": "TRX_ADDRESS",
    "amounts": { "energy": 10000000 },
    "duration": 1
  }
}

Respuesta

Campo	Tipo	Descripción
result.service	string	El servicio cotizado
result.amounts	object|null	Las cantidades de recursos cotizadas
result.duration	integer	Duración en horas
result.amount	string	El total en TRX: todas las partes y la activación, si se incluye
result.activation	boolean	Si el total incluye la activación de la dirección
result.parts	array|null	Las partes de un pedido grande de energía: cada una con resource_amount y amount (TRX); null para un pedido que se completa en una sola parte

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "service": "energy",
    "amounts": { "energy": 10000000 },
    "duration": 1,
    "amount": "601.200000",
    "activation": false,
    "parts": [
      { "resource_amount": 4000000, "amount": "240.480000" },
      { "resource_amount": 4000000, "amount": "240.480000" },
      { "resource_amount": 2000000, "amount": "120.240000" }
    ]
  }
}

Una cotización es un momento, no una reserva: los precios cambian. Si después el pedido tiene otro precio, /v1/transaction/new con expected_amount lo rechaza con el código 409 price_moved y no cobra nada.

Este endpoint consume el mismo límite de consultas de precio que Calcular Costo de Recursos y Estimar Energía.

Errores Posibles

Los errores de Crear Transacción que ocurren antes del pago: 1, 2, 10, 11, 12, 24, 25, 35, 50, 429 cuando se agota el límite de consultas de precio, 503 temporarily_unavailable cuando la red TRON no respondió a tiempo a la verificación de la dirección (HTTP 503, con la cabecera Retry-After; reintente en un momento), y 500.