Calcola Costo Energia

Questo endpoint calcola il costo dell'acquisto di energia senza creare una transazione.

POST /v1/calculate

Richiesta

Parametri della Richiesta

Campo	Tipo	Richiesto	Descrizione
address	string	Sì	Indirizzo wallet TRON (34 caratteri)
energy	integer	Sì	Quantità di energia da acquistare (minimo 60000)
duration	integer	Sì	Durata in ore (1 ora o 24 ore)

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "address": "TRX_ADDRESS",
  "energy": 60000,
  "duration": 1
}'

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

# Effettua la richiesta API
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',
  energy: 60000,
  duration: 1
});

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

// Effettua la richiesta API
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' => 60000,
  'duration' => 1
]);

// Calcola la firma
$signature = hash('sha256', $requestBody . $apiSecret);

// Effettua la richiesta API
$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': 60000,
  'duration': 1
})

# Calcola la firma
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Effettua la richiesta API
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())

Risposta

La risposta fornisce informazioni dettagliate di calcolo per l'acquisto di energia.

Campi della Risposta

Campo	Tipo	Descrizione
code	integer	Codice di risposta (0 = successo)
result	object	Dati della risposta
result.address	string	L'indirizzo TRON fornito nella richiesta
result.energy	integer	La quantità di energia fornita nella richiesta
result.duration	integer	La durata in ore fornita nella richiesta
result.price	float	Prezzo totale per l'acquisto di energia
result.activation_fee	float	Prezzo per l'attivazione indirizzo (se richiesto)
result.total	float	Prezzo finale inclusa l'attivazione se richiesta

Esempio di Risposta

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

Esempio di Risposta (Indirizzo non attivato)

{
    "code": 0,
    "result": {
        "address": "TRX_ADDRESS",
        "energy": 60000,
        "duration": 1,
        "price": 3.67,
        "activation_fee": 1.4,
        "total": 5.07
    }
}

Possibili Errori

Codice Errore	Descrizione
1	Errore di autenticazione (token o firma errati)
10	Indirizzo TRON non valido
11	Quantità di energia non valida
12	Durata non valida
35	Servizio non disponibile
500	Errore interno del server

Note

• La quantità di energia deve essere almeno 60000.
• Sono supportate durate di 1 ora e 24 ore.
• Questo endpoint calcola solo il costo senza creare una transazione.
• Per creare una transazione di acquisto energia effettiva, utilizza l'endpoint Crea Transazione.