REST API v2ドキュメントは 2026 年 8 月 2 日に更新されました

TRON Energy Rental API — USDT TRC-20 送金を自動化

API v2 を統合して、TRON Energy のレンタル注文をプログラムで見積もり、作成、追跡します。オンチェーンまたは TronBid 残高から支払い、スマートコントラクトコールによって消費される TRX を削減します。

ライブ見積もりとパッケージカタログ
オンチェーンまたは残高支払い
冪等な順序とステータスのポーリング

API アクセスを取得するクイックスタートを開く API なしでエネルギーをレンタルするエネルギー要件を計算する

このページでは

TRON Energy Rental API: 概要と使用例

Quick Rent API は、手作業なしで TRON Energy を自動的にレンタルする方法です。 Energy により、USDT (TRC-20) 転送やその他のスマートコントラクトコールが、TRX を燃やすよりも安くなります。

簡単に言うと、プログラム (サイト、ボット、サービス) は、必要なときに、たとえば顧客が USDT 送金を行う前など、エネルギーそのものを購入します。

自動販売機を思い浮かべてください。価格を確認し、お金を投入し、商品を受け取ります。 API は同じボタンのセットであり、プログラムのみがボタンを押します。

1
価格を尋ねる
プログラムは API に、現在必要なエネルギーパッケージのコストを尋ねます。
2
注文を作成して支払う
プログラムは注文を作成し、指定された住所に TRX を送信するか、TronBid 残高にチャージすることによって支払いを行います。
3
エネルギーを得る
数秒以内にターゲットのウォレットにエネルギーが表示され、USDT をより安価に送信できるようになります。

重要: API は開発者用のツールです。これを使用するには、誰かがリクエストを送信するコードを作成する必要があります。

コードを書く人がいない場合は、サイトで既製のエネルギー購入 (Quick Rent) または Telegram ボット @tronbid を使用してください。手動で実行しただけで同じ結果になります。

クイックスタート: ゼロからエネルギーへ

最も単純なシナリオ (オンチェーン) の完全なエンドツーエンドの例。 4つのステップでお財布にエネルギーがかかります。

以下は、各ステップで何が起こるか、そして API が何を返すかを示しています。 API キー、アドレス、注文 ID を入力します。

1
ステップ 1. 価格を取得する — POST /quote
エネルギー量と継続時間を送信します。 Price_trx とそれがロックされている秒数が返されます。
2
ステップ 2. 注文を作成する — POST /orders
パッケージ、idempotency_key、payer_address を送信します。 pay_address (支払う場所)、amount_trx (いくら)、expires_at (いつまで) が得られます。
3
ステップ 3. 支払い
payer_address から pay_address に正確に amount_trx TRX を送信します。単純な TRON 転送です。
4
ステップ 4. エネルギーを待つ — GET /orders/:id
委任されるまで、数秒ごとにステータスをポーリングします。つまり、エネルギーがウォレットに委任され、完了します。

応答

json

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

応答 (オンチェーン)

json

{
  "id": "uuid",
  "status": "pending_payment",
  "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..."
}

カールURL

bash

# 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

応答

json

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

用語集

このドキュメントで使用されている用語の簡単な説明。

