REST API v22026년 8월 2일에 업데이트된 문서

TRON 에너지 임대 API — USDT TRC-20 전송 자동화

API v2를 통합하여 TRON Energy 임대 주문을 프로그래밍 방식으로 견적, 생성 및 추적하세요. 온체인 또는 TronBid 잔고에서 결제하고 스마트 계약 호출로 소모되는 TRX를 줄이세요.

실시간 견적 및 패키지 카탈로그
온체인 또는 잔액 결제
멱등성 주문 및 상태 폴링

API 액세스 받기 빠른 시작 열기 API 없이 에너지 임대 에너지 요구량 계산

이 페이지에서

TRON Energy Rental API: 개요 및 사용 사례

Quick Rent API는 수동 작업 없이 TRON Energy를 자동으로 임대하는 방법입니다. 에너지는 TRX를 소각하는 것보다 USDT(TRC-20) 이체 및 기타 스마트 계약 통화를 더 저렴하게 만듭니다.

간단히 말해서, 귀하의 프로그램(사이트, 봇 또는 서비스)은 정확히 필요할 때 에너지 자체를 구매합니다. 예를 들어 고객이 각 USDT를 전송하기 전입니다.

자동판매기를 생각해 보세요. 가격을 확인하고, 돈을 넣고, 물건을 가져옵니다. API는 동일한 버튼 세트입니다. 귀하의 프로그램에서만 해당 버튼을 누릅니다.

1
가격을 물어보세요
귀하의 프로그램은 API에 현재 필요한 에너지 패키지 비용이 얼마인지 묻습니다.
2
주문 생성 및 결제
귀하의 프로그램은 TRX를 지정된 주소로 보내거나 TronBid 잔액을 충전하여 주문을 생성하고 지불합니다.
3
에너지를 얻으세요
몇 초 내에 대상 지갑에 에너지가 나타나고 USDT를 더 저렴하게 보낼 수 있습니다.

중요: API는 개발자를 위한 도구입니다. 이를 사용하려면 누군가 요청을 보내는 코드를 작성해야 합니다.

코드를 작성할 사람이 없으면 사이트(Quick Rent)에서 미리 만들어진 에너지 구매를 사용하거나 Telegram 봇 @tronbid를 사용하세요. 동일한 결과가 수동으로 수행되었습니다.

빠른 시작: 0에서 에너지까지

가장 간단한 시나리오(온체인)에 대한 전체 엔드투엔드 예시입니다. 네 단계와 에너지가 지갑에 있습니다.

다음은 각 단계에서 발생하는 상황과 API가 반환하는 내용입니다. API 키, 주소, 주문 ID를 연결하세요.

1
1단계. 가격 확인 — POST /견적
에너지량과 지속시간을 전송합니다. Price_trx를 돌려받고 몇 초 동안 잠겨 있는지 확인할 수 있습니다.
2
2단계. 주문 생성 — POST /orders
패키지, idempotency_key 및 payer_address를 보냅니다. pay_address(지불할 곳), amount_trx(얼마나) 및 만료_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..."
}

cURL

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 액세스를 위한 비밀 비밀번호입니다. 모든 요청과 함께 전송됩니다. 서버에만 보관하세요.
엔드포인트: 프로그램이 요청(예: /quote - 가격 확인)을 보내는 API의 특정 주소 "버튼"입니다.
받기 / 게시: 요청 유형. GET은 "데이터 요청/읽기"를 의미합니다. POST는 "작업 수행"(주문 생성, 가격 계산)을 의미합니다.
무기명 토큰: API 키 전달 방법: 헤더에 Authorization: Bearer YOUR_KEY가 표시됩니다.
온체인 결제: 지정된 주소로 일반 TRX 이체를 통해 주문을 결제하면 즉시 작동하며 활성화할 필요가 없습니다.
잔액 결제: TronBid 계정 잔액을 충전하여 결제합니다. 더 빠르지만 먼저 키에 대해 활성화해야 합니다.
위임: 임대 기간(예: 15분 또는 60분) 동안 임대 에너지를 대상 지갑에 임시로 전달합니다.
폴링: 위임되거나 오류로 종료될 때까지 주문 상태를 주기적으로(2초마다) 다시 요청합니다.
멱등성_키: 귀하의 고유한 주문 ID입니다. 요청이 두 번 전송되면 API는 새 주문을 생성하는 대신 동일한 주문을 반환하므로 이중 결제가 방지됩니다.

시작하기 전에

첫 번째 요청을 하기 전에 준비해야 할 사항.

1
API 키 받기
텔레그램에서 @tronbid 메시지를 보내세요. TronBid 계정에 연결된 키를 받게 됩니다. 요청이 없으면 요청이 통과되지 않습니다.
2
대상 TRON 지갑 보유
에너지가 필요한 주소(target_address)를 결정합니다. 일반적으로 고객이 USDT를 보내는 지갑입니다.
3
카탈로그에서 패키지 선택
에너지는 패키지로 판매됩니다(보통 15분 또는 60분에 65,000 또는 131,000 에너지). 인증이 필요 없이 카탈로그 엔드포인트에서 실시간 목록을 가져옵니다.
4
결제 준비
온체인의 경우 — TRX를 사용하여 결제할 수 있는 지갑입니다. 잔액 결제의 경우 — 자금이 조달된 TronBid 계정 및 잔액 모드가 활성화되었습니다.

