Skip to content

Calculate Energy Cost

This endpoint calculates the cost of energy purchase without creating a transaction.

POST /v1/calculate

Request

Request Parameters

FieldTypeRequiredDescription
addressstringYesTRON wallet address (34 characters)
energyintegerYesAmount of energy to purchase (minimum 32000)
durationintegerYesDuration in hours (1 hour or 24 hours)
bash
#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "address": "TRX_ADDRESS",
  "energy": 32000,
  "duration": 1
}'

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

# Make API request
curl -X POST "https://api.tronzap.com/v1/calculate" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"
javascript
const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  address: 'TRX_ADDRESS',
  energy: 32000,
  duration: 1
});

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

// Make API request
axios({
  method: 'post',
  url: 'https://api.tronzap.com/v1/calculate',
  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([
  'address' => 'TRX_ADDRESS',
  'energy' => 32000,
  'duration' => 1
]);

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

// Make API request
$ch = curl_init('https://api.tronzap.com/v1/calculate');
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({
  'address': 'TRX_ADDRESS',
  'energy': 32000,
  'duration': 1
})

# 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.tronzap.com/v1/calculate',
  headers=headers,
  data=request_body
)

print(response.json())

Response

The response provides detailed calculation information for the energy purchase.

Response Fields

FieldTypeDescription
codeintegerResponse code (0 = success)
resultobjectResponse data
result.addressstringThe TRON address provided in the request
result.energyintegerThe energy amount provided in the request
result.durationintegerThe duration in hours provided in the request
result.pricefloatTotal price for the energy purchase
result.activation_feefloatPrice for address activation (if required)
result.totalfloatFinal price including activation if required

Example Response

json
{
    "code": 0,
    "result": {
        "address": "TRX_ADDRESS",
        "energy": 32000,
        "duration": 1,
        "price": 1.67,
        "activation_fee": 0,
        "total": 1.67
    }
}

Example Response (Address not activated)

json
{
    "code": 0,
    "result": {
        "address": "TRX_ADDRESS",
        "energy": 32000,
        "duration": 1,
        "price": 1.67,
        "activation_fee": 1.4,
        "total": 3.07
    }
}

Possible Errors

Error CodeDescription
1Authentication error (incorrect token or signature)
2Invalid service or parameters
5Wallet not found
10Invalid TRON address
11Invalid energy amount
12Invalid duration
500Internal server error

Notes

  • The energy amount must be at least 32000.
  • 1-hour and 24-hour durations are supported.
  • This endpoint only calculates the cost without creating a transaction.
  • To create an actual energy purchase transaction, use the Create Transaction endpoint.

Tron Energy API Documentation