エネルギー: スマートコントラクト運用のための TRON ネットワークの「燃料」。十分でない場合、ネットワークは代わりに TRX を書き込みますが、これはより高価です。エネルギーをレンタルするとコストが節約できます。
TRX: TRONネットワークのネイティブコイン。エネルギーレンタルとネットワーク料金を支払います。
USDT TRC-20: TRON のステーブルコイン (ドル)。これを送信するのは、エネルギーを必要とするスマートコントラクト呼び出しです。
APIキー: API アクセス用の秘密のパスワード。すべてのリクエストとともに送信されます。サーバー上にのみ保存してください。
エンドポイント: 特定のアドレス - プログラムがリクエストを送信する API の「ボタン」 (例: /quote — 価格の取得)。
取得/投稿: リクエストのタイプ。 GET は「データを問い合わせる/読み取るだけ」を意味します。 POST は「アクションを実行する」(注文の作成、価格の計算) を意味します。
無記名トークン: API キーを渡す方法: ヘッダーには「Authorization: Bearer YOUR_KEY」と表示されます。
オンチェーン決済: 指定されたアドレスへのプレーンな TRX 送金による注文の支払いは、有効にする必要がなく、すぐに機能します。
残金支払い: TronBid アカウントの残高にチャージして支払います。高速ですが、最初にキーを有効にする必要があります。
代表団: レンタル期間中（例：15分または60分）、レンタルしたエネルギーをターゲットウォレットに一時的に渡します。
ポーリング: 委任されるかエラーで終了するまで、注文ステータスを定期的に (数秒ごとに) 再質問します。
冪等性キー: あなたの一意の注文 ID。リクエストが 2 回送信された場合、API は新しい注文を作成するのではなく、同じ注文を返します。つまり、二重支払いを防止します。

始める前に

初めてリクエストする前に準備するもの。

1
APIキーを取得する
Telegram で @tronbid にメッセージを送信します — TronBid アカウントにバインドされたキーを取得します。これがなければリクエストは通過しません。
2
ターゲットのTRONウォレットを持っている
エネルギーを必要とするアドレス(target_address)を決定します。通常、これは顧客がUSDTを送信する元のウォレットです。
3
カタログからパッケージを選ぶ
エネルギーはパッケージで販売されます (通常、15 または 60 分間で 65000 または 131000 のエネルギー)。カタログエンドポイントからライブリストを取得します。認証は必要ありません。
4
支払いの準備
オンチェーンの場合 — TRX で支払うウォレット。残高支払いの場合 - TronBid アカウントに資金が投入されており、残高モードが有効になっています。

実稼働 API のベース URL

Quick Rent API を使用すると、サービスが TRON Energy を自動的にレンタルできるため、USDT TRC-20 転送やその他のスマートコントラクト呼び出しのコストが TRX を書き込むよりも安くなります。

すべてのエンドポイントは 1 つのベース URL を共有します。

ベース URL (本番環境)

http

https://tronbid.com/api/v2/quick-rent

認可

すべてのリクエストには、Authorization ヘッダーにベアラートークンとして API キーを含める必要があります。

キーはサーバー側のみに保持します (バックエンド、CI シークレット)。フロントエンドコードやパブリックリポジトリには決して配布しないでください。キーは単一の TronBid アカウント (アクセスが許可されたときに設定されたウォレット) にバインドされます。残高の支払いはそのアカウントからのみ引き落とされます。

レート制限を超えると、API は HTTP 429 で応答します。

http

Authorization: Bearer <API_KEY>

支払いモード

注文の支払い方法は 2 つあります。オンチェーンがデフォルトであり、セットアップは必要ありません。残高の支払いはオプションであり、キーに対して有効にする必要があります。

アクティベーションを行わない場合、payment_mode:balance を指定したリクエストは 403 BALANCE_PAYMENT_NOT_ENABLED を返します。有効にするには、TronBid サポートにお問い合わせください。

Mode	有効にする方法	お支払い
`on-chain`	デフォルト —payment_mode (または「onchain」) を省略します。	payer_address から pay_address に TRX を送信します
`balance`	payment_mode: 残高 + キーに対して有効になっています	TronBid TRX 残高から引き落とされます

パッケージカタログ

energy_amount とduration_ minutes は、アクティブなクイックレントパッケージと一致する必要があります。通常は 65000 または 131000 エネルギーと 15 または 60 分です。

現在のカタログをいつでも取得できます (認証は必要ありません)。

アクティブなカタログを取得します (認証なし)

bash

curl -sS https://tronbid.com/api/public/quick-rent/skus

オンチェーンフロー