프로덕션 API 기본 URL

Quick Rent API를 사용하면 서비스에서 TRON 에너지를 자동으로 임대할 수 있으므로 USDT TRC-20 전송 및 기타 스마트 계약 통화 비용이 TRX를 소각하는 것보다 저렴합니다.

모든 엔드포인트는 하나의 기본 URL을 공유합니다.

기본 URL(프로덕션)

http

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

승인

모든 요청에는 Authorization 헤더에 API 키가 Bearer 토큰으로 포함되어야 합니다.

키는 서버 측에서만 유지하십시오(백엔드, CI 비밀). 프런트엔드 코드나 공개 저장소로 전송하지 마세요. 키는 단일 TronBid 계정(액세스가 허용되었을 때 설정된 지갑)에 바인딩되어 있습니다. 잔액 결제는 해당 계좌에서만 인출할 수 있습니다.

비율 제한을 초과하면 API는 HTTP 429로 응답합니다.

http

Authorization: Bearer <API_KEY>

결제 모드

주문 결제 방법에는 두 가지가 있습니다. 온체인이 기본값이며 설정이 필요하지 않습니다. 잔액 결제는 선택 사항이며 키에 대해 활성화되어야 합니다.

활성화하지 않은 경우 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는 활성 Quick Rent 패키지와 일치해야 합니다. 일반적으로 65,000 또는 131,000 에너지 및 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_pay)만 허용됩니다. 그렇지 않으면 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단계 - 가격에 대한 POST/견적. 3단계 - POST /결제 모드로 주문: 차변에 잔액을 입금하고 위임을 시작합니다. 4단계 - 위임될 때까지 GET /orders/:id를 폴링합니다(위임 오류가 발생하면 실패하고 TRX가 잔액으로 환불됩니다).

payer_address는 필요하지 않습니다. API 키에 연결된 계정이 지불합니다. 응답의 에너지 양은 주문한 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와 동일한 주문이 반환됩니다.

다양한 결제 모드(온체인 대 잔액)에서 하나의 멱등성_키를 재사용하지 마세요. 이는 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`

요청 본문

json

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

cURL

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, available, 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
}

cURL

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 규칙에 유의하세요. 지불인당 하나의 공개 온체인 주문이 있고 대상에 이미 활성 Quick Rent 위임이 없습니다(ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

매개변수

매개변수	Type	설명	Example
`에너지_량`	int	카탈로그의 에너지량	`131000`
`지속 시간_분`	int	카탈로그의 대여 기간	`15`
`멱등성_키`	string	고유한 주문 ID(8~128자)	`partner-onchain-001`
`결제_모드`	string	선택사항. "온체인"(기본값) 또는 "밸런스".	`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..."
  }'

주문 상태 확인

현재 상태, 결제 모드, 금액, 주소, 오류 코드/오류 메시지(실패한 경우)를 반환합니다. Effective_energy_amount는 미달/과다 지불 후 실제 위임된 에너지를 반영합니다.

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

매개변수

매개변수	Type	설명	Example
`이드`	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
}

cURL

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
`이드`	string	주문 ID(경로 매개변수)	`uuid`

cURL

bash

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

지급인 변경

Pending_pay 온체인 주문에 대한 지불 지갑을 변경합니다. 고객이 TRX를 보내기 전에 다른 지갑에서 지불하기로 결정한 경우 유용합니다.

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

매개변수

매개변수	Type	설명	Example
`이드`	string	주문 ID(경로 매개변수)	`uuid`
`지불인_주소`	string	새로운 유료 지갑	`TNewPayer...`

cURL

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

cURL

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`	대상에는 이미 활성 Quick Rent 위임이 있습니다.
409	`POOL_ENERGY_INSUFFICIENT`	지금은 무료 수영장 에너지가 없습니다.
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	다른 Payment_mode의 동일한 멱등성_키
429	`Too Many Requests`	비율 제한
503	`—`	일시적으로 서비스를 사용할 수 없습니다. 나중에 다시 시도하세요.

뭔가 잘못되면

일반적인 상황과 해야 할 일을 쉽게 설명합니다.

결제했는데 주문이 결제 보류 상태에서 멈췄습니다.

이체 금액이 amount_trx와 정확히 일치하고 자금이 정확한 payer_address에서 pay_address로 이동했는지 확인하세요. 전송은 만료 날짜 이전에 도착해야 합니다. 상태는 일반적으로 네트워크 확인 후 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초마다 한 번) 나중에 다시 시도하십시오.

주문한 것보다 에너지가 적게 나왔어요

온체인에서 과소지불/과지불하면 최종 금액이 변경됩니다. GET /orders/:id에서 Effective_energy_amount를 확인하세요. 이것이 실제로 위임된 에너지입니다.

TRON 에너지 API 통합 지원

API 액세스, 더 높은 한도 또는 잔액 결제가 필요합니까? 연락하시면 도와드리겠습니다.

API 액세스 및 잔액 결제텔레그램 @tronbid

이메일support@tronbid.com