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

TRON Energy Rental API: 概要と使用例

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

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

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

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

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

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

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

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

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

用語集

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

始める前に

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

実稼働 API のベース URL

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

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

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

認可

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

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

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

Authorization: Bearer <API_KEY>

支払いモード

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

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

パッケージカタログ

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

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

curl -sS https://rentenergytron.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 を確認してください。

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

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

{
  "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 をポーリングして追跡します。

べき等性

idempotency_key (8 ～ 128 文字) は、お客様側の一意の注文 ID です。同じキー (同じ API クライアントの場合) で POST /orders を繰り返すと、「duplicate」: true の同じ注文が返されます。

異なる支払いモード (オンチェーンとバランス) で 1 つの idempotency_key を再利用しないでください。その場合、409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH が返されます。

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

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

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

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

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

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

export BASE_URL="https://rentenergytron.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 委任がまだ存在しないこと。

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

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

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

注文をキャンセルする

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

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

支払者の変更

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

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

Rent Energy Tron API バランスを確認する

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

{ "balance_trx": "150.500000" }

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

エラーコード

エラーは HTTP ステータスとエラー フィールドを返します。あなたが遭遇する可能性のあるものは次のとおりです。

何か問題が発生した場合

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

TRON Energy API統合サポート

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