Calculate Resource Cost

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

POST /v1/calculate

Request

Request Parameters

Field	Type	Required	Description
address	string	Yes	TRON wallet address (34 characters)
amount	integer	Yes	Amount of energy or bandwidth to purchase (minimum 50000 for energy, 1000 for bandwidth)
energy	integer	No	Deprecated. Use amount.
duration	integer	Yes	Duration in hours. Currently only 1 hour is supported.
type	string	No	Resource type to calculate, either "energy" (default) or "bandwidth"

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "address": "TRX_ADDRESS",
  "amount": 50000,
  "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}"

Node.js

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',
  amount: 50000,
  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',
  'amount' => 50000,
  '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',
  'amount': 50000,
  '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 or bandwidth purchase.

Response Fields

Field	Type	Description
code	integer	Response code (0 = success)
request_id	string	Unique request identifier
result	object	Response data
result.address	string	The TRON address provided in the request
result.type	string	Resource type ("energy" or "bandwidth")
result.amount	integer	The energy or bandwidth amount provided in the request
result.energy	integer	Deprecated. Use result.amount.
result.duration	integer	The duration in hours provided in the request
result.price	float	Total price for the energy purchase
result.activation_fee	float	Price for address activation (if required)
result.total	float	Final price including activation if required

Example Response``

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "address": "TRX_ADDRESS",
        "type": "energy",
        "amount": 50000,
        "energy": 50000,
        "duration": 1,
        "price": 1.67,
        "activation_fee": 0,
        "total": 1.67
    }
}

Example Response (Address not activated)

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "address": "TRX_ADDRESS",
        "type": "energy",
        "amount": 50000,
        "energy": 50000,
        "duration": 1,
        "price": 3.67,
        "activation_fee": 1.4,
        "total": 5.07
    }
}

Possible Errors

Error Code	Key	Description
1	auth	Authentication error (incorrect token or signature)
10	invalid_tron_address	Invalid TRON address
11	invalid_energy_amount	Invalid energy amount
12	invalid_duration	Invalid duration
35	service_unavailable	Service not available
500	internal_server_error	Internal server error

Notes

• The energy amount must be at least 50000.
• Currently only 1-hour duration is supported.
• This endpoint only calculates the cost without creating a transaction.
• To create an actual energy purchase transaction, use the Create Transaction endpoint.