نحوه خرید پهنای باند TRON از طریق API — اجاره پهنای باند (۲۰۲۶)

Alex Goldsmith
نویسنده و پژوهشگر
12 مقاله
این را در Claude Code یا Cursor جای‌گذاری کنید — انرژی و پهنای باند بخرید

Connect TronRental via its REST API and buy TRON resources — energy and/or bandwidth — for me.

این پرامپت را کپی کنید و در Claude Code، Cursor یا هر ابزار هوش مصنوعی جای‌گذاری کنید. هوش مصنوعی حساب می‌سازد، کلید API تولید می‌کند، آدرس واریز را نشان می‌دهد و از طریق REST API انرژی یا پهنای باند می‌خرد — بدون تنظیم دستی.

راه‌اندازی دائمی: سرور MCP

۱. دستور را کپی کنید:

۲. آن را در ترمینال اجرا کنید — Claude Code سرور را شناسایی می‌کند. (Cursor / Windsurf: ‏npx -y @tronrental-com/mcp-server را به mcp.json اضافه کنید.)

پس از اتصال، دستیار دسترسی مستقیم به TronRental پیدا می‌کند: حساب می‌سازد، کلید API تولید می‌کند، آدرس واریز را نشان می‌دهد و انرژی یا پهنای باند می‌خرد — همه با متن ساده: «۳۵۰ پهنای باند برای آدرس T... بخر».

درباره MCP بیشتر بدانید ←

در ادامه — برای کسانی که می‌خواهند جزئیات را بفهمند و ادغام را دستی بسازند.

چرا پهنای باند اجاره کنیم؟

هر تراکنش TRON پهنای باند مصرف می‌کند. هر آدرس فعال‌شده روزانه ۶۰۰ پهنای باند رایگان می‌گیرد — اما این سریع تمام می‌شود:

  • ۶۰۰ پهنای باند رایگان/روز = حدود ۱ انتقال USDT (TRC-20) — و تمام
  • پهنای باند رایگان تمام شد ← شبکه به‌جای آن در هر تراکنش حدود ۰٫۳۵ TRX می‌سوزاند

اجاره پهنای باند از طریق API برای ۳۵۰ واحد (یک انتقال) حدود ۰٫۳۴ TRX هزینه دارد. برای سرویس‌هایی که روزانه چند انتقال از یک آدرس انجام می‌دهند، اجاره ارزان‌تر و قابل‌پیش‌بینی‌تر است.

پهنای باند منبع ارزان است — اما در مقیاس بزرگ (پرداخت‌های انبوه، صرافی‌ها، بات‌ها) TRX سوخته‌شده انباشته می‌شود. آن را مثل انرژی اجاره کنید.

به چه چیزی نیاز دارید

  • حساب در tronrental.com
  • کلید API (داشبورد ← API ← ساخت کلید)
  • TRX در موجودی شما (داشبورد ← واریز)
  • ۵ دقیقه

شروع سریع: اولین خرید در ۳ مرحله

مرحله ۱ — بررسی قیمت

curl https://api.tronrental.com/v1/bandwidth/prices
{
  "price_sun_1h": 400,
  "price_sun_1d": 630,
  "min_volume": 350,
  "max_volume": 100000,
  "fixed_fee_trx": "0.2"
}

price_sun_1h قیمت هر واحد پهنای باند برای اجاره ۱ ساعته است؛ price_sun_1d برای ۱ روز. min_volume / max_volume محدوده یک سفارش را تعیین می‌کنند، fixed_fee_trx روی آن اضافه می‌شود.

مرحله ۲ — خرید پهنای باند

curl -X POST https://api.tronrental.com/v1/bandwidth/buy \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_address": "TRecipient...", "volume": 350, "duration": "1h"}'
{
  "id": 1842,
  "status": "pending",
  "volume": 350,
  "price_trx": "0.34",
  "target_address": "TRecipient..."
}

پهنای باند به target_address واگذار می‌شود — می‌تواند آدرس خودتان یا شخص دیگری باشد. ۳۵۰ واحد یک انتقال استاندارد USDT را پوشش می‌دهد.

مرحله ۳ — تأیید سفارش

curl https://api.tronrental.com/v1/orders/1842 \
  -H "X-API-Key: YOUR_API_KEY"
{
  "id": 1842,
  "status": "filled",
  "volume": 350,
  "txid": "a1b2c3..."
}

وقتی وضعیت "filled" شد — پهنای باند واگذار شده است. حالا می‌توانید تراکنش خود را ارسال کنید.

همین کار در Python

import httpx

API_KEY = "your_api_key"
BASE = "https://api.tronrental.com/v1"
HEADERS = {"X-API-Key": API_KEY}

async def buy_bandwidth(target_address: str, amount: int = 350) -> dict:
    async with httpx.AsyncClient() as client:
        resp = await client.post(
            f"{BASE}/bandwidth/buy",
            headers=HEADERS,
            json={"target_address": target_address, "volume": amount, "duration": "1h"},
        )
        resp.raise_for_status()
        return resp.json()

همین کار در JavaScript

const API_KEY = "your_api_key";
const BASE = "https://api.tronrental.com/v1";

async function buyBandwidth(targetAddress, amount = 350) {
  const resp = await fetch(`${BASE}/bandwidth/buy`, {
    method: "POST",
    headers: {
      "X-API-Key": API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      target_address: targetAddress,
      volume: amount,
      duration: "1h",
    }),
  });
  if (!resp.ok) throw new Error(`API error: ${resp.status}`);
  return resp.json();
}

چقدر پهنای باند بخریم؟

سناریوپهنای باندچرا
یک انتقال USDT350اندازه یک انتقال استاندارد TRC-20
چند انتقال از یک آدرس350 × N۶۰۰/روز رایگان فقط انتقال اول را پوشش می‌دهد

مطمئن نیستید چقدر پهنای باند رایگان مانده؟ قبل از خرید بررسی کنید:

curl "https://api.tronrental.com/v1/tools/address-info?address=TRecipient..."
{
  "bandwidth_used": 0,
  "bandwidth_limit": 600,
  "is_activated": true
}

محدودیت‌ها: حداقل ۳۵۰ پهنای باند در هر سفارش، حداکثر ۱۰۰٬۰۰۰. مدت‌ها: "1h" و "1d".

اجاره انرژی

پهنای باند خود تراکنش را پوشش می‌دهد، اما انتقال USDT (TRC-20) به انرژی هم نیاز دارد — و هزینه واقعی آنجاست. بدون انرژی، شبکه در هر انتقال ۶٫۴۳ تا ۱۳٫۲۸ TRX می‌سوزاند.

اگر USDT می‌فرستید، تقریباً همیشه به انرژی هم نیاز دارید. اجاره آن به‌جای سوزاندن ۶٫۴۳ TRX، برای ۶۵K حدود ۱٫۸۰ TRX هزینه دارد.

خرید

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

۶۵٬۰۰۰ انرژی = ۱ انتقال USDT (گیرنده از قبل USDT دارد)، ۱۳۱٬۰۰۰ اگر گیرنده هرگز USDT نداشته. برای جزئیات راهنمای اختصاصی API انرژی را ببینید.

مثال کامل: خرید پهنای باند ← ارسال تراکنش

الگوی دنیای واقعی — خرید پهنای باند برای آدرس فرستنده، انتظار برای واگذاری، سپس ارسال تراکنش:

import asyncio
import httpx

API_KEY = "your_api_key"
BASE = "https://api.tronrental.com/v1"
HEADERS = {"X-API-Key": API_KEY}


async def buy_bandwidth_and_wait(target: str, amount: int = 350) -> str:
    async with httpx.AsyncClient() as client:
        resp = await client.post(
            f"{BASE}/bandwidth/buy",
            headers=HEADERS,
            json={"target_address": target, "volume": amount, "duration": "1h"},
        )
        data = resp.json()

        if resp.status_code == 400:
            raise Exception(f"Purchase failed: {data.get('detail', data)}")
        resp.raise_for_status()

        order_id = data["id"]

        for _ in range(10):
            await asyncio.sleep(3)
            check = await client.get(f"{BASE}/orders/{order_id}", headers=HEADERS)
            order = check.json()
            if order["status"] == "filled":
                return order["txid"]

        raise TimeoutError(f"Order {order_id} not filled after 30s")


async def send_usdt_with_resources(sender: str, recipient: str, amount_usdt: float):
    bw_tx = await buy_bandwidth_and_wait(sender, amount=350)
    print(f"Bandwidth delegated: {bw_tx}")
    # ... your USDT transfer logic here (tronpy, tronweb, etc.)

مدیریت خطا

وضعیت HTTPیعنی چهچه کنیم
400درخواست نادرست (آدرس نامعتبر، موجودی ناکافی)پیام خطا را بخوانید، اصلاح کنید و دوباره تلاش کنید
429تجاوز از محدودیت نرخ (۱۰۰ درخواست/دقیقه)صبر کنید و با backoff دوباره تلاش کنید
5xxخطای سروربا backoff نمایی دوباره تلاش کنید

پرسش‌های متداول

پهنای باند چقدر سریع واگذار می‌شود؟

معمولاً ۳ تا ۵ ثانیه. پهنای باند در بلوک بعدی به‌صورت on-chain واگذار می‌شود.

آیا اصلاً نیاز به خرید پهنای باند دارم؟ مگر رایگان نیست؟

هر آدرس روزانه ۶۰۰ پهنای باند رایگان می‌گیرد — کافی برای حدود ۱ انتقال USDT. اگر روزانه بیش از این از یک آدرس انتقال دهید، شبکه برای پهنای باند TRX می‌سوزاند و اجاره ارزان‌تر است.

برای انتقال USDT به پهنای باند نیاز دارم یا انرژی؟

هر دو. پهنای باند رکورد تراکنش (~۳۵۰ واحد) را پوشش می‌دهد؛ انرژی اجرای قرارداد هوشمند (۶۵٬۰۰۰ واحد) را. انرژی گران‌قیمت است — بیشتر مردم هر دو را اجاره می‌کنند.

آیا می‌توانم برای آدرس شخص دیگری پهنای باند بخرم؟

بله. target_address را روی هر آدرس معتبر TRON تنظیم کنید. لازم نیست مالک آن باشید.

مستندات کامل کجاست؟

docs.tronrental.com — همه endpointها، اسکیماهای درخواست/پاسخ، تنظیم webhook و موارد دیگر.

اشتراک‌گذاری:

مفید بود؟