ステップ 1 — POST /quote して価格を確認します。ステップ 2 — POST /orders で注文を作成し、pay_address、amount_trx、およびexpires_atを受け取ります。ステップ 3 — payer_address から pay_address に正確に amount_trx TRX を送信します。ステップ 4 — ステータスが委任される (または失敗、期限切れ、キャンセルされる) まで GET /orders/:id をポーリングします。

target_address はオプションです。省略した場合、エネルギーは payer_address に委任されます。

payer_address ごとに一度に許可されるオープンなオンチェーン注文 (pending_payment) は 1 つだけです。それ以外の場合は、409 PENDING_PAYMENT_INTENT_EXISTS が返されます。支払いが過小/過多の場合、最終的なエネルギーは異なる場合があります。GET /orders/:id でEffective_energy_amount を確認してください。

リクエストボディ

json

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-001",
  "payer_address": "TPayerWalletXXXXXXXXXXXXXXXXXXXXXX",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

応答

json

{
  "id": "uuid",
  "status": "pending_payment",
  "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（価格マトリックスボーナス）よりも高くなる可能性があります。

リクエストボディ

json

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-balance-001",
  "payment_mode": "balance",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

応答

json

{
  "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 が返されます。

TRON Energyのレンタル要件を計算する

アドレスの転送に必要なエネルギー量を見積もります。受信者のウォレットと、すでに USDT を保持しているかどうかを渡します。

POST/api/v2/quick-rent/calculator

パラメータ

パラメータ	Type	説明	Example
`ウォレットアドレス`	string	解析するTRONアドレス	`TXXXXXXXX...XXXX`
`has_usdt`	boolean \| null	受信者がすでに USDT を保有しているかどうか (エネルギーに影響します)。 true、false、または省略します。	`true`

リクエストボディ

json

{
  "wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "has_usdt": true
}

カールURL

bash

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}'

TRON Energyのレンタル見積もりを取得する

パッケージの現在の価格:price_trx、availability、save_percent、および見積もりの有効期間 (expires_in_sec) を返します。

POST/api/v2/quick-rent/quote

パラメータ

パラメータ	Type	説明	Example
`エネルギー量`	int	アクティブカタログからのエネルギー量	`131000`
`継続時間_分`	int	カタログからのレンタル期間	`15`

応答

json

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

カールURL

bash

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}'

TRON Energy のレンタル注文を作成する

レンタル注文を作成します。オンチェーンの場合、payer_address を渡し、返された amount_trx を pay_address に支払います。残高については、payment_mode: Balance を追加すると、リンクされたアカウントにすぐに請求されます。

target_address はオプションです (デフォルトは payer_address です)。 409 ルールに注意してください: 支払者ごとに 1 つのオープンなオンチェーン注文、およびターゲット (ACTIVE_DELEGATION_EXISTS) にアクティブな Quick Rent 委任がまだ存在しないこと。

POST/api/v2/quick-rent/orders

パラメータ

パラメータ	Type	説明	Example
`エネルギー量`	int	エネルギー量はカタログより	`131000`
`継続時間_分`	int	カタログからのレンタル期間	`15`
`冪等性キー`	string	一意の注文 ID (8 ～ 128 文字)	`partner-onchain-001`
`支払いモード`	string	オプション。「onchain」（デフォルト）または「balance」。	`balance`
`支払者の住所`	string	オンチェーン: TRX を送信するウォレット。バランスをとるためには必要ありません。	`TPayer...`
`ターゲットアドレス`	string	オプション。エネルギーを受け取るウォレット (デフォルトは payer_address)。	`TTarget...`

応答 (オンチェーン)

json

{
  "id": "uuid",
  "status": "pending_payment",
  "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..."
}

レスポンス（バランス）

json

{
  "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 (オンチェーン)

bash

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",
    "payer_address": "TPayer...",
    "target_address": "TTarget..."
  }'

cURL (バランス)

