1. API Rules and Auth
All API request bodies use JSON. The common response shape is {"code":1,"msg":"Success","data":{}}.
https://api.tronspay.com
POST
application/json
UTF-8
QueryInfo Sign
Sign Example
sign = md5(userId + token + secretKey)
SubmitOrder Sign
Sign Example
sign = md5(address + number + token + secretKey)
QueryOrder Sign
Sign Example
sign = md5(orderId + token + secretKey)
2. Open an API Account
Add the official Telegram bot, then open Buy Energy → API to receive your user ID and SecretKey for request signing.
- Entry: Telegram bot → Buy Energy → API
- Credentials: userId and secretKey
- Use: required for identity and signing checks
Store secretKey on the server side and never expose it in frontend code or public repositories.
Example steps:
3. QueryInfo
/api/Energy/QueryInfo
Query account balance, recharge address and current energy price.
Request Fields
Required, user ID
Required, timestamp token
Required, md5(userId + token + secretKey)
Request Example
{
"userId": "165015550404",
"token": "1735119988123",
"sign": "4f2a8c3f9b9f7b0a0e5b5c28f1478abc"
}
Response Example
{
"code": 1,
"msg": "Success",
"data": {
"trxBalance": 19.50,
"rechargeAddress": "TQXx...RechargeAddress",
"energyPrice": 2.50
}
}
Response Fields
Balance used to pay energy orders
User recharge address for TRX deposits
Current energy unit price in TRX
4. SubmitOrder
/api/Energy/SubmitOrder
Submit an energy rental order. Each order normally delivers around 65,000 energy units.
Request Fields
Required, user ID
Required, receiving address
Required, order count as an integer
Required, timestamp token
Required, md5(address + number + token + secretKey)
Request Example
{
"userId": "165015550404",
"address": "TPDoE6f------LLMrgSBB",
"number": 2,
"token": "1735119988123",
"sign": "6d41fce778c2f4f0fdb6358f7a367abc"
}
Response Example
{
"code": 1,
"msg": "Success",
"data": {
"orderId": "4980688112342321122",
"trxBalance": 16.50,
"price": 2.50
}
}
Response Fields
Unique order ID returned after submission
Updated balance after the order is created
TRX cost used for this order
5. QueryOrder
/api/Energy/QueryOrder
Query the status of a submitted order. This endpoint is useful for operational tracking and reconciliation.
Request Fields
Required, user ID
Required, order ID
Required, timestamp token
Required, md5(orderId + token + secretKey)
Response Example
{
"code": 1,
"msg": "Success",
"data": {
"Id": "4980688112342321122",
"Address": "TPDoE6f------LLMrgSBB",
"Duration": 60,
"Trx": 2.50,
"State": 4,
"StateTime": "2025-08-01 16:29:48",
"Remark": "Stake completed",
"CreateTime": "2025-08-01 16:28:52"
}
}
Response Fields
Order ID
Energy receiving address
Rental duration in minutes
TRX cost of the order
Order state: 1 pending, 2 processing, 3 failed, 4 staked, 5 unstaked, 6 canceled
Last state change time
System processing remark
Order creation time
6. State and Error Codes
Pending
Processing
Failed
Stake completed
Unstake completed
Order canceled
Common Errors
- Sign error: incorrect sign order or wrong key
- Insufficient balance: trxBalance cannot cover the order price
- Invalid address: the receiving address is not a valid TRON address
