Recarga automática
Listar reglas de energía
Todas las reglas de Recarga automática de energía de tu cuenta
GET
/
api
/
v1
/
energy
/
auto-refill
Listar reglas de energía
curl --request GET \
--url https://api.example.com/api/v1/energy/auto-refillimport requests
url = "https://api.example.com/api/v1/energy/auto-refill"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/v1/energy/auto-refill', 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",
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"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/energy/auto-refill")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/energy/auto-refill")
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{
"rules": [
{
"id": 123,
"target_address": "<string>",
"label": {},
"threshold_energy": 123,
"add_volume": 123,
"duration": "<string>",
"status": "<string>",
"stopped_reason": {},
"consecutive_failures": 123,
"last_checked_at": {},
"last_available_energy": {},
"last_read_error_at": {},
"last_refill_at": {},
"refill_count": 123,
"total_spent_trx": "<string>",
"created_at": "<string>",
"estimated_cost_per_refill_trx": {},
"volume_below_threshold": true
}
]
}Listar reglas de energía
Devuelve todas las reglas de Recarga automática de energía de tu cuenta, de la más antigua a la más reciente. Las reglas eliminadas no se incluyen. Requiere el alcanceview.
Respuesta
array
Tus reglas de energía.
Mostrar objeto de regla
Mostrar objeto de regla
number
ID de la regla — úsalo en las rutas de edición y eliminación
string
La dirección que la regla mantiene abastecida
string | null
Tu nombre para la regla
number
La regla compra cuando la energía disponible está por debajo de este valor
number
Energía comprada en cada recarga
string
Duración del alquiler de cada recarga — siempre
1hstring
active, paused o stopped_insufficient_balance — ver Estado de la reglastring | null
Por qué se pausó o se detuvo la regla:
insufficient_balance, order_failed, activation_failed o invalid_params. null si no hay ningún motivo.number
Recargas fallidas seguidas. La regla se pausa cuando llega a 5; una recarga exitosa lo devuelve a 0.
string | null
Cuándo comprobamos la dirección por última vez (ISO 8601, UTC), se haya podido leer o no.
null antes de la primera comprobación.number | null
Energía disponible en la dirección en la última comprobación correcta.
null antes de la primera lectura correcta.string | null
Cuándo falló por última vez una comprobación al leer la dirección (ISO 8601, UTC).
null si la última comprobación fue correcta. Mientras tenga valor, last_available_energy procede de una comprobación anterior y puede estar desactualizado. Una comprobación que no puede leer la dirección no compra nada.string | null
Cuándo se hizo la última recarga.
null si aún no ha habido ninguna.number
Recargas exitosas desde que se creó la regla
string
TRX gastados en esas recargas, en total
string
Cuándo se creó la regla (ISO 8601, UTC)
string | null
Precio completo de una recarga para tu cuenta a los precios actuales, comisión fija incluida. La activación de la dirección, cuando hace falta, se cobra aparte.
null si el precio no está disponible temporalmente.boolean
true cuando add_volume es menor que threshold_energy. En ese caso, una recarga puede no subir la dirección por encima del umbral, y la regla vuelve a comprar después de cada gasto — consulta la advertencia de la descripción general.Ejemplo
curl https://api.tronrental.com/v1/energy/auto-refill \
-H "X-API-Key: your_api_key"
import requests
resp = requests.get(
"https://api.tronrental.com/v1/energy/auto-refill",
headers={"X-API-Key": "your_api_key"},
)
print(resp.json())
const resp = await fetch("https://api.tronrental.com/v1/energy/auto-refill", {
headers: { "X-API-Key": "your_api_key" },
});
console.log(await resp.json());
Response
{
"rules": [
{
"id": 12,
"target_address": "TYourRecipientAddress1234567890abc",
"label": "Hot wallet",
"threshold_energy": 65000,
"add_volume": 131000,
"duration": "1h",
"status": "active",
"stopped_reason": null,
"consecutive_failures": 0,
"last_checked_at": "2026-10-14T09:41:02Z",
"last_available_energy": 212480,
"last_read_error_at": null,
"last_refill_at": "2026-10-14T08:57:40Z",
"refill_count": 3,
"total_spent_trx": "7.854000",
"created_at": "2026-10-14T08:12:05Z",
"estimated_cost_per_refill_trx": "2.618000",
"volume_below_threshold": false
}
]
}
Errores
| Estado | Código | Cuándo |
|---|---|---|
403 | FORBIDDEN | La clave API carece del alcance view |
⌘I
Listar reglas de energía
curl --request GET \
--url https://api.example.com/api/v1/energy/auto-refillimport requests
url = "https://api.example.com/api/v1/energy/auto-refill"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/v1/energy/auto-refill', 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",
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"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/energy/auto-refill")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/energy/auto-refill")
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{
"rules": [
{
"id": 123,
"target_address": "<string>",
"label": {},
"threshold_energy": 123,
"add_volume": 123,
"duration": "<string>",
"status": "<string>",
"stopped_reason": {},
"consecutive_failures": 123,
"last_checked_at": {},
"last_available_energy": {},
"last_read_error_at": {},
"last_refill_at": {},
"refill_count": 123,
"total_spent_trx": "<string>",
"created_at": "<string>",
"estimated_cost_per_refill_trx": {},
"volume_below_threshold": true
}
]
}