Cotação de recarga de energia

GET

api

energy

auto-refill

quote

Cotação de recarga de energia

curl --request GET \
  --url https://api.example.com/api/v1/energy/auto-refill/quote

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/energy/auto-refill/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/energy/auto-refill/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/energy/auto-refill/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/energy/auto-refill/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "add_volume": 123,
  "duration": "<string>",
  "estimated_cost_per_refill_trx": "<string>"
}

Cotação de recarga de energia

Retorna quanto custa para a sua conta uma recarga de add_volume de energia: o preço que uma regra com esse volume paga por recarga, taxa fixa incluída. Nada é criado nem cobrado. Exige o escopo view. O preço depende de como você faz a chamada. Chamado com uma chave de API, é o preço de uma regra criada com essa chave de API; a partir do site, o preço de uma regra criada no site. É o preço no momento da requisição e não inclui a ativação de um endereço que ainda não existe na blockchain — a primeira recarga acrescenta esse valor.

Parâmetros de consulta

number

obrigatório

Energia por recarga. De 32.000 a 5.000.000, o mesmo intervalo aceito ao criar uma regra.

As recargas de energia sempre duram uma hora, por isso não há parâmetro duration; a resposta sempre traz "duration": "1h".

Resposta

number

O volume que você consultou

string

Duração do aluguel da recarga — sempre 1h para energia

string

Preço total de uma recarga para a sua conta, taxa fixa incluída

Exemplo

curl "https://api.tronrental.com/v1/energy/auto-refill/quote?add_volume=131000" \
  -H "X-API-Key: your_api_key"

import requests

resp = requests.get(
    "https://api.tronrental.com/v1/energy/auto-refill/quote",
    headers={"X-API-Key": "your_api_key"},
    params={"add_volume": 131000},
)
print(resp.json())

const resp = await fetch(
  "https://api.tronrental.com/v1/energy/auto-refill/quote?add_volume=131000",
  { headers: { "X-API-Key": "your_api_key" } },
);
console.log(await resp.json());

Response

{
  "add_volume": 131000,
  "duration": "1h",
  "estimated_cost_per_refill_trx": "2.618000"
}

Erros

Status	Código	Quando
`403`	`FORBIDDEN`	A chave de API não tem o escopo `view`
`422`	—	`add_volume` está ausente ou fora de 32.000 – 5.000.000
`503`	`TEMPORARILY_UNAVAILABLE`	Não foi possível obter o preço agora — tente novamente após os segundos indicados em `Retry-After`

{
  "detail": {
    "error": {
      "code": "TEMPORARILY_UNAVAILABLE",
      "message": "Please retry shortly"
    }
  }
}

Um erro de validação vem no formato do framework, com detail como array:

{
  "detail": [
    {
      "type": "greater_than_equal",
      "loc": ["query", "add_volume"],
      "msg": "Input should be greater than or equal to 32000",
      "input": "1000",
      "ctx": {"ge": 32000}
    }
  ]
}

Cotação de recarga de energia

curl --request GET \
  --url https://api.example.com/api/v1/energy/auto-refill/quote

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/energy/auto-refill/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/energy/auto-refill/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/energy/auto-refill/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/energy/auto-refill/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "add_volume": 123,
  "duration": "<string>",
  "estimated_cost_per_refill_trx": "<string>"
}

API Principal

Aluguéis de largura de banda

Recarga automática

Pedidos

Faturas

Smart Mode

Pacotes de transferência

Conta

Webhooks

Cotação de recarga de energia

Cotação de recarga de energia

Parâmetros de consulta

Resposta

Exemplo

Erros

​Cotação de recarga de energia

​Parâmetros de consulta

​Resposta

​Exemplo

​Erros

Cotação de recarga de energia

Parâmetros de consulta

Resposta

Exemplo

Erros