API TronRental برای مبتدیان: خرید انرژی TRON در ۷ مرحله

این راهنما برای توسعه‌دهندگان، سازندگان ربات و صاحبان کسب‌وکاری است که می‌خواهند خرید انرژی و پهنای باند TRON را خودکار کنند. هیچ تجربه قبلی با TRON لازم نیست.

پس از اتمام این راهنما، می‌توانید قیمت‌ها را بررسی کنید، انرژی بخرید، پهنای باند بخرید و وضعیت سفارش را — همه از طریق کد خودتان — پیگیری کنید.

آنچه می‌توانید با API بسازید:

API (رابط برنامه‌نویسی کاربردی) روشی است برای کنترل یک سرویس از طریق کد، به‌جای کلیک روی دکمه‌های سایت. آن را به‌عنوان یک ریموت‌کنترل برای TronRental تصور کنید.

با API TronRental می‌توانید همه کارهایی که روی سایت انجام می‌دهید — بررسی قیمت، خرید انرژی، خرید پهنای باند — را به‌صورت خودکار، از طریق یک اسکریپت یا سرور انجام دهید.

به tronrental.com بروید و یک حساب کاربری بسازید. می‌توانید با ایمیل، Google، Telegram یا کیف پول TronLink ثبت‌نام کنید.

پس از ثبت‌نام، به داشبورد خود بروید. اینجا جایی است که همه چیز را مدیریت می‌کنید: موجودی، سفارش‌ها، کلیدهای API و تنظیمات.

در داشبورد، به بخش API بروید و روی «ساخت کلید API» کلیک کنید.

کلید API مانند رمز عبور اسکریپت شماست. به TronRental می‌گوید چه کسی درخواست را ارسال می‌کند و هزینه را از موجودی حساب شما کسر می‌کند.

به Dashboard → Deposit بروید و آدرس واریز اختصاصی خود را کپی کنید.

TRX یا USDT (TRC-20) را به این آدرس ارسال کنید. واریز معمولاً ظرف 30 ثانیه تأیید می‌شود.

می‌توانید موجودی خود را از طریق API بررسی کنید:

curl -X GET https://tronrental.com/api/v1/account/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

# Python
import requests

API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}

r = requests.get("https://tronrental.com/api/v1/account/balance", headers=headers)
print(r.json())

// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";

const res = await fetch("https://tronrental.com/api/v1/account/balance", {
  headers: { "Authorization": `Bearer ${API_KEY}` }
});
console.log(await res.json());

پاسخ:

{
  "balance_trx": "150.50",
  "balance_usdt": "0.00",
  "deposit_address": "TYour1Deposit2Address3Here..."
}

پیش از خرید، قیمت‌های جاری را بررسی کنید. این endpoint عمومی است — نیازی به کلید API نیست.

curl -X GET https://tronrental.com/api/v1/prices

# Python
import requests
r = requests.get("https://tronrental.com/api/v1/prices")
print(r.json())

// JavaScript
const res = await fetch("https://tronrental.com/api/v1/prices");
console.log(await res.json());

پاسخ:

{
  "energy_sun_per_unit": "33",
  "energy_trx_per_65k": "2.12",
  "bandwidth_trx": {
    "1d": "9.60"
  },
  "burn_cost_trx": "6.43",
  "savings_percent": "72",
  "trx_usd_rate": "0.25"
}

حالا به بخش اصلی می‌رسیم — خرید انرژی. یک درخواست POST با آدرس مقصد، حجم و مدت زمان ارسال کنید.

درخواست:

curl -X POST https://tronrental.com/api/v1/energy/buy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_address": "TReceiverAddress...",
    "volume": 65000,
    "duration": "1h"
  }'

# Python
import requests

API_KEY = "YOUR_API_KEY"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

data = {
    "target_address": "TReceiverAddress...",
    "volume": 65000,
    "duration": "1h"
}

r = requests.post("https://tronrental.com/api/v1/energy/buy",
                   headers=headers, json=data)
print(r.json())

// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";

const res = await fetch("https://tronrental.com/api/v1/energy/buy", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    target_address: "TReceiverAddress...",
    volume: 65000,
    duration: "1h"
  })
});
console.log(await res.json());

پاسخ:

{
  "id": 1234,
  "type": "energy",
  "target_address": "TReceiverAddress...",
  "volume": 65000,
  "duration": "1h",
  "price_trx": "2.12",
  "status": "pending",
  "created_at": "2026-02-28T12:00:00Z"
}

پهنای باند دقیقاً مانند انرژی عمل می‌کند. برای هر تراکنش TRON (نه فقط USDT) لازم است.

درخواست:

curl -X POST https://tronrental.com/api/v1/bandwidth/buy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_address": "TReceiverAddress...",
    "volume": 5000,
    "duration": "1h"
  }'

# Python
import requests

API_KEY = "YOUR_API_KEY"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

data = {
    "target_address": "TReceiverAddress...",
    "volume": 5000,
    "duration": "1h"
}

r = requests.post("https://tronrental.com/api/v1/bandwidth/buy",
                   headers=headers, json=data)
print(r.json())

// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";

const res = await fetch("https://tronrental.com/api/v1/bandwidth/buy", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    target_address: "TReceiverAddress...",
    volume: 5000,
    duration: "1h"
  })
});
console.log(await res.json());

پاسخ:

{
  "id": 1235,
  "type": "bandwidth",
  "target_address": "TReceiverAddress...",
  "volume": 5000,
  "duration": "1h",
  "price_trx": "2.20",
  "status": "pending",
  "created_at": "2026-02-28T12:05:00Z"
}

پس از ثبت سفارش، می‌توانید در هر زمان وضعیت آن را بررسی کنید.

دریافت همه سفارش‌های شما:

curl -X GET https://tronrental.com/api/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY"

دریافت یک سفارش خاص با شناسه:

curl -X GET https://tronrental.com/api/v1/orders/1234 \
  -H "Authorization: Bearer YOUR_API_KEY"

# Python
import requests

API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}

# All orders
orders = requests.get("https://tronrental.com/api/v1/orders",
                       headers=headers).json()

# Single order
order = requests.get("https://tronrental.com/api/v1/orders/1234",
                      headers=headers).json()
print(order["status"])  # "delegated"

پاسخ:

{
  "id": 1234,
  "type": "energy",
  "target_address": "TReceiverAddress...",
  "volume": 65000,
  "duration": "1h",
  "price_trx": "2.12",
  "status": "delegated",
  "delegate_txid": "abc123def456...",
  "created_at": "2026-02-28T12:00:00Z",
  "delegated_at": "2026-02-28T12:00:04Z"
}

به فیلد "status" توجه کنید. وقتی مقدار آن "delegated" باشد، انرژی یا پهنای باند با موفقیت به آدرس مقصد تحویل داده شده است. فیلد "delegate_txid" حاوی هش تراکنش روی زنجیره است.