Enerji Kuralı Oluştur

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
}

Bir adres için bir Otomatik Dolum kuralı oluşturur. Bir sonraki kontrolden itibaren adresteki kullanılabilir enerji threshold_energy değerinin altına her düştüğünde, bir saatliğine add_volume kadar enerji satın alır ve bakiyenizden ücret alırız. Kontrollerin, maliyetin ve durumların nasıl işlediği için genel bakışa bakın. İstek yalnızca kuralı oluşturur — kendisi hiçbir şey satın almaz. buy_energy kapsamını gerektirir. Önce bir dolumun fiyatını görmek için Enerji Dolum Fiyatı uç noktasını kullanın.

İstek gövdesi

string

gerekli

Kaynağı sürekli sağlanacak TRON adresi (T… formatı, 34 karakter). Sözleşme adresleri reddedilir.

number

gerekli

Adresteki kullanılabilir enerji bu değerin altına düştüğünde satın alınır. 1 ile 50.000.000 arasında.

number

gerekli

Dolum başına satın alınacak enerji. 32.000 ile 5.000.000 arasında. Bu değeri threshold_energy ile aynı veya ondan yüksek tutun — bkz. genel bakıştaki uyarı.

string

varsayılan:"1h"

Her dolumun kiralama süresi. Yalnızca "1h" kabul edilir; başka herhangi bir değer 422 döndürür.

string

Kurala kendi verdiğiniz ad, en fazla 100 karakter. İsteğe bağlı.

Yanıt

Yeni kural — Enerji Kurallarını Listele ile aynı alanlar — ve adresin şu anki durumuna dair iki alan:

number | null

Kural oluşturulduğu anda adreste kullanılabilir olan enerji. Okunamadıysa null; kural her durumda oluşturulur.

boolean

current_energy zaten eşiğin altındaysa true; bu durumda bir sonraki kontrol — genellikle bir dakika içinde — satın alır. Adreste yeterli enerji varsa veya seviye okunamadıysa false.

Örnek

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
}

Hatalar

Durum	Kod	Ne zaman
`400`	`INVALID_ADDRESS`	`target_address` geçerli bir TRON adresi değil
`400`	`CONTRACT_ADDRESS_NOT_SUPPORTED`	`target_address` bir akıllı sözleşme
`403`	`FORBIDDEN`	API anahtarında `buy_energy` kapsamı yok
`409`	`AUTOREFILL_ADDRESS_TAKEN`	Hesabınızda bu adres için zaten bir enerji kuralı var — bunun yerine onu düzenleyin
`409`	`AUTOREFILL_LIMIT_REACHED`	Hesabınızda zaten 20 enerji kuralı var; sınır `error.limit` içinde de yer alır
`422`	—	Bir alan eksik veya aralık dışında ya da `duration` değeri `"1h"` değil
`429`	`RATE_LIMIT_EXCEEDED`	Bir dakika içinde 10’dan fazla oluşturma isteği
`503`	`AUTOREFILL_DISABLED`	Enerji için Otomatik Dolum geçici olarak kapalı; kural oluşturulmadı — daha sonra yeniden deneyin

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

Doğrulama hatası, çerçevenin kendi biçiminde ve detail bir dizi olarak gelir:

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

Zaman aşımından sonra oluşturma isteğini yeniden denemek güvenlidir. İlk istek başarılı olduysa yeniden deneme ikinci bir kural oluşturmaz, 409 AUTOREFILL_ADDRESS_TAKEN döndürür; kuralın id değerini almak için kurallarınızı listeleyin.

Enerji Kuralı Oluştur

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
}

Temel API

Bant Genişliği Kiralamaları

Otomatik Dolum

Siparişler

Faturalar

Smart Mode

Transfer Paketleri

Hesap

Webhooks

Enerji Kuralı Oluştur