Transaktionspreis abfragen

Gibt den genauen Gesamtbetrag zurück, den Transaktion erstellen mit demselben Body jetzt abbuchen würde, und speichert nichts. Anders als Ressourcenkosten berechnen, das den veröffentlichten Tarif zeigt, ist dies der Betrag, zu dem der Kauf berechnet wird.

Für eine energy-Bestellung, die größer ist als der größte Energy-Service (bis zu 20 000 000 pro Bestellung), listet die Antwort zusätzlich die Teile auf, in denen die Bestellung ausgeführt wird. Senden Sie den zurückgegebenen amount als expected_amount an /v1/transaction/new, um genau diesen Betrag berechnet zu bekommen – optional und für eine solche Bestellung empfohlen.

POST /v1/transaction/quote

Anfrage

Der Body ist der von Transaktion erstellen: service, params (und external_id, das hier ignoriert wird). Er wird in derselben Reihenfolge und mit denselben Fehlercodes geprüft.

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

Antwort

Feld	Typ	Beschreibung
result.service	string	Der kalkulierte Service
result.amounts	object|null	Die kalkulierten Ressourcenmengen
result.duration	integer	Dauer in Stunden
result.amount	string	Der Gesamtbetrag in TRX – alle Teile und die Aktivierung, falls enthalten
result.activation	boolean	Ob der Gesamtbetrag die Aktivierung der Adresse enthält
result.parts	array|null	Die Teile einer großen Energy-Bestellung: jeweils resource_amount und amount (TRX); null für eine Bestellung, die in einem Teil ausgeführt wird

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

Ein Preis gilt für einen Moment und ist keine Reservierung: Preise ändern sich. Wird die Bestellung danach anders berechnet, lehnt /v1/transaction/new mit expected_amount sie mit Code 409 price_moved ab und bucht nichts ab.

Dieser Endpunkt zählt zum selben Kontingent für Preisabfragen wie Ressourcenkosten berechnen und Energie schätzen.

Mögliche Fehler

Die Fehler von Transaktion erstellen, die vor der Zahlung auftreten: 1, 2, 10, 11, 12, 24, 25, 35, 50, 429, wenn das Kontingent für Preisabfragen aufgebraucht ist, 503 temporarily_unavailable, wenn das TRON-Netzwerk die Adressprüfung nicht rechtzeitig beantwortet hat (HTTP 503, mit Retry-After-Header; versuchen Sie es gleich erneut), sowie 500.