Coter une transaction

Renvoie le total exact que Créer une transaction prélèverait maintenant avec le même corps, sans rien enregistrer. Contrairement à Calculer le coût des ressources, qui affiche le tarif publié, c'est le montant auquel l'achat est facturé.

Pour une commande energy supérieure au plus grand service d'énergie (jusqu'à 20 000 000 par commande), la réponse liste aussi les parties dans lesquelles la commande sera exécutée. Renvoyez le amount obtenu en tant que expected_amount sur /v1/transaction/new pour être facturé exactement ce total — facultatif, et recommandé pour une telle commande.

POST /v1/transaction/quote

Requête

Le corps est celui de Créer une transaction : service, params (et external_id, ignoré ici). Il est validé dans le même ordre et avec les mêmes codes d'erreur.

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

Réponse

Champ	Type	Description
result.service	string	Le service coté
result.amounts	object|null	Les quantités de ressources cotées
result.duration	integer	Durée en heures
result.amount	string	Le total en TRX — toutes les parties, et l'activation si elle est incluse
result.activation	boolean	Si le total inclut l'activation de l'adresse
result.parts	array|null	Les parties d'une grande commande d'énergie : chacune avec resource_amount et amount (TRX) ; null pour une commande exécutée en une seule partie

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

Une cotation est un instant, pas une réservation : les prix évoluent. Si la commande est ensuite facturée autrement, /v1/transaction/new avec expected_amount la refuse avec le code 409 price_moved et ne prélève rien.

Ce endpoint consomme le même quota de demandes de prix que Calculer le coût des ressources et Estimer l'énergie.

Erreurs possibles

Les erreurs de Créer une transaction qui surviennent avant le paiement : 1, 2, 10, 11, 12, 24, 25, 35, 50, 429 lorsque le quota de demandes de prix est épuisé, 503 temporarily_unavailable lorsque le réseau TRON n'a pas répondu à temps à la vérification de l'adresse (HTTP 503, avec l'en-tête Retry-After ; réessayez dans un instant), et 500.