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

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

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

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

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

이 페이지에서

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

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

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

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

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

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

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

빠른 시작: 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 이체를 통해 주문을 결제하면 즉시 작동하며 활성화할 필요가 없습니다.
잔액 결제: Rent Energy Tron 계정 잔액을 충전하여 결제합니다. 더 빠르지만 먼저 키에 대해 활성화해야 합니다.
위임: 임대 기간(예: 15분 또는 60분) 동안 임대 에너지를 대상 지갑에 임시로 전달합니다.
폴링: 위임되거나 오류로 종료될 때까지 주문 상태를 주기적으로(2초마다) 다시 요청합니다.
멱등성_키: 귀하의 고유한 주문 ID입니다. 요청이 두 번 전송되면 API는 새 주문을 생성하는 대신 동일한 주문을 반환하므로 이중 결제가 방지됩니다.

시작하기 전에

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

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

프로덕션 API 기본 URL

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

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

기본 URL(프로덕션)

http

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

승인

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

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

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

http

Authorization: Bearer <API_KEY>

결제 모드

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

활성화하지 않은 경우 Payment_mode: Balance 요청은 403 BALANCE_PAYMENT_NOT_ENABLED를 반환합니다. 활성화하려면 Rent Energy Tron 지원팀에 문의하세요.

Mode	활성화 방법	결제
`on-chain`	기본값 — Payment_mode(또는 "onchain") 생략	payer_address에서 pay_address로 TRX를 보냅니다.
`balance`	Payment_mode: 잔액 + 키 활성화	Rent Energy Tron TRX 잔액에서 인출됩니다.

패키지 카탈로그

Energy_amount 및 Duration_Minutes는 활성 Quick Rent 패키지와 일치해야 합니다. 일반적으로 65,000 또는 131,000 에너지 및 15 또는 60분입니다.

언제든지 현재 카탈로그를 가져옵니다(인증 필요 없음).

활성 카탈로그 가져오기(인증 없음)

bash

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_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://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 규칙에 유의하세요. 지불인당 하나의 공개 온체인 주문이 있고 대상에 이미 활성 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..."}'

Rent Energy Tron API 잔액 확인

API 키에 연결된 Rent Energy Tron 계정의 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

키에 대한 잔액 결제가 활성화되어 있지 않습니다. 활성화하려면 Rent Energy Tron 지원팀에 문의하거나 온체인(기본값)을 사용하세요.

오류 429 요청이 너무 많습니다

짧은 시간에 요청이 너무 많습니다. 폴링 빈도를 낮추고(예: 3초마다 한 번) 나중에 다시 시도하십시오.

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

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

TRON Energy API 통합 지원

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

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