bash

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 を返します。効果的なエネルギー量は、過小/過払い後の実際の委任エネルギーを反映します。

GET/api/v2/quick-rent/orders/:id

パラメータ

パラメータ	Type	説明	Example
`ID`	string	注文ID (パスパラメータ)	`uuid`

応答

json

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

カールURL

bash

curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
  -H "Authorization: Bearer $API_KEY"

注文をキャンセルする

まだ支払いが保留中の注文をキャンセルします (オンチェーンのみ)。エネルギーが委任されると、注文をキャンセルすることはできなくなります。

POST/api/v2/quick-rent/orders/:id/cancel

パラメータ

パラメータ	Type	説明	Example
`ID`	string	注文ID (パスパラメータ)	`uuid`

カールURL

bash

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

支払者の変更

pending_payment オンチェーン注文の支払いウォレットを変更します。顧客が TRX を送信する前に別のウォレットから支払うことを決定した場合に便利です。

POST/api/v2/quick-rent/orders/:id/set-payer

パラメータ

パラメータ	Type	説明	Example
`ID`	string	注文ID (パスパラメータ)	`uuid`
`支払者の住所`	string	新しい支払いウォレット	`TNewPayer...`

カールURL

bash

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/set-payer" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payer_address":"TNewPayer..."}'

TronBid API バランスを確認する

API キーにリンクされた TronBid アカウントの TRX 残高を返します (オンチェーンウォレットではなく、アプリ内残高)。 Authorization ヘッダーが必要です。

GET/api/v2/quick-rent/balance

応答

json

{ "balance_trx": "150.500000" }

カールURL

bash

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`	この支払者にはオープンなオンチェーン注文がすでに存在します
409	`ACTIVE_DELEGATION_EXISTS`	Target にはすでにアクティブな Quick Rent 委任が存在します
409	`POOL_ENERGY_INSUFFICIENT`	現在、無料のプールエネルギーはありません
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	異なるpayment_modeを持つ同じべき等性_key
429	`Too Many Requests`	レート制限
503	`—`	サービスは一時的に利用できません。後で再試行してください

何か問題が発生した場合

よくある状況と何をすべきか、わかりやすい言葉で説明します。

支払いましたが、注文が pending_payment のままになっています

送金金額が amount_trx と正確に一致し、資金が正確な payer_address から pay_address に送金されたことを確認してください。転送は、expires_at 前に到着する必要があります。通常、ステータスはネットワーク確認後 1 分以内に更新されます。GET /orders/:id のポーリングを続けます。

ステータスが失敗になりました。これは何ですか?

委任は成功しませんでした。残高支払いの場合、TRX は自動的に残高に返されます。理由は、GET /orders/:id の error_code と error_message にあります。新しい注文を作成できます。

エラー 409 PENDING_PAYMENT_INTENT_EXISTS

この payer_address にはすでに未払いのオンチェーン注文があります。支払い、有効期限が切れる (expires_at) まで待つか、/orders/:id/cancel でキャンセルしてから、新しいものを作成します。

エラー 403 BALANCE_PAYMENT_NOT_ENABLED

キーの残高支払いが有効になっていません。 TronBid サポートに問い合わせて有効化するか、オンチェーン (デフォルト) を使用してください。

エラー 429 リクエストが多すぎます

短期間にリクエストが多すぎます。ポーリング頻度を下げて (例: 3 秒に 1 回)、後で再試行します。

注文したエネルギーよりもエネルギーが足りませんでした

オンチェーンで過小支払い/過払いがあると、最終的な金額が変わります。 GET /orders/:id でEffective_energy_amount を確認してください。これが実際に委任されたエネルギーです。

TRON Energy API統合サポート

API アクセス、上限の引き上げ、または残高支払いを有効にする必要がありますか?ご連絡ください。お手伝いいたします。

APIアクセスと残高支払い電報@tronbid

電子メールsupport@tronbid.com