Estimate Energy Amount

This endpoint estimates the energy amount needed to make a token transfer without creating a transaction.

POST /v1/estimate-energy

Request

Request Parameters

Field	Type	Required	Description
from_address	string	Yes	Sender's TRON wallet address (34 characters)
to_address	string	Yes	Recipient's TRON wallet address (34 characters)
contract_address	string	No	Smart contract address (default: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t - Tether (USDT))

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "from_address": "TRX_FROM_ADDRESS",
  "to_address": "TRX_TO_ADDRESS",
  "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}'

# Calculate signature
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Make API request
curl -X POST "https://api.trxup.com/v1/estimate-energy" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  from_address: 'TRX_FROM_ADDRESS',
  to_address: 'TRX_TO_ADDRESS',
  contract_address: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
});

// Calculate signature
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Make API request
axios({
  method: 'post',
  url: 'https://api.trxup.com/v1/estimate-energy',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'from_address' => 'TRX_FROM_ADDRESS',
  'to_address' => 'TRX_TO_ADDRESS',
  'contract_address' => 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
]);

// Calculate signature
$signature = hash('sha256', $requestBody . $apiSecret);

// Make API request
$ch = curl_init('https://api.trxup.com/v1/estimate-energy');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'from_address': 'TRX_FROM_ADDRESS',
  'to_address': 'TRX_TO_ADDRESS',
  'contract_address': 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
})

# Calculate signature
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Make API request
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.trxup.com/v1/estimate-energy',
  headers=headers,
  data=request_body
)

print(response.json())

Response

The response provides detailed calculation information for the energy needed to make a token transfer.

Response Fields

Field	Type	Description
code	integer	Response code (0 = success)
request_id	string	Unique request identifier
result	object	Response data
result.amount	integer	The energy purchase that covers the transfer, and the amount to pass to Create Transaction: the estimate itself when a service sells exactly that, otherwise the smallest amount on sale above it
result.energy	integer	Energy amount needed to make transfer using the contract (deprecated, use amount)
result.needed	integer	What the transfer itself burns, as the node reports it. Returned only when it is less than amount — that is, when the transfer falls below the smallest amount on sale
result.duration	integer	Duration in hours (currently only 1 hour is available)
result.price	float	Price to delegate energy
result.activation_fee	float	Price for address activation (if required)
result.total	float	Final price including activation if required
result.from_address	string	The sender's TRON address provided in the request
result.to_address	string	The recipient's TRON address provided in the request
result.contract_address	string	The smart contract address used for the calculation

Example Response

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "amount": 64400,
        "energy": 64400,
        "duration": 1,
        "price": 3.66,
        "activation_fee": 0,
        "total": 3.66,
        "from_address": "TRX_FROM_ADDRESS",
        "to_address": "TRX_TO_ADDRESS",
        "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
    }
}

Example Response (Address not activated)

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "amount": 64400,
        "energy": 64400,
        "duration": 1,
        "price": 3.66,
        "activation_fee": 1.4,
        "total": 5.06,
        "from_address": "TRX_FROM_ADDRESS",
        "to_address": "TRX_TO_ADDRESS",
        "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
    }
}

Example Response (transfer below the smallest amount on sale)

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "amount": 65000,
        "energy": 65000,
        "duration": 1,
        "price": 3.4,
        "activation_fee": 0,
        "total": 3.4,
        "needed": 64285,
        "from_address": "TRX_FROM_ADDRESS",
        "to_address": "TRX_TO_ADDRESS",
        "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
    }
}

Possible Errors

Error Code	Key	Description
1	auth	Authentication error (incorrect token or signature)
10	invalid_tron_address	Invalid from address
10	invalid_tron_address	Invalid to address
10	invalid_tron_address	Invalid contract address
35	service_unavailable	Service not available
500	internal_server_error	Internal server error

Notes

• The contract_address parameter is optional and defaults to TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t (Tether USDT)
• This endpoint only estimates energy to make USDT transfer without creating a transaction
• To create an actual energy purchase transaction, use the Create Transaction endpoint
• Energy is sold in fixed amounts. A transfer that burns less than the smallest one on sale is quoted at that amount: amount is what you buy and pay for, needed is what the transfer burns. Code 35 service_unavailable is left for an estimate nothing on sale covers — above the largest amount, or no hourly energy on sale at all