Preventivo Transazione

Restituisce il totale esatto che Crea Transazione con lo stesso corpo addebiterebbe in questo momento, senza registrare nulla. A differenza di Calcola Costo Risorse, che mostra la tariffa pubblicata, questo è l'importo a cui viene addebitato l'acquisto.

Per un ordine energy più grande del servizio di energia più grande (fino a 20 000 000 per ordine), la risposta elenca anche le parti in cui l'ordine verrà eseguito. Rinvia l'amount restituito come expected_amount su /v1/transaction/new per pagare esattamente quel totale: è facoltativo e consigliato per un ordine del genere.

POST /v1/transaction/quote

Richiesta

Il corpo è quello di Crea Transazione: service, params (e external_id, che qui viene ignorato). Viene validato nello stesso ordine e con gli stessi codici di errore.

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

Risposta

Campo	Tipo	Descrizione
result.service	string	Il servizio preventivato
result.amounts	object|null	Le quantità di risorse preventivate
result.duration	integer	Durata in ore
result.amount	string	Il totale in TRX: tutte le parti e l'attivazione, se inclusa
result.activation	boolean	Se il totale include l'attivazione dell'indirizzo
result.parts	array|null	Le parti di un grande ordine di energia: ciascuna con resource_amount e amount (TRX); null per un ordine eseguito in una sola parte

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

Un preventivo è un istante, non una prenotazione: i prezzi cambiano. Se in seguito l'ordine ha un prezzo diverso, /v1/transaction/new con expected_amount lo rifiuta con il codice 409 price_moved e non addebita nulla.

Questo endpoint consuma lo stesso limite di richieste di prezzo di Calcola Costo Risorse e Stima Energia.

Errori Possibili

Gli errori di Crea Transazione che si verificano prima del pagamento: 1, 2, 10, 11, 12, 24, 25, 35, 50, 429 quando il limite di richieste di prezzo è esaurito, 503 temporarily_unavailable quando la rete TRON non ha risposto in tempo alla verifica dell'indirizzo (HTTP 503, con l'header Retry-After; riprova tra un momento), e 500.