Recarga automática
Listar reglas de ancho de banda
Todas las reglas de Recarga automática de ancho de banda de tu cuenta
GET
/
api
/
v1
/
bandwidth
/
auto-refill
Listar reglas de ancho de banda
curl --request GET \
--url https://api.example.com/api/v1/bandwidth/auto-refillimport requests
url = "https://api.example.com/api/v1/bandwidth/auto-refill"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/v1/bandwidth/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/bandwidth/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/bandwidth/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/bandwidth/auto-refill")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/bandwidth/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_bandwidth": 123,
"add_volume": 123,
"duration": "<string>",
"status": "<string>",
"stopped_reason": {},
"consecutive_failures": 123,
"last_checked_at": {},
"last_available_bandwidth": {},
"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 ancho de banda
Devuelve todas las reglas de Recarga automática de ancho de banda 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 ancho de banda.
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 el ancho de banda disponible está por debajo de este valor
number
Ancho de banda comprado en cada recarga
string
Duración del alquiler de cada recarga —
1h o 1dstring
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
Ancho de banda disponible en la dirección en la última comprobación correcta, ancho de banda gratuito incluido.
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_bandwidth 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_bandwidth. 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/bandwidth/auto-refill \
-H "X-API-Key: your_api_key"
import requests
resp = requests.get(
"https://api.tronrental.com/v1/bandwidth/auto-refill",
headers={"X-API-Key": "your_api_key"},
)
print(resp.json())
const resp = await fetch("https://api.tronrental.com/v1/bandwidth/auto-refill", {
headers: { "X-API-Key": "your_api_key" },
});
console.log(await resp.json());
Response
{
"rules": [
{
"id": 15,
"target_address": "TYourRecipientAddress1234567890abc",
"label": "Payouts",
"threshold_bandwidth": 1000,
"add_volume": 5000,
"duration": "1h",
"status": "active",
"stopped_reason": null,
"consecutive_failures": 0,
"last_checked_at": "2026-10-14T09:41:02Z",
"last_available_bandwidth": 3655,
"last_read_error_at": null,
"last_refill_at": "2026-10-14T09:12:30Z",
"refill_count": 4,
"total_spent_trx": "1.480000",
"created_at": "2026-10-14T08:15:00Z",
"estimated_cost_per_refill_trx": "0.370000",
"volume_below_threshold": false
}
]
}
Errores
| Estado | Código | Cuándo |
|---|---|---|
403 | FORBIDDEN | La clave API carece del alcance view |
⌘I
Listar reglas de ancho de banda
curl --request GET \
--url https://api.example.com/api/v1/bandwidth/auto-refillimport requests
url = "https://api.example.com/api/v1/bandwidth/auto-refill"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/v1/bandwidth/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/bandwidth/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/bandwidth/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/bandwidth/auto-refill")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/bandwidth/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_bandwidth": 123,
"add_volume": 123,
"duration": "<string>",
"status": "<string>",
"stopped_reason": {},
"consecutive_failures": 123,
"last_checked_at": {},
"last_available_bandwidth": {},
"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
}
]
}