Cotización de recarga de energía

GET

api

energy

auto-refill

quote

Cotización de recarga de energía

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

Cotización de recarga de energía

Devuelve lo que cuesta a tu cuenta una recarga de add_volume de energía: el precio que paga por recarga una regla con este volumen, comisión fija incluida. No se crea ni se cobra nada. Requiere el alcance view. El precio depende de cómo hagas la llamada. Con una clave API, es el precio de una regla creada con esa clave API; desde el sitio web, el precio de una regla creada en el sitio web. Es el precio en el momento de la solicitud, y no incluye la activación de una dirección que todavía no existe on-chain — eso lo añade la primera recarga.

Parámetros de consulta

number

requerido

Energía por recarga. De 32,000 a 5,000,000, el mismo rango que al crear una regla.

Las recargas de energía siempre duran una hora, así que no hay parámetro duration; la respuesta siempre trae "duration": "1h".

Respuesta

number

El volumen que consultaste

string

Duración del alquiler de la recarga — siempre 1h para la energía

string

Precio completo de una recarga para tu cuenta, comisión fija incluida

Ejemplo

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

Errores

Estado	Código	Cuándo
`403`	`FORBIDDEN`	La clave API carece del alcance `view`
`422`	—	Falta `add_volume` o está fuera de 32,000 – 5,000,000
`503`	`TEMPORARILY_UNAVAILABLE`	No se pudo obtener el precio en este momento — reintenta pasados los segundos de `Retry-After`

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

Un error de validación llega en el formato del framework, con 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}
    }
  ]
}

Cotización de recarga de energía

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

Alquileres de ancho de banda

Recarga automática

Órdenes

Facturas

Smart Mode

Paquetes de transferencia

Cuenta

Webhooks

Cotización de recarga de energía

Cotización de recarga de energía

Parámetros de consulta

Respuesta

Ejemplo

Errores

​Cotización de recarga de energía

​Parámetros de consulta

​Respuesta

​Ejemplo

​Errores

Cotización de recarga de energía

Parámetros de consulta

Respuesta

Ejemplo

Errores