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 60000 for energy, 1000 for bandwidth) |
| energy | integer | No | Deprecated. Use amount. |
| duration | integer | Yes | Duration in hours (1 hour or 24 hours) |
| 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": 60000,
"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',
amount: 60000,
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' => 60000,
'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': 60000,
'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) |
| result | object | Response data |
| result.address | string | The TRON address provided in the request |
| 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``
json
{
"code": 0,
"result": {
"address": "TRX_ADDRESS",
"energy": 60000,
"duration": 1,
"price": 1.67,
"activation_fee": 0,
"total": 1.67
}
}Example Response (Address not activated)
json
{
"code": 0,
"result": {
"address": "TRX_ADDRESS",
"energy": 60000,
"duration": 1,
"price": 3.67,
"activation_fee": 1.4,
"total": 5.07
}
}Possible Errors
| Error Code | Description |
|---|---|
| 1 | Authentication error (incorrect token or signature) |
| 10 | Invalid TRON address |
| 11 | Invalid energy amount |
| 12 | Invalid duration |
| 35 | Service not available |
| 500 | Internal server error |
Notes
- The energy amount must be at least 60000.
- 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.
