Preis berechnen

POST /v1/orders/calculate

Gibt den genauen TRX-Preis für einen hypothetischen Auftrag zurück, ohne ihn zu erstellen. Verwende diesen Endpunkt, um Nutzern die Kosten anzuzeigen, bevor sie eine Einzahlung vornehmen.

Dies ist ein reiner Preisberechnungs-Endpunkt — er berührt das TRON-Netzwerk nicht.

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
duration	integer	ja	Mietdauer der Ressourcen in Stunden. Muss 1 sein.
activation	boolean	nein	Falls true, wird die Kontoaktivierungsgebühr in total eingerechnet. Standard: false.
resources.energy	integer	nein*	Zu liefernde Energy-Menge.
resources.bandwidth	integer	nein*	Zu liefernde Bandwidth-Menge.

* Mindestens eines von resources.energy oder resources.bandwidth muss größer als null sein.

Beispiele

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

Antwort

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

Mit activation: true (Aktivierung eines neuen Kontos):

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

Antwortfelder

Feld	Typ	Beschreibung
energy.amount	integer	Spiegelt die angeforderte Energy-Menge wider.
energy.price	number	TRX-Kosten für die Energy.
bandwidth.amount	integer	Spiegelt die angeforderte Bandwidth-Menge wider.
bandwidth.price	number	TRX-Kosten für die Bandwidth.
activation.required	boolean	Spiegelt das gesendete activation-Flag wider.
activation.price	number	TRX-Kosten der Aktivierung. 0, wenn nicht angefordert.
total	number	Summe aus Energy + Bandwidth + Aktivierungspreisen.
currency	string	Immer TRX.
duration	integer	Spiegelt die angeforderte Dauer wider.

total entspricht dem Betrag bei Auftragserstllung

Der total dieses Endpunkts entspricht dem amount, den POST /v1/orders bei denselben Eingaben und passendem activation-Ergebnis erfordern wird.