自动补充
创建能量规则
每当地址的能量低于阈值时为其补充能量
POST
/
api
/
v1
/
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
}创建能量规则
为一个地址创建自动补充规则。从下一次检查起，每当该地址的可用能量低于threshold_energy，我们就会购买一小时的 add_volume 能量，并从您的余额中扣费。检查、费用和状态的工作方式参见概述。
该请求只创建规则——本身不会购买任何东西。需要 buy_energy 权限。如需先查看一次补充的价格，请使用能量补充报价。
请求体
string
必填
需要持续供给的 TRON 地址（T… 格式，34 个字符）。不接受合约地址。
number
必填
当地址的可用能量低于此值时购买。范围 1 至 50,000,000。
string
默认值:"1h"
每次补充的租赁时长。只接受
"1h"；其他任何值都会返回 422。string
您为规则起的名称，最多 100 个字符。可选。
响应
新建的规则——字段与列出能量规则中的相同——另加两个反映地址当前状态的字段：number | null
创建规则时该地址的可用能量。无法读取时为
null；无论如何规则都会创建。boolean
如果
current_energy 已低于阈值，则为 true，下一次检查（通常在一分钟之内）就会购买。如果地址资源充足，或无法读取其可用量，则为 false。示例
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
}
错误
| 状态 | 代码 | 触发条件 |
|---|---|---|
400 | INVALID_ADDRESS | target_address 不是有效的 TRON 地址 |
400 | CONTRACT_ADDRESS_NOT_SUPPORTED | target_address 是智能合约 |
403 | FORBIDDEN | API 密钥缺少 buy_energy 权限 |
409 | AUTOREFILL_ADDRESS_TAKEN | 您的账户已有该地址的能量规则——请改为编辑它 |
409 | AUTOREFILL_LIMIT_REACHED | 您的账户已有 20 条能量规则；该上限也在 error.limit 中给出 |
422 | — | 缺少字段或字段超出范围，或 duration 不是 "1h" |
429 | RATE_LIMIT_EXCEEDED | 一分钟内的创建请求超过 10 次 |
503 | AUTOREFILL_DISABLED | 能量自动补充暂时关闭；未创建规则——请稍后重试 |
{
"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"
}
}
}
detail 是数组：
{
"detail": [
{
"type": "literal_error",
"loc": ["body", "duration"],
"msg": "Input should be '1h'",
"input": "1d",
"ctx": {"expected": "'1h'"}
}
]
}
超时后重试创建请求是安全的。如果第一次请求已经成功，重试会返回
409 AUTOREFILL_ADDRESS_TAKEN，而不会创建第二条规则；列出您的规则即可获取其 id。⌘I
创建能量规则
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
}