Calcular Precio

POST /v1/orders/calculate

Devuelve el precio exacto en TRX para una orden hipotética sin crearla. Úsalo para mostrar a los usuarios el costo antes de que realicen un depósito.

Este es un endpoint de precio puro — no interactúa con la red TRON.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
duration	integer	sí	Duración del alquiler de recursos en horas. Debe ser 1.
activation	boolean	no	Si es true, incluye la tarifa de activación de cuenta en total. Por defecto es false.
resources.energy	integer	no*	Cantidad de energía a entregar.
resources.bandwidth	integer	no*	Cantidad de ancho de banda a entregar.

* Al menos uno de resources.energy o resources.bandwidth debe ser mayor que cero.

Ejemplos

Bash

curl -X POST https://api.tronzap.com/v1/orders/calculate \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "duration": 1,
    "activation": false,
    "resources": {
      "energy": 65000,
      "bandwidth": 345
    }
  }'

Node.js

const response = await fetch('https://api.tronzap.com/v1/orders/calculate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
  },
  body: JSON.stringify({
    duration: 1,
    activation: false,
    resources: { energy: 65000, bandwidth: 345 },
  }),
})
const data = await response.json()
console.log(data.result.total, data.result.currency)

PHP

$response = file_get_contents('https://api.tronzap.com/v1/orders/calculate', false, stream_context_create([
  'http' => [
    'method' => 'POST',
    'header' => "Content-Type: application/json\r\nAccept: application/json",
    'content' => json_encode([
      'duration' => 1,
      'activation' => false,
      'resources' => ['energy' => 65000, 'bandwidth' => 345],
    ]),
  ],
]));
$data = json_decode($response, true);
echo $data['result']['total'] . ' ' . $data['result']['currency'];

Python

import requests

resp = requests.post('https://api.tronzap.com/v1/orders/calculate', json={
    'duration': 1,
    'activation': False,
    'resources': {'energy': 65000, 'bandwidth': 345},
})
result = resp.json()['result']
print(result['total'], result['currency'])

Respuesta

{
  "code": 0,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "energy":     { "amount": 65000, "price": 2.34 },
    "bandwidth":  { "amount": 345,   "price": 0.35 },
    "activation": { "required": false, "price": 0 },
    "total": 2.69,
    "currency": "TRX",
    "duration": 1
  }
}

Con activation: true (activando una nueva cuenta):

{
  "code": 0,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "energy":     { "amount": 65000, "price": 2.34 },
    "bandwidth":  { "amount": 345,   "price": 0.35 },
    "activation": { "required": true, "price": 1.40 },
    "total": 4.09,
    "currency": "TRX",
    "duration": 1
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
energy.amount	integer	Eco de la cantidad de energía solicitada.
energy.price	number	Costo en TRX por la energía.
bandwidth.amount	integer	Eco de la cantidad de ancho de banda solicitada.
bandwidth.price	number	Costo en TRX por el ancho de banda.
activation.required	boolean	Eco del indicador activation enviado.
activation.price	number	Costo en TRX de la activación. 0 si no se solicitó.
total	number	Suma de los precios de energía + ancho de banda + activación.
currency	string	Siempre TRX.
duration	integer	Eco de la duración solicitada.

total coincide con el monto de create-order

El total de este endpoint es igual al amount que POST /v1/orders requerirá, dados los mismos datos de entrada y el mismo resultado de activation.