Create Transaction
Creates a new transaction for energy or bandwidth purchase, resource bundle, or address activation.
A resource bundle allows you to purchase both energy and bandwidth in a single API request.
POST /v1/transaction/new
Request
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| external_id | string | No | Optional external transaction identifier |
| service | string | Yes | Service type: "energy", "bandwidth", "resource_bundle", or "activate_address" |
| params | object | Yes | Service parameters object |
| params.address | string | Yes | TRON wallet address (34 characters) |
| params.amount* | integer | Conditional | Amount of energy or bandwidth to purchase. Required when service="energy" or "bandwidth" and params.amounts is not provided. |
| params.energy_amount* | integer | No | Deprecated. Use params.amount or params.amounts.energy. |
| params.amounts* | object | Conditional | Resource amounts object. Required when service="resource_bundle". Can also be used for "energy" and "bandwidth" services. |
| params.amounts.energy | integer | Conditional | Amount of energy to purchase. Required inside amounts for "resource_bundle". |
| params.amounts.bandwidth | integer | Conditional | Amount of bandwidth to purchase. Required inside amounts for "resource_bundle". |
| params.duration | integer | Yes | Duration in hours. Currently only 1 hour is supported for energy, bandwidth, and resource_bundle. |
| params.activate_address | boolean | No | Whether to activate the address. Optional for energy, bandwidth, and resource_bundle services. |
* We recommend using the amounts object as the most universal approach. The API resolves the resource amount in the following order: params.amounts → params.amount → params.energy_amount.
bash
#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
"external_id": "my-external-id-123",
"service": "energy",
"params": {
"address": "TRX_ADDRESS",
"amounts": {
"energy": 65000
},
"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/transaction/new" \
-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({
external_id: 'my-external-id-123',
service: 'energy',
params: {
address: 'TRX_ADDRESS',
amounts: {
energy: 65000
},
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/transaction/new',
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([
'external_id' => 'my-external-id-123',
'service' => 'energy',
'params' => [
'address' => 'TRX_ADDRESS',
'amounts' => [
'energy' => 65000
],
'duration' => 1
]
]);
// Calculate signature
$signature = hash('sha256', $requestBody . $apiSecret);
// Make API request
$ch = curl_init('https://api.tronzap.com/v1/transaction/new');
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({
'external_id': 'my-external-id-123',
'service': 'energy',
'params': {
'address': 'TRX_ADDRESS',
'amounts': {
'energy': 65000
},
'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/transaction/new',
headers=headers,
data=request_body
)
print(response.json())Example Request for Resource Bundle
bash
#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
"external_id": "my-external-id-123",
"service": "resource_bundle",
"params": {
"address": "TRX_ADDRESS",
"amounts": {
"energy": 65000,
"bandwidth": 345
},
"duration": 1,
"activate_address": true
}
}'
# Calculate signature
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)
# Make API request
curl -X POST "https://api.tronzap.com/v1/transaction/new" \
-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({
external_id: 'my-external-id-123',
service: 'resource_bundle',
params: {
address: 'TRX_ADDRESS',
amounts: {
energy: 65000,
bandwidth: 5000
},
duration: 1,
activate_address: true
}
});
// Calculate signature
const signature = crypto
.createHash('sha256')
.update(requestBody + apiSecret)
.digest('hex');
// Make API request
axios({
method: 'post',
url: 'https://api.tronzap.com/v1/transaction/new',
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([
'external_id' => 'my-external-id-123',
'service' => 'resource_bundle',
'params' => [
'address' => 'TRX_ADDRESS',
'amounts' => [
'energy' => 65000,
'bandwidth' => 5000
],
'duration' => 1,
'activate_address' => true
]
]);
// Calculate signature
$signature = hash('sha256', $requestBody . $apiSecret);
// Make API request
$ch = curl_init('https://api.tronzap.com/v1/transaction/new');
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({
'external_id': 'my-external-id-123',
'service': 'resource_bundle',
'params': {
'address': 'TRX_ADDRESS',
'amounts': {
'energy': 65000,
'bandwidth': 5000
},
'duration': 1,
'activate_address': True
}
})
# 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/transaction/new',
headers=headers,
data=request_body
)
print(response.json())Example Request for Address Activation
bash
#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
"external_id": "my-external-id-123",
"service": "activate_address",
"params": {
"address": "TRX_ADDRESS"
}
}'
# Calculate signature
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)
# Make API request
curl -X POST "https://api.tronzap.com/v1/transaction/new" \
-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({
external_id: 'my-external-id-123',
service: 'activate_address',
params: {
address: 'TRX_ADDRESS'
}
});
// Calculate signature
const signature = crypto
.createHash('sha256')
.update(requestBody + apiSecret)
.digest('hex');
// Make API request
axios({
method: 'post',
url: 'https://api.tronzap.com/v1/transaction/new',
headers: {
'Authorization': `Bearer ${apiToken}`,
'X-Signature': signature,
'Content-Type': 'application/json'
},
data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));Response
The response provides details about the created transaction.
Response Fields
| Field | Type | Description |
|---|---|---|
| code | integer | Response code (0 = success) |
| request_id | string | Unique request identifier |
| result | object | Response data |
| result.id | string | Internal transaction ID |
| result.external_id | string|null | External transaction ID (if provided) |
| result.service | string | Service type: "energy", "bandwidth", "resource_bundle", or "activate_address" |
| result.params | object | Original request parameters |
| result.params.activate_address | boolean | Whether address activation was requested |
| result.status | string | Transaction status (see status list) |
| result.amount | float | Transaction amount |
| result.created_at | string | Creation timestamp (ISO 8601 format) |
| result.hash | string | Transaction hash (if completed) |
Example Response
json
{
"code": 0,
"request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
"result": {
"id": "transaction_id",
"external_id": "my-external-id-123",
"service": "energy",
"params": {
"address": "TRX_ADDRESS",
"amounts": {
"energy": 65000
},
"duration": 1,
"activate_address": false
},
"status": "success",
"amount": 8.25,
"created_at": "2024-03-22T12:00:00Z",
"hash": "transaction_hash"
}
}Possible Errors
| Error Code | Key | Description |
|---|---|---|
| 1 | auth | Authentication error (incorrect token or signature) |
| 2 | invalid_service_or_params | Invalid service or parameters |
| 5 | wallet_not_found | Wallet not found |
| 6 | insufficient_funds | Insufficient funds |
| 10 | invalid_tron_address | Invalid TRON address |
| 11 | invalid_energy_amount | Invalid energy amount |
| 12 | invalid_duration | Invalid duration |
| 50 | invalid_bandwidth_amount | Invalid bandwidth amount |
| 24 | address_not_activated | Address not activated |
| 25 | address_already_activated | Address already activated |
| 35 | service_unavailable | Service not available |
| 500 | internal_server_error | Internal server error |