Oblicz cenę

POST /v1/orders/calculate

Zwraca dokładną cenę TRX dla hipotetycznego zamówienia bez jego tworzenia. Użyj tego, aby pokazać użytkownikom koszt przed dokonaniem wpłaty.

Jest to czysty endpoint cenowy — nie dotyka sieci TRON.

Treść żądania

Pole	Typ	Wymagane	Opis
duration	integer	tak	Czas wynajmu zasobów w godzinach. Musi wynosić 1.
activation	boolean	nie	Jeśli true, uwzględnij opłatę za aktywację konta w total. Domyślnie false.
resources.energy	integer	nie*	Ilość energii do dostarczenia.
resources.bandwidth	integer	nie*	Ilość przepustowości do dostarczenia.

* Co najmniej jedno z pól resources.energy lub resources.bandwidth musi być większe od zera.

Przykłady

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

Odpowiedź

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

Przy activation: true (aktywacja nowego konta):

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

Pola odpowiedzi

Pole	Typ	Opis
energy.amount	integer	Odzwierciedlenie żądanej ilości energii.
energy.price	number	Koszt energii w TRX.
bandwidth.amount	integer	Odzwierciedlenie żądanej ilości przepustowości.
bandwidth.price	number	Koszt przepustowości w TRX.
activation.required	boolean	Odzwierciedlenie flagi activation, którą wysłałeś.
activation.price	number	Koszt aktywacji w TRX. 0 gdy nie jest żądana.
total	number	Suma cen energii + przepustowości + aktywacji.
currency	string	Zawsze TRX.
duration	integer	Odzwierciedlenie żądanego czasu trwania.

total odpowiada kwocie z create-order

total z tego endpointu jest równy amount, którego będzie wymagał POST /v1/orders przy tych samych danych wejściowych i pasującym wyniku activation.