Calcular Preço

POST /v1/orders/calculate

Retorna o preço exato em TRX para um pedido hipotético sem criá-lo. Use isso para mostrar aos usuários o custo antes de confirmarem o depósito.

Este é um endpoint exclusivo de precificação — ele não acessa a rede TRON.

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
duration	integer	sim	Duração do aluguel de recursos em horas. Deve ser 1.
activation	boolean	não	Se true, inclui a taxa de ativação de conta no total. Padrão é false.
resources.energy	integer	não*	Quantidade de energia a entregar.
resources.bandwidth	integer	não*	Quantidade de bandwidth a entregar.

* Pelo menos um entre resources.energy e resources.bandwidth deve ser maior que zero.

Exemplos

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'])

Resposta

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

Com activation: true (ativando uma nova conta):

{
  "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 da resposta

Campo	Tipo	Descrição
energy.amount	integer	Eco da quantidade de energia solicitada.
energy.price	number	Custo em TRX pela energia.
bandwidth.amount	integer	Eco da quantidade de bandwidth solicitada.
bandwidth.price	number	Custo em TRX pelo bandwidth.
activation.required	boolean	Eco do parâmetro activation enviado.
activation.price	number	Custo em TRX pela ativação. 0 quando não solicitada.
total	number	Soma dos preços de energia + bandwidth + ativação.
currency	string	Sempre TRX.
duration	integer	Eco da duração solicitada.

total corresponde ao amount do create-order

O total deste endpoint é igual ao amount que POST /v1/orders exigirá, dados os mesmos parâmetros e o mesmo resultado de activation.