Cotar Transação

Retorna o total exato que Criar Transação com o mesmo corpo cobraria agora, sem gravar nada. Diferente de Calcular Custo de Recursos, que mostra a tarifa publicada, este é o valor pelo qual a compra é cobrada.

Para um pedido energy maior que o maior serviço de energia (até 20 000 000 por pedido), a resposta também lista as partes em que o pedido será atendido. Envie o amount retornado como expected_amount em /v1/transaction/new para ser cobrado exatamente esse total — opcional e recomendado para esse pedido.

POST /v1/transaction/quote

Requisição

O corpo é o de Criar Transação: service, params (e external_id, que aqui é ignorado). Ele é validado na mesma ordem e com os mesmos códigos de erro.

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

Resposta

Campo	Tipo	Descrição
result.service	string	O serviço cotado
result.amounts	object|null	As quantidades de recursos cotadas
result.duration	integer	Duração em horas
result.amount	string	O total em TRX — todas as partes e a ativação, se incluída
result.activation	boolean	Se o total inclui a ativação do endereço
result.parts	array|null	As partes de um pedido grande de energia: cada uma com resource_amount e amount (TRX); null para um pedido atendido em uma única 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" }
    ]
  }
}

Uma cotação é um momento, não uma reserva: os preços mudam. Se o pedido depois tiver outro preço, /v1/transaction/new com expected_amount o recusa com o código 409 price_moved e não cobra nada.

Este endpoint consome o mesmo limite de consultas de preço que Calcular Custo de Recursos e Estimar Energia.

Erros Possíveis

Os erros de Criar Transação que ocorrem antes do pagamento: 1, 2, 10, 11, 12, 24, 25, 35, 50, 429 quando o limite de consultas de preço se esgota, 503 temporarily_unavailable quando a rede TRON não respondeu a tempo à verificação do endereço (HTTP 503, com o cabeçalho Retry-After; tente novamente em instantes), e 500.