API v2를 통합하여 TRON Energy 임대 주문을 프로그래밍 방식으로 견적, 생성 및 추적하세요. 온체인 또는 TronBid 잔고에서 결제하고 스마트 계약 호출로 소모되는 TRX를 줄이세요.
Quick Rent API는 수동 작업 없이 TRON Energy를 자동으로 임대하는 방법입니다. 에너지는 TRX를 소각하는 것보다 USDT(TRC-20) 이체 및 기타 스마트 계약 통화를 더 저렴하게 만듭니다.
간단히 말해서, 귀하의 프로그램(사이트, 봇 또는 서비스)은 정확히 필요할 때 에너지 자체를 구매합니다. 예를 들어 고객이 각 USDT를 전송하기 전입니다.
자동판매기를 생각해 보세요. 가격을 확인하고, 돈을 넣고, 물건을 가져옵니다. API는 동일한 버튼 세트입니다. 귀하의 프로그램에서만 해당 버튼을 누릅니다.
귀하의 프로그램은 API에 현재 필요한 에너지 패키지 비용이 얼마인지 묻습니다.
귀하의 프로그램은 TRX를 지정된 주소로 보내거나 TronBid 잔액을 충전하여 주문을 생성하고 지불합니다.
몇 초 내에 대상 지갑에 에너지가 나타나고 USDT를 더 저렴하게 보낼 수 있습니다.
중요: API는 개발자를 위한 도구입니다. 이를 사용하려면 누군가 요청을 보내는 코드를 작성해야 합니다.
코드를 작성할 사람이 없으면 사이트(Quick Rent)에서 미리 만들어진 에너지 구매를 사용하거나 Telegram 봇 @tronbid를 사용하세요. 동일한 결과가 수동으로 수행되었습니다.
가장 간단한 시나리오(온체인)에 대한 전체 엔드투엔드 예시입니다. 네 단계와 에너지가 지갑에 있습니다.
다음은 각 단계에서 발생하는 상황과 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
}이 문서에 사용된 단어에 대한 간단한 설명입니다.
첫 번째 요청을 하기 전에 준비해야 할 사항.
텔레그램에서 @tronbid 메시지를 보내세요. TronBid 계정에 연결된 키를 받게 됩니다. 요청이 없으면 요청이 통과되지 않습니다.
에너지가 필요한 주소(target_address)를 결정합니다. 일반적으로 고객이 USDT를 보내는 지갑입니다.
에너지는 패키지로 판매됩니다(보통 15분 또는 60분에 65,000 또는 131,000 에너지). 인증이 필요 없이 카탈로그 엔드포인트에서 실시간 목록을 가져옵니다.
온체인의 경우 — TRX를 사용하여 결제할 수 있는 지갑입니다. 잔액 결제의 경우 — 자금이 조달된 TronBid 계정 및 잔액 모드가 활성화되었습니다.
Quick Rent API를 사용하면 서비스에서 TRON 에너지를 자동으로 임대할 수 있으므로 USDT TRC-20 전송 및 기타 스마트 계약 통화 비용이 TRX를 소각하는 것보다 저렴합니다.
모든 엔드포인트는 하나의 기본 URL을 공유합니다.
https://tronbid.com/api/v2/quick-rent주문 결제 방법에는 두 가지가 있습니다. 온체인이 기본값이며 설정이 필요하지 않습니다. 잔액 결제는 선택 사항이며 키에 대해 활성화되어야 합니다.
활성화하지 않은 경우 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는 활성 Quick Rent 패키지와 일치해야 합니다. 일반적으로 65,000 또는 131,000 에너지 및 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단계 — GET /balance를 통해 TRX를 확인하세요. 2단계 - 가격에 대한 POST/견적. 3단계 - POST /결제 모드로 주문: 차변에 잔액을 입금하고 위임을 시작합니다. 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자)는 귀하 측의 고유한 주문 ID입니다. 동일한 키(동일한 API 클라이언트에 대해)를 사용하여 POST /orders를 반복하면 "duplicate": true와 동일한 주문이 반환됩니다.
다양한 결제 모드(온체인 대 잔액)에서 하나의 멱등성_키를 재사용하지 마세요. 이는 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, available, 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 | 선택사항. "온체인"(기본값) 또는 "밸런스". | 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..."
}'현재 상태, 결제 모드, 금액, 주소, 오류 코드/오류 메시지(실패한 경우)를 반환합니다. Effective_energy_amount는 미달/과다 지불 후 실제 위임된 에너지를 반영합니다.
/api/v2/quick-rent/orders/:id| 매개변수 | Type | 설명 | Example |
|---|---|---|---|
이드 | 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 |
|---|---|---|---|
이드 | 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 | 대상에는 이미 활성 Quick Rent 위임이 있습니다. |
| 409 | POOL_ENERGY_INSUFFICIENT | 지금은 무료 수영장 에너지가 없습니다. |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | 다른 Payment_mode의 동일한 멱등성_키 |
| 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초마다 한 번) 나중에 다시 시도하십시오.
온체인에서 과소지불/과지불하면 최종 금액이 변경됩니다. GET /orders/:id에서 Effective_energy_amount를 확인하세요. 이것이 실제로 위임된 에너지입니다.
API 액세스, 더 높은 한도 또는 잔액 결제가 필요합니까? 연락하시면 도와드리겠습니다.