API v2 را برای نقل قول، ایجاد و پیگیری سفارشات اجاره TRON Energy به صورت برنامهریزی ادغام کنید. به صورت زنجیره ای یا از موجودی TronBid خود پرداخت کنید و TRX سوزانده شده توسط تماس های قرارداد هوشمند را کاهش دهید.
Quick Rent API راهی برای اجاره TRON Energy به صورت خودکار، بدون کار دستی است. انرژی نقل و انتقالات USDT (TRC-20) و سایر تماس های قرارداد هوشمند را ارزان تر از سوزاندن TRX می کند.
به عبارت ساده: برنامه شما (یک سایت، ربات یا سرویس) خودش انرژی را می خرد، دقیقاً در زمانی که نیاز است - به عنوان مثال، قبل از هر انتقال USDT که مشتری شما انجام می دهد.
به یک دستگاه فروش خودکار فکر کنید: شما قیمت را بررسی می کنید، پول وارد می کنید، کالای خود را دریافت می کنید. API همان مجموعه دکمهها است - فقط برنامه شما آنها را فشار میدهد.
برنامه شما از API می پرسد که در حال حاضر بسته انرژی مورد نیاز چقدر هزینه دارد.
برنامه شما سفارشی ایجاد می کند و آن را با ارسال TRX به آدرس داده شده یا با شارژ موجودی TronBid شما پرداخت می کند.
در عرض چند ثانیه انرژی روی کیف پول هدف ظاهر می شود و USDT می تواند ارزان تر ارسال شود.
مهم: API ابزاری برای یک توسعه دهنده است. برای استفاده از آن، شخصی باید کدی بنویسد که درخواست ها را ارسال می کند.
اگر کسی برای کدنویسی نیست — از خرید انرژی آماده در سایت (اجاره سریع) یا ربات تلگرام @tronbid استفاده کنید. نتیجه مشابه، فقط به صورت دستی انجام می شود.
یک مثال کامل از پایان به انتها در ساده ترین سناریو (روی زنجیره). چهار قدم و انرژی روی کیف پول است.
در زیر آنچه در هر مرحله اتفاق میافتد و آنچه API برمیگرداند آمده است. کلید API، آدرس ها و شناسه سفارش خود را وصل کنید.
مقدار انرژی و مدت زمان را ارسال کنید. شما price_trx را پس می گیرید و برای چند ثانیه قفل است.
گیرنده منابع: target_address. POST /orders (energy_amount, duration_minutes, idempotency_key, target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
میتوانید TRX را از هر کیف پولی پرداخت کنید. Energy یا Bandwidth به گیرنده مشخصشده در سفارش میرسد. نیازی به انتخاب کیف پول پرداخت نیست. پیش از انقضای سفارش، مبلغ دقیق را به آدرس پرداخت نمایشدادهشده در همین سفارش ارسال کنید. از آدرس پرداخت سفارش قبلی دوباره استفاده نکنید. (amount_trx TRX → pay_address; expires_at)
وضعیت را هر چند ثانیه یک بار نظرسنجی کنید تا زمانی که به آن واگذار شود. این بدان معناست که انرژی به کیف پول منتقل می شود - انجام شد.
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"payment_mode": "onchain",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}# poll every 3s until the order is done
while true; do
STATUS=$(curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
-H "Authorization: Bearer $API_KEY" | jq -r .status)
echo "status: $STATUS"
case "$STATUS" in
delegated|failed|expired|cancelled) break ;;
esac
sleep 3
done{
"id": "uuid",
"status": "delegated",
"payment_mode": "onchain",
"amount_trx": "3.200000",
"energy_amount": 131000,
"effective_energy_amount": 131000,
"duration_minutes": 15,
"pay_address": "TDeposit...",
"payer_address": "TPayer...",
"target_address": "TTarget...",
"error_code": null,
"error_message": null
}توضیحات کوتاهی در مورد کلمات استفاده شده در این مستند.
چه چیزی را قبل از اولین درخواست خود آماده کنید.
در تلگرام به @tronbid پیام دهید — یک کلید به حساب TronBid خود دریافت خواهید کرد. درخواست ها بدون آن تصویب نمی شوند.
آدرسی (target_address) که به انرژی نیاز دارد را تعیین کنید. معمولاً این کیف پولی است که مشتریان شما USDT از آن ارسال می کنند.
انرژی به صورت بسته بندی (معمولا 65000 یا 131000 انرژی برای 15 یا 60 دقیقه) فروخته می شود. لیست زنده را از نقطه پایانی کاتالوگ دریافت کنید، بدون نیاز به احراز هویت.
برای زنجیره ای - یک کیف پول با TRX برای پرداخت. برای پرداخت موجودی - یک حساب TronBid دارای بودجه و حالت موجودی فعال است.
Quick Rent API به خدمات شما اجازه می دهد تا TRON Energy را به صورت خودکار اجاره کند، بنابراین انتقال USDT TRC-20 و سایر تماس های قرارداد هوشمند هزینه کمتری نسبت به سوزاندن TRX دارند.
همه نقاط پایانی یک URL پایه مشترک دارند.
https://tronbid.com/api/v2/quick-rentدو روش برای پرداخت هزینه سفارش وجود دارد. On-chain پیش فرض است و نیازی به تنظیم ندارد. پرداخت موجودی اختیاری است و باید برای کلید شما فعال شود.
بدون فعالسازی، یک درخواست با pay_mode: موجودی 403 BALANCE_PAYMENT_NOT_ENABLED را برمیگرداند. برای فعال کردن آن، با پشتیبانی TronBid تماس بگیرید.
| Mode | نحوه فعال کردن | پرداخت |
|---|---|---|
on-chain | پیشفرض - حذف mode_pay (یا "onchain") | میتوانید TRX را از هر کیف پولی پرداخت کنید. Energy یا Bandwidth به گیرنده مشخصشده در سفارش میرسد. نیازی به انتخاب کیف پول پرداخت نیست. amount_trx TRX → pay_address |
balance | Pay_mode: موجودی + برای کلید شما فعال است | از موجودی TronBid TRX شما برداشت شده است |
انرژی_مقدار و مدت_دقیقه باید با بسته اجاره سریع فعال مطابقت داشته باشد — معمولاً 65000 یا 131000 انرژی و 15 یا 60 دقیقه.
کاتالوگ فعلی را در هر زمان واکشی کنید (بدون نیاز به تأیید اعتبار):
curl -sS https://tronbid.com/api/public/quick-rent/skusمیتوانید TRX را از هر کیف پولی پرداخت کنید. Energy یا Bandwidth به گیرنده مشخصشده در سفارش میرسد. نیازی به انتخاب کیف پول پرداخت نیست. POST /quote → POST /orders (target_address, payment_mode: "onchain") → amount_trx TRX → pay_address → GET /orders/:id. پیش از انقضای سفارش، مبلغ دقیق را به آدرس پرداخت نمایشدادهشده در همین سفارش ارسال کنید. از آدرس پرداخت سفارش قبلی دوباره استفاده نکنید.
نام جایگزین قدیمی و اختیاری برای target_address است و کیف پول پرداختکننده را محدود نمیکند.
پیش از انقضای سفارش، مبلغ دقیق را به آدرس پرداخت نمایشدادهشده در همین سفارش ارسال کنید. از آدرس پرداخت سفارش قبلی دوباره استفاده نکنید.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-001",
"payment_mode": "onchain",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"payment_mode": "onchain",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}مرحله 1 - برای بررسی TRX خود، /balance را دریافت کنید. مرحله 2 - POST / نقل قول برای قیمت. مرحله 3 - POST / orders with payment_mode: موجودی تا بدهی و شروع تفویض اختیار. مرحله 4 - نظرسنجی GET /orders/:id را تا زمان واگذاری (در صورت خطای تفویض اختیار ناموفق می شود و TRX به موجودی شما بازپرداخت می شود).
payer_address مورد نیاز نیست - حساب مرتبط با کلید API شما پرداخت می کند. انرژی_مقدار در پاسخ می تواند بالاتر از SKU سفارش داده شده (جایزه ماتریس قیمت) باشد.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-balance-001",
"payment_mode": "balance",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "delegating",
"payment_mode": "balance",
"pay_address": null,
"amount_trx": "3.200000",
"energy_amount": 132310,
"duration_minutes": 15,
"expires_at": null,
"qr_payload": null,
"duplicate": false,
"target_address": "TTarget..."
}هر سفارش از طریق این وضعیت ها حرکت می کند. نظرسنجی GET /orders/:id را دنبال کنید.
| Status | معنی |
|---|---|
pending_payment | در انتظار پرداخت زنجیره ای |
delegating | پرداخت دریافت شده یا موجودی شارژ شده؛ هیئت در حال انجام |
delegated | انرژی تفویض شده است |
cancelled | لغو قبل از پرداخت (در زنجیره) |
expired | پنجره پرداخت زنجیره ای سپری شده است |
failed | خطا (برای موجودی، TRX بازپرداخت می شود) |
idempotency_key (8 تا 128 نویسه) یک شناسه سفارش منحصر به فرد در سمت شما است. تکرار POST /orders با یک کلید (برای مشتری API یکسان) همان ترتیب را با "تکراری" برمی گرداند: true.
از یک idempotency_key در حالتهای پرداخت مختلف (onchain در مقابل موجودی) استفاده مجدد نکنید – که 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH را برمیگرداند.
برآورد کنید که یک آدرس برای انتقال به چه مقدار انرژی نیاز دارد. کیف پول گیرنده را ارسال کنید و اینکه آیا قبلاً USDT را در اختیار دارد یا خیر.
/api/v2/quick-rent/calculator| پارامتر | Type | توضیحات | Example |
|---|---|---|---|
آدرس_کیف پول | string | آدرس TRON برای تجزیه و تحلیل | TXXXXXXXX...XXXX |
has_usdt | boolean | null | اینکه آیا گیرنده قبلاً USDT دارد (بر انرژی تأثیر می گذارد). درست، نادرست، یا حذف. | true |
{
"wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"has_usdt": true
}curl -sS -X POST "$BASE_URL/api/v2/quick-rent/calculator" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"wallet_address":"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","has_usdt":true}'قیمت فعلی یک بسته را برمیگرداند: price_trx، در دسترس بودن، save_percent و مدت زمان اعتبار مظنه (expires_in_sec).
/api/v2/quick-rent/quote| پارامتر | Type | توضیحات | Example |
|---|---|---|---|
انرژی_مقدار | int | مقدار انرژی از کاتالوگ فعال | 131000 |
مدت_دقیقه | int | مدت زمان اجاره از کاتالوگ | 15 |
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}export BASE_URL="https://tronbid.com"
export API_KEY="your_api_key"
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/quote" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"energy_amount":131000,"duration_minutes":15}'میتوانید TRX را از هر کیف پولی پرداخت کنید. Energy یا Bandwidth به گیرنده مشخصشده در سفارش میرسد. نیازی به انتخاب کیف پول پرداخت نیست. POST /orders (target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
پیش از انقضای سفارش، مبلغ دقیق را به آدرس پرداخت نمایشدادهشده در همین سفارش ارسال کنید. از آدرس پرداخت سفارش قبلی دوباره استفاده نکنید.
/api/v2/quick-rent/orders| پارامتر | Type | توضیحات | Example |
|---|---|---|---|
energy_amount | int | مقدار انرژی از کاتالوگ | 131000 |
duration_minutes | int | مدت زمان اجاره از کاتالوگ | 15 |
idempotency_key | string | شناسه سفارش منحصر به فرد شما (8 تا 128 نویسه) | partner-onchain-001 |
payment_mode | string | اختیاری. "onchain" (پیش فرض) یا "تعادل". | balance |
payer_address | string | نام جایگزین قدیمی و اختیاری برای target_address است و کیف پول پرداختکننده را محدود نمیکند. | TTarget... |
target_address | string | گیرنده منابع. میتوانید TRX را از هر کیف پولی پرداخت کنید. Energy یا Bandwidth به گیرنده مشخصشده در سفارش میرسد. نیازی به انتخاب کیف پول پرداخت نیست. | TTarget... |
{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"payment_mode": "onchain",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}{
"id": "uuid",
"status": "delegating",
"payment_mode": "balance",
"pay_address": null,
"amount_trx": "3.200000",
"energy_amount": 132310,
"duration_minutes": 15,
"expires_at": null,
"qr_payload": null,
"duplicate": false,
"target_address": "TTarget..."
}curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "partner-onchain-001",
"payment_mode": "onchain",
"target_address": "TTarget..."
}'curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "partner-balance-001",
"payment_mode": "balance",
"target_address": "TTarget..."
}'در صورت عدم موفقیت، وضعیت فعلی، حالت پرداخت، مبالغ، آدرسها و error_code / error_message را برمیگرداند. effect_energy_amount منعکس کننده انرژی واقعی واگذار شده پس از پرداخت کمتر/بیش از حد است.
/api/v2/quick-rent/orders/:id| پارامتر | Type | توضیحات | Example |
|---|---|---|---|
شناسه | string | شناسه سفارش (پارامتر مسیر) | uuid |
{
"id": "uuid",
"status": "delegated",
"payment_mode": "onchain",
"amount_trx": "3.200000",
"energy_amount": 131000,
"effective_energy_amount": 131000,
"duration_minutes": 15,
"pay_address": "TDeposit...",
"payer_address": "TPayer...",
"target_address": "TTarget...",
"error_code": null,
"error_message": null
}curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
-H "Authorization: Bearer $API_KEY"سفارشی را که هنوز در انتظار_payment است (فقط در زنجیره) لغو می کند. پس از واگذاری انرژی، دیگر نمی توان سفارش را لغو کرد.
/api/v2/quick-rent/orders/:id/cancel| پارامتر | Type | توضیحات | Example |
|---|---|---|---|
شناسه | string | شناسه سفارش (پارامتر مسیر) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"موجودی TRX حساب TronBid مرتبط با کلید API شما (موجودی درون برنامه شما، نه کیف پول زنجیره ای) را برمی گرداند. به هدر Authorization نیاز دارد.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"خطاها وضعیت HTTP و فیلد خطا را برمیگردانند. در اینجا مواردی هستند که ممکن است با آنها روبرو شوید.
| HTTP | error | چه زمانی |
|---|---|---|
| 400 | Invalid body | JSON یا فیلدهای نامعتبر |
| 400 | INVALID_SKU / SKU_INACTIVE | بسته در دسترس نیست |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | آدرس TRON نادرست است |
| 400 | INSUFFICIENT_BALANCE | TRX کافی در تعادل (حالت تعادل) کافی نیست |
| 401 | Unauthorized | کلید API وجود ندارد یا نامعتبر است |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | پرداخت موجودی برای کلید شما فعال نیست |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | گیرنده منابع: pending_payment |
| 409 | ACTIVE_DELEGATION_EXISTS | Target در حال حاضر یک نمایندگی اجاره سریع فعال دارد |
| 409 | POOL_ENERGY_INSUFFICIENT | در حال حاضر انرژی رایگان استخر وجود ندارد |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | همان idempotency_key با حالت پرداخت متفاوت |
| 429 | Too Many Requests | محدودیت نرخ |
| 503 | — | سرویس موقتاً در دسترس نیست، بعداً دوباره امتحان کنید |
موقعیت های رایج و کارهایی که باید انجام داد، به زبان ساده.
پیش از انقضای سفارش، مبلغ دقیق را به آدرس پرداخت نمایشدادهشده در همین سفارش ارسال کنید. از آدرس پرداخت سفارش قبلی دوباره استفاده نکنید. میتوانید TRX را از هر کیف پولی پرداخت کنید. Energy یا Bandwidth به گیرنده مشخصشده در سفارش میرسد. نیازی به انتخاب کیف پول پرداخت نیست. GET /orders/:id → status
هیئت موفق نشد. برای پرداخت های موجودی، TRX به طور خودکار به موجودی شما بازگردانده می شود. دلیل آن در error_code و error_message GET /orders/:id است. شما می توانید یک سفارش جدید ایجاد کنید.
گیرنده منابع: pending_payment. GET /orders/:id; POST /orders/:id/cancel; expires_at.
پرداخت موجودی برای کلید شما فعال نیست. برای فعال کردن آن با پشتیبانی TronBid تماس بگیرید یا از روی زنجیره (پیشفرض) استفاده کنید.
درخواست های بیش از حد در یک زمان کوتاه. فرکانس نظرسنجی را کاهش دهید (مثلاً هر 3 ثانیه یک بار) و بعداً دوباره امتحان کنید.
با کمتر از پرداخت / اضافه پرداخت در زنجیره، مبلغ نهایی تغییر می کند. Effect_energy_amount را در GET /orders/:id بررسی کنید - این همان انرژی است که در واقع واگذار شده است.
آیا نیاز به دسترسی به API، محدودیتهای بالاتر یا پرداخت موجودی دارید؟ تماس بگیرید و ما کمک خواهیم کرد.