EnergyFather 서비스는 USDT 및 기타 TRC20 암호화 토큰으로 거래를 전송하는 데 필요한 에너지와 대역폭을 구매(대여)하는 데 도움을 줍니다. 대역폭은 TRON 블록체인의 모든 유형의 거래를 전송하는 데도 필요하며, TRX 전송, 보상 청구, Super Representatives 투표 등 다양한 유형의 거래를 전송할 수 있습니다.
에너지 구매 절차
에너지를 구매하려면 EnergyFather 서비스에 등록하고 "구매자 > API 토큰" 페이지에서 승인 토큰을 받은 후 구매자 계정 잔액을 충전해야 합니다.
주문 생성 후(메서드 ‘buy/energy’) 에너지가 몇 초 또는 몇 분의 지연으로 전달될 수 있으므로 자동화 시스템을 개발할 때는 메서드 ‘order/get/{guid}’를 요청하여 주문 실행을 주기적으로 확인하는 것이 좋습니다.
예를 들어 USDT를 보낼 계획이고 에너지를 구매하여 더 저렴하게 거래하려는 경우 다음을 수행합니다:
- 를 요청하여 필요한 에너지 양을 예측하고 구매합니다,
- 에너지가 위임될 때까지(보통 몇 초가 걸립니다) 주기적으로 ‘order/get/{guid}’ 메서드를 요청합니다,
- USDT를 전송합니다(구매한 에너지는 거래 수수료 지불에 사용됩니다).
일반 참고 사항
이 문서에서 중괄호로 묶인 표현식(예: ‘{guid}’ 또는 ‘{id}’)은 해당 변수의 값을 의미합니다:
- ‘{guid}’은 개체의 글로벌 고유 식별자(일반적으로 8자리)입니다,
- ‘{id}’는 이 사용자에 대한 개체의 일련 번호입니다(각 사용자에 대한 번호는 ‘1’로 시작).
API 엔드포인트
https://panel.energyfather.com/api/v1/private
POST 방법을 사용하여 요청을 보내세요.
요청 승인
비공개 API에 대한 요청을 확인(승인)하려면 HTTP 헤더를 전달해야 합니다:
Token: {token}
권한 부여 토큰 관리는 제어판의 "구매자 > API 토큰" 페이지에서 확인할 수 있습니다.
예를 들어 다음과 같은 방법으로 주문 123456에 대한 정보를 얻을 수 있습니다:
CURL -X POST 'https://panel.energyfather.com/api/v1/private/order/get/123456' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
주문 상태
- "0" - 보류 중. 주문이 방금 생성되었습니다.
- "1" - 결제 대기 중입니다. 결제 링크가 이미 생성되었으며, EnergyFather가 결제 시스템에서 콜백을 기다리는 중입니다. 이 상태는 주문이 내부 계정에서 사용 가능한 자금으로 전액 결제되는 경우에는 사용되지 않습니다.
- "2" - 에너지 위임 절차가 진행 중입니다.
- "3" - 위임. 에너지가 지급됩니다.
- "4" - 회수됨(위임되지 않음). 유료 기간 종료로 인해 에너지가 회수됩니다.
- "5" - 유료. 주문이 결제되고 에너지 배송 대기열에 추가됩니다.
- "6" - 오류입니다.
일반적인 상태 순서입니다: 0, 5, 2, 3, 4.
- /api/v1/private/buy/energy - 에너지 구매(내부 계정에서 결제)
- /api/v1/private/order/list - 주문 목록 가져오기
- /api/v1/private/order/get/{guid} - 주문에 대한 정보 얻기
- /api/v1/private/account/list - 내부 계정 목록 가져오기
- /api/v1/private/account/get/{id} - 내부 계정에 대한 정보 얻기
"buy/energy" 방법 - 에너지 구매(내부 계정에서 결제)
등록된 고객이 내부 계정에서 인출하여 에너지 구매를 요청합니다. 에너지가 지정된 주소로 즉시 전송됩니다.
내부 계정에 자금이 부족한 경우 주문이 생성되고 즉시 "6"(오류) 상태가 됩니다. 이 경우 패널을 방문하여 일부 자금을 입금한 다음 에너지 구매를 위한 새로운 API 요청을 보내야 합니다.
구매할 에너지의 양을 정의하는 방법에는 두 가지가 있습니다:
a) "amount" 파라미터에서 정확한 에너지 양을 설정할 수 있으며, amount_source="amount"도 설정해야 합니다.
b) 트랜잭션에 얼마나 많은 에너지가 필요한지 모르는 경우 USDT 또는 다른 토큰을 전송하기 위해 amount_source="estimate"를 설정하고 적절한 매개변수 (estimate_to, estimate_token, estimate_adjust_percent)을 입력할 수 있습니다.
buy/energy: 정확한 에너지 양이 포함된 요청 예시
curl -X 'POST'
'https://panel.energyfather.com/api/v1/private/buy/energy'
-H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
-d '{
"format": "json",
"to": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
"amount_source": "amount",
"amount": "31895",
"period_type": "days",
"period_amount": "3"
}'
buy/energy: 필요한 에너지 양을 계산한 요청 예시
curl -X 'POST'
'https://panel.energyfather.com/api/v1/private/buy/energy'
-H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
-d '{
"format": "json",
"to": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
"amount_source": "estimate",
"estimate_to": "TLVkYEp4Ue2RpK5v1XNZAB3769g44BSZyH,TJm6HiCMVZdBHbNHThdMv1RambstJPrfYo",
"estimate_token": "USDT",
"estimate_adjust_percent": 0.04,
"period_type": "days",
"period_amount": "3"
}'
buy/energy: 매개변수 요청
- to(문자열, 필수) - 에너지를 위임할 TRON 주소입니다.
- period_amount(정수, 필수) - 에너지 구매 기간
- period_type(문자열, 필수) - 기간 유형입니다. 가능한 값입니다: days, hours.
- format(문자열, 선택 사항) - 응답 형식입니다. 가능한 값은 다음과 같습니다: json (default), xml.
- amount_source(문자열, 필수) - 위임된 에너지의 양을 결정하는 알고리즘입니다. 값이 "amount"이면 매개변수 "amount"의 값이 사용됩니다. 값이 "estimate"인 경우 필요한 에너지 양은 매개변수 estimate_to, estimate_token, estimate_adjust_percent에 따라 계산됩니다. 가능한 값 amount, estimate.
- amount(정수, amount_source="amount"인 경우 필수) - 구매할 에너지의 양입니다. amount_source="estimate"인 경우 무시됩니다.
- estimate_to(문자열, amount_source="estimate"의 경우 필수) - 토큰 트랜잭션을 전송할 계획인 쉼표로 구분된 TRON 주소 목록입니다.
- estimate_token(문자열, amount_source="estimate"인 경우 필수) - TRC20 토큰입니다. 가능한 값(대소문자 구분): USDT, USDC, USDD, USDJ, JST, TUSD, stUSDT, WTRX.
- estimate_adjust_percent(십진수, amount_source="estimate"인 경우 필수) - 백분율로 표시된 초과 에너지 양입니다. 이 초과분은 주소에 정확히 필요한 양의 에너지가 있는 경우 발생할 수 있는 TRX 소각을 방지하기 위해 필요합니다. 권장 값은 0.04%.입니다.
중요: 현재 6개 기간만 유효합니다: 1 hour 및 1, 3, 7, 15, 30 days.
buy/energy: 응답
성공할 경우 응답에 GUID 주문이 포함되며, 이를 통해 나중에 실제 세부 정보를 얻을 수 있습니다.
{
"status": "ok",
"data": {
"guid": 81373165,
"estimate_task_id": null,
"status": 0,
"order_cost": "6.051",
"to": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
"energy_amount": 61000,
"period_type": "hours",
"energy_delegation_fee": "0.561000000000000000",
"address_activation_fee": "0.000000000000000000",
"hours": 1,
"days": 0,
"estimate_task": null
},
"balance": "7.29412"
}
요청에 amount_source="estimate"가 포함되어 있으면 응답에 "estimate_task" 섹션이 추가됩니다. 예를 들어
{
"status": "ok",
"data": {
"guid": 77082757,
"estimate_task_id": 42708906,
"status": 0,
"order_cost": "0.561",
"to": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
"energy_amount": null,
"period_type": "hours",
"energy_delegation_fee": "0.561000000000000000",
"address_activation_fee": "0.000000000000000000",
"hours": 1,
"days": 0,
"estimate_task": {
"id": 42708906,
"token": "USDT",
"currency": "USD",
"from": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
"to": [
"TLVkYEp4Ue2RpK5v1XNZAB3769g44BSZyH",
"TJm6HiCMVZdBHbNHThdMv1RambstJPrfYo"
]
}
},
"balance": "18.29412"
}
buy/energy: 응답 매개변수
- guid - 주문 GUID
- balance - 현재 내부 계정에서 사용 가능한 자금, TRX
- days - 에너지 공급 기간(일), "period_type=days"의 경우
- hours - 에너지 공급 기간(시간 단위), "period_type=hours"의 경우
- estimate_task - 한 TRON 주소에서 다른 TRON 주소 목록으로 TRC20 거래를 보내는 데 필요한 에너지의 계산(추정)입니다.
"order/get/{guid}" 방법 - 주문 세부 정보 가져오기
특정 주문에 대한 정보 얻기.
order/get/{guid} - 요청 예시
curl -X 'POST' 'https://panel.energyfather.com/api/v1/private/order/get/12345' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
order/get/{guid} - 응답 예시
{
"status": "ok",
"data": {
"guid": 81373165,
"estimate_task_id": 32301594,
"status": 3,
"payment_status": 0,
"order_cost_paid": "4.146350000000000000",
"order_cost": "4.146350000000000000",
"to": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
"energy_amount": 31895,
"period_type": "hours",
"energy_delegation_fee": "0.000000000000000000",
"address_activation_fee": "0.000000000000000000",
"hours": 1,
"days": 0,
"resource_txs": [
{
"order_guid": 81373165,
"delegate_txid": "961b6fbd7cc2090d1a65abc06bfabde1046e02d35394f6eca8d05812a6e3ab7"
}
],
"estimate_task": {
"id": 42708906,
"token": "USDT",
"currency": "USD",
"from": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
"to": [
"TLVkYEp4Ue2RpK5v1XNZAB3769g44BSZyH",
"TJm6HiCMVZdBHbNHThdMv1RambstJPrfYo"
]
}
}
}
order/get/{guid} - 응답 매개변수
- guid - 주문 GUID
- balance - 현재 내부 계정에서 사용 가능한 자금, TRX
- days - 에너지 공급 기간(일), "period_type=days"의 경우
- hours - 에너지 공급 기간(시간 단위), "period_type=hours"의 경우
- to - 에너지가 전달되는 TRX 주소
- energy_amount - 에너지 수량
- order_cost - 주문 비용, TRX
- order_cost_paid - 이미 지불한 금액, TRX (내부 계정에 자금이 부족한 경우 이 금액은 "order_cost"보다 적습니다.)
- address_activation_fee - 대상 주소의 활성화 수수료 금액, TRX
- energy_delegation_fee - 너무 작은 주문 규모에 대한 수수료, TRX
- resource_txs - 리소스가 위임 및 회수(위임 해제)된 TRON 블록체인의 트랜잭션 목록이 포함된 배열입니다.
- status - 주문 상태, 가능한 값은 이 매뉴얼의 시작 부분에 설명되어 있습니다.
- payment_status - 결제 시스템의 주문 결제 상태(가능한 값은 결제 시스템에 따라 다름)
"order/list" 메서드 - 주문 목록 가져오기
주문 목록 가져오기.
order/list - 요청 예시
curl -X 'POST' 'https://panel.energyfather.com/api/v1/private/order/list' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
order/list - 매개변수 요청
- sort(문자열, 선택 사항) - 항목 정렬, 기본값은 "created_at|desc"입니다.
- per_page(정수, 선택 사항) - 응답당 항목 수를 제한합니다.
- page(정수, 선택 사항) - 응답 페이지의 일련 번호
- filter(arrays(objects) 배열, 선택 사항) - 항목 필터링
order/list - 응답 예시
{
"current_page": 1,
"data": [
{
"guid": 96134274,
"status": 4
},
{
"guid": 81373165,
"status": 3
}
],
"first_page_url": "/api/v1/private/order/list?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "/api/v1/private/order/list?page=1",
"links": [
{
"url": null,
"label": "pagination.previous",
"active": false
},
{
"url": "/api/v1/private/order/list?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "pagination.next",
"active": false
}
],
"next_page_url": null,
"path": "/api/v1/private/order/list",
"per_page": 15,
"prev_page_url": null,
"to": 2,
"total": 2,
"draw": null,
"status": "ok"
}
order/list - 응답 매개변수
- guid - 주문의 GUID
- status - API 대응 현황
"account/list" 방법 - 내부 계정 나열
현재 사용 가능한 자금 금액을 포함한 내부 계정 목록을 가져옵니다. 사이트의 각 섹션마다 별도의 내부 계정이 있으므로 계정에는 여러 개의 계정이 있습니다.
account/list - 요청 예시
curl -X 'POST' 'https://panel.energyfather.com/api/v1/private/account/list' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
account/list - 응답 예시
{
"current_page": 1,
"data": [
{
"guid": 29778748,
"user_id": 81841325,
"id": 1,
"section": "affiliate",
"currency": "TRX",
"balance": "2.511531"
},
{
"guid": 64463815,
"user_id": 81841325,
"id": 2,
"section": "buyer",
"currency": "TRX",
"balance": "41.704"
}
],
"first_page_url": "/api/v1/private/account/list?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "/api/v1/private/account/list?page=1",
"links": [
{
"url": null,
"label": "pagination.previous",
"active": false
},
{
"url": "/api/v1/private/account/list?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "pagination.next",
"active": false
}
],
"next_page_url": null,
"path": "/api/v1/private/account/list",
"per_page": 15,
"prev_page_url": null,
"to": 2,
"total": 2,
"draw": null,
"status": "ok"
}
account/list - 응답 매개변수
- guid - 내부 계정의 GUID
- id - 내부 계정의 순차적 ID
- section - 이 잔액이 속한 EnergyFather 섹션
- balance - 사용 가능한 자금
- currency - 통화
- user_id - 사용자의 GUID
"account/get/{id}" 방법 - 정확한 내부 계정 가져오기
특정 섹션의 내부 계정 잔액 가져오기 EnergyFather. 각 섹션에는 자체 계정 (buyer, affiliate, seller, dealer)가 있으므로 각 사용자에게는 여러 개의 계정이 있습니다. 먼저 "account/list" 방법을 사용하여 목록을 가져오고 관심 있는 계정의 ‘id’을 찾은 다음 이 ‘id’을 사용하여 특정 계정의 잔액을 가져올 수 있습니다.
account/get/{id} - 요청 예시
curl -X 'POST' 'https://panel.energyfather.com/api/v1/private/account/get/1' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
account/get/{id} - 응답 예시
{
"status": "ok",
"data": {
"guid": 64463815,
"user_id": 81841325,
"id": 2,
"section": "buyer",
"currency": "TRX",
"balance": "41.704"
}
}
account/get/{id} - 응답 매개변수
- guid - 내부 계정의 GUID
- id - 내부 계정의 일련 ID
- section - 이 잔고가 속해 있는 EnergyFather 섹션
- balance - 사용 가능한 자금
- currency - 통화
- user_id - 사용자의 GUID