API v2でTRONエネルギーレンタルの見積もり、注文作成、ステータス確認を自動化。オンチェーンまたはTronBid残高で支払い、スマートコントラクトの呼び出しで消費するTRXを削減できます。
Quick Rent API は、手作業なしで TRON Energy を自動的にレンタルする方法です。 Energy により、USDT (TRC-20) 転送やその他のスマート コントラクト コールが、TRX を燃やすよりも安くなります。
簡単に言うと、プログラム (サイト、ボット、サービス) は、必要なときに、たとえば顧客が USDT 送金を行う前など、エネルギーそのものを購入します。
自動販売機を思い浮かべてください。価格を確認し、お金を投入し、商品を受け取ります。 API は同じボタンのセットであり、プログラムのみがボタンを押します。
プログラムは API に、現在必要なエネルギー パッケージのコストを尋ねます。
プログラムは注文を作成し、指定された住所に TRX を送信するか、TronBid 残高にチャージすることによって支払いを行います。
数秒以内にターゲットのウォレットにエネルギーが表示され、USDT をより安価に送信できるようになります。
重要: API は開発者用のツールです。これを使用するには、誰かがリクエストを送信するコードを作成する必要があります。
コードを書く人がいない場合は、サイトで既製のエネルギー購入 (Quick Rent) または Telegram ボット @tronbid を使用してください。手動で実行しただけで同じ結果になります。
最も単純なシナリオ (オンチェーン) の完全なエンドツーエンドの例。 4つのステップでお財布にエネルギーがかかります。
以下は、各ステップで何が起こるか、そして API が何を返すかを示しています。 API キー、アドレス、注文 ID を入力します。
エネルギー量と継続時間を送信します。 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
}このドキュメントで使用されている用語の簡単な説明。
初めてリクエストする前に準備するもの。
Telegram で @tronbid にメッセージを送信します — TronBid アカウントにバインドされたキーを取得します。これがなければリクエストは通過しません。
エネルギーを必要とするアドレス(target_address)を決定します。通常、これは顧客がUSDTを送信する元のウォレットです。
エネルギーはパッケージで販売されます (通常、15 または 60 分間で 65000 または 131000 のエネルギー)。カタログ エンドポイントからライブ リストを取得します。認証は必要ありません。
オンチェーンの場合 — TRX で支払うウォレット。残高支払いの場合 - TronBid アカウントに資金が投入されており、残高モードが有効になっています。
Quick Rent API を使用すると、サービスが TRON Energy を自動的にレンタルできるため、USDT TRC-20 転送やその他のスマート コントラクト呼び出しのコストが TRX を書き込むよりも安くなります。
すべてのエンドポイントは 1 つのベース URL を共有します。
https://tronbid.com/api/v2/quick-rent注文の支払い方法は 2 つあります。オンチェーンがデフォルトであり、セットアップは必要ありません。残高の支払いはオプションであり、キーに対して有効にする必要があります。
アクティベーションを行わない場合、payment_mode:balance を指定したリクエストは 403 BALANCE_PAYMENT_NOT_ENABLED を返します。有効にするには、TronBid サポートにお問い合わせください。
| Mode | 有効にする方法 | お支払い |
|---|---|---|
on-chain | デフォルト —payment_mode (または「onchain」) を省略します。 | TRXはどのウォレットからでも支払えます。EnergyまたはBandwidthは注文で指定した受取先に委任されます。支払いウォレットの選択は不要です。 amount_trx TRX → pay_address |
balance | payment_mode: 残高 + キーに対して有効になっています | TronBid TRX 残高から引き落とされます |
energy_amount とduration_ minutes は、アクティブなクイック レント パッケージと一致する必要があります。通常は 65000 または 131000 エネルギーと 15 または 60 分です。
現在のカタログをいつでも取得できます (認証は必要ありません)。
curl -sS https://tronbid.com/api/public/quick-rent/skusTRXはどのウォレットからでも支払えます。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 — GET /balance を使用して TRX を確認します。ステップ 2 — 価格を投稿/見積もりします。ステップ 3 —payment_mode を使用して POST /orders: 残高を借方に記入し、委任を開始します。ステップ 4 — 委任されるまで GET /orders/:id をポーリングします (委任エラーが発生すると失敗し、TRX が残高に返金されます)。
payer_address は必要ありません。API キーにリンクされたアカウントが支払いを行います。応答内のenergy_amountは、注文された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 文字) は、お客様側の一意の注文 ID です。同じキー (同じ API クライアントの場合) で POST /orders を繰り返すと、「duplicate」: true の同じ注文が返されます。
異なる支払いモード (オンチェーンとバランス) で 1 つの idempotency_key を再利用しないでください。その場合、409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH が返されます。
アドレスの転送に必要なエネルギー量を見積もります。受信者のウォレットと、すでに USDT を保持しているかどうかを渡します。
/api/v2/quick-rent/calculator| パラメータ | Type | 説明 | Example |
|---|---|---|---|
ウォレットアドレス | string | 解析するTRONアドレス | TXXXXXXXX...XXXX |
has_usdt | boolean | null | 受信者がすでに USDT を保有しているかどうか (エネルギーに影響します)。 true、false、または省略します。 | 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、availability、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 | 一意の注文 ID (8 ~ 128 文字) | partner-onchain-001 |
payment_mode | string | オプション。 「onchain」(デフォルト)または「balance」。 | 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..."
}'現在のステータス、payment_mode、金額、アドレス、および何かが失敗した場合の error_code / error_message を返します。効果的なエネルギー量は、過小/過払い後の実際の委任エネルギーを反映します。
/api/v2/quick-rent/orders/:id| パラメータ | Type | 説明 | Example |
|---|---|---|---|
ID | string | 注文ID (パスパラメータ) | 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"まだ支払いが保留中の注文をキャンセルします (オンチェーンのみ)。エネルギーが委任されると、注文をキャンセルすることはできなくなります。
/api/v2/quick-rent/orders/:id/cancel| パラメータ | Type | 説明 | Example |
|---|---|---|---|
ID | string | 注文ID (パスパラメータ) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"API キーにリンクされた TronBid アカウントの TRX 残高を返します (オンチェーン ウォレットではなく、アプリ内残高)。 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 にはすでにアクティブな Quick Rent 委任が存在します |
| 409 | POOL_ENERGY_INSUFFICIENT | 現在、無料のプール エネルギーはありません |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | 異なるpayment_modeを持つ同じべき等性_key |
| 429 | Too Many Requests | レート制限 |
| 503 | — | サービスは一時的に利用できません。後で再試行してください |
よくある状況と何をすべきか、わかりやすい言葉で説明します。
注文の有効期限内に、この注文に表示された支払いアドレスへ正確な金額を送金してください。過去の注文の支払いアドレスは再利用しないでください。 TRXはどのウォレットからでも支払えます。EnergyまたはBandwidthは注文で指定した受取先に委任されます。支払いウォレットの選択は不要です。 GET /orders/:id → status
委任は成功しませんでした。残高支払いの場合、TRX は自動的に残高に返されます。理由は、GET /orders/:id の error_code と error_message にあります。新しい注文を作成できます。
リソースの受取先: pending_payment. GET /orders/:id; POST /orders/:id/cancel; expires_at.
キーの残高支払いが有効になっていません。 TronBid サポートに問い合わせて有効化するか、オンチェーン (デフォルト) を使用してください。
短期間にリクエストが多すぎます。ポーリング頻度を下げて (例: 3 秒に 1 回)、後で再試行します。
オンチェーンで過小支払い/過払いがあると、最終的な金額が変わります。 GET /orders/:id でEffective_energy_amount を確認してください。これが実際に委任されたエネルギーです。
API アクセス、上限の引き上げ、または残高支払いを有効にする必要がありますか?ご連絡ください。お手伝いいたします。