Crear regla de energía

POST

api

energy

auto-refill

curl --request POST \
  --url https://api.example.com/api/v1/energy/auto-refill \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_address": "<string>",
  "threshold_energy": 123,
  "add_volume": 123,
  "duration": "<string>",
  "label": "<string>"
}
'

import requests

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

payload = {
    "target_address": "<string>",
    "threshold_energy": 123,
    "add_volume": 123,
    "duration": "<string>",
    "label": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    target_address: '<string>',
    threshold_energy: 123,
    add_volume: 123,
    duration: '<string>',
    label: '<string>'
  })
};

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'target_address' => '<string>',
    'threshold_energy' => 123,
    'add_volume' => 123,
    'duration' => '<string>',
    'label' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"target_address\": \"<string>\",\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/energy/auto-refill")
  .header("Content-Type", "application/json")
  .body("{\n  \"target_address\": \"<string>\",\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\"\n}")
  .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::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"target_address\": \"<string>\",\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\"\n}"

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

{
  "current_energy": {},
  "will_refill_now": true
}

Crea una regla de Recarga automática para una dirección. A partir de la siguiente comprobación, cada vez que la dirección tenga menos energía disponible que threshold_energy, compramos add_volume de energía por una hora y lo cobramos de tu saldo. Consulta la descripción general para ver cómo funcionan las comprobaciones, el coste y los estados. La solicitud solo crea la regla — no compra nada por sí misma. Requiere el alcance buy_energy. Para ver antes el precio de una recarga, usa Cotización de recarga de energía.

Cuerpo de la solicitud

string

requerido

Dirección TRON que se mantendrá abastecida (formato T…, 34 caracteres). Las direcciones de contrato se rechazan.

number

requerido

Se compra cuando la dirección tiene menos energía disponible que este valor. De 1 a 50,000,000.

number

requerido

Energía que se compra en cada recarga. De 32,000 a 5,000,000. Mantenlo igual o por encima de threshold_energy — consulta la advertencia de la descripción general.

string

predeterminado:"1h"

Duración del alquiler de cada recarga. Solo se acepta "1h"; cualquier otro valor devuelve 422.

string

Tu propio nombre para la regla, hasta 100 caracteres. Opcional.

Respuesta

La nueva regla — con los mismos campos que en Listar reglas de energía — más dos campos sobre el estado actual de la dirección:

number | null

Energía disponible en la dirección en el momento de crear la regla. null si no se pudo leer; la regla se crea de todos modos.

boolean

true si current_energy ya está por debajo del umbral, de modo que la siguiente comprobación — normalmente en menos de un minuto — comprará. false si la dirección tiene suficiente, o si no se pudo leer el nivel.

Ejemplo

curl -X POST https://api.tronrental.com/v1/energy/auto-refill \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "target_address": "TYourRecipientAddress1234567890abc",
    "threshold_energy": 65000,
    "add_volume": 131000,
    "duration": "1h",
    "label": "Hot wallet"
  }'

import requests

resp = requests.post(
    "https://api.tronrental.com/v1/energy/auto-refill",
    headers={"X-API-Key": "your_api_key"},
    json={
        "target_address": "TYourRecipientAddress1234567890abc",
        "threshold_energy": 65000,
        "add_volume": 131000,
        "duration": "1h",
        "label": "Hot wallet",
    },
)
print(resp.json())

const resp = await fetch("https://api.tronrental.com/v1/energy/auto-refill", {
  method: "POST",
  headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" },
  body: JSON.stringify({
    target_address: "TYourRecipientAddress1234567890abc",
    threshold_energy: 65000,
    add_volume: 131000,
    duration: "1h",
    label: "Hot wallet",
  }),
});
console.log(await resp.json());

Response

{
  "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": null,
  "last_available_energy": null,
  "last_read_error_at": null,
  "last_refill_at": null,
  "refill_count": 0,
  "total_spent_trx": "0.000000",
  "created_at": "2026-10-14T08:12:05Z",
  "estimated_cost_per_refill_trx": "2.618000",
  "volume_below_threshold": false,
  "current_energy": 0,
  "will_refill_now": true
}

Errores

Estado	Código	Cuándo
`400`	`INVALID_ADDRESS`	`target_address` no es una dirección TRON válida
`400`	`CONTRACT_ADDRESS_NOT_SUPPORTED`	`target_address` es un contrato inteligente
`403`	`FORBIDDEN`	La clave API carece del alcance `buy_energy`
`409`	`AUTOREFILL_ADDRESS_TAKEN`	Tu cuenta ya tiene una regla de energía para esta dirección — edítala en su lugar
`409`	`AUTOREFILL_LIMIT_REACHED`	Tu cuenta ya tiene 20 reglas de energía; el límite también figura en `error.limit`
`422`	—	Falta un campo o está fuera de rango, o `duration` no es `"1h"`
`429`	`RATE_LIMIT_EXCEEDED`	Más de 10 solicitudes de creación en un minuto
`503`	`AUTOREFILL_DISABLED`	La Recarga automática de energía está desactivada temporalmente; no se creó ninguna regla — reintenta más tarde

{
  "detail": {
    "error": {
      "code": "AUTOREFILL_LIMIT_REACHED",
      "message": "You already hold the maximum of auto-refill rules: 20 for energy and 20 for bandwidth, counted separately. Delete one to add another.",
      "limit": 20
    }
  }
}

{
  "detail": {
    "error": {
      "code": "AUTOREFILL_ADDRESS_TAKEN",
      "message": "Auto-refill for this address already exists"
    }
  }
}

{
  "detail": {
    "error": {
      "code": "AUTOREFILL_DISABLED",
      "message": "Auto-refill is temporarily unavailable; please try again later"
    }
  }
}

Un error de validación llega en el formato del framework, con detail como array:

{
  "detail": [
    {
      "type": "literal_error",
      "loc": ["body", "duration"],
      "msg": "Input should be '1h'",
      "input": "1d",
      "ctx": {"expected": "'1h'"}
    }
  ]
}

Reintentar una creación tras agotarse el tiempo de espera es seguro. Si la primera solicitud se completó, el reintento devuelve 409 AUTOREFILL_ADDRESS_TAKEN en lugar de crear una segunda regla; lista tus reglas para obtener su id.

Crear regla de energía

curl --request POST \
  --url https://api.example.com/api/v1/energy/auto-refill \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_address": "<string>",
  "threshold_energy": 123,
  "add_volume": 123,
  "duration": "<string>",
  "label": "<string>"
}
'

import requests

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

payload = {
    "target_address": "<string>",
    "threshold_energy": 123,
    "add_volume": 123,
    "duration": "<string>",
    "label": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    target_address: '<string>',
    threshold_energy: 123,
    add_volume: 123,
    duration: '<string>',
    label: '<string>'
  })
};

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'target_address' => '<string>',
    'threshold_energy' => 123,
    'add_volume' => 123,
    'duration' => '<string>',
    'label' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"target_address\": \"<string>\",\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/energy/auto-refill")
  .header("Content-Type", "application/json")
  .body("{\n  \"target_address\": \"<string>\",\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\"\n}")
  .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::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"target_address\": \"<string>\",\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\"\n}"

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

{
  "current_energy": {},
  "will_refill_now": true
}

API Principal

Alquileres de ancho de banda

Recarga automática

Órdenes

Facturas

Smart Mode

Paquetes de transferencia

Cuenta

Webhooks

Crear regla de energía