Calculer le Coût des Ressources

Ce endpoint calcule le coût d'achat de ressources sans créer de transaction.

POST /v1/calculate

Requête

Paramètres de Requête

Champ	Type	Requis	Description
address	string	Oui	Adresse du portefeuille TRON (34 caractères)
amount	integer	Oui	Quantité d'énergie ou de bandwidth à acheter (minimum 50000 pour energy, 1000 pour bandwidth)
energy	integer	Non	Obsolète. Utilisez amount.
duration	integer	Oui	Durée en heures. Actuellement, seule 1 heure est prise en charge.
type	string	Non	Type de ressource à calculer : "energy" (par défaut) ou "bandwidth"

Bash

#!/bin/bash
API_TOKEN="votre_token_api"
API_SECRET="votre_secret_api"
REQUEST_BODY='{
  "address": "ADRESSE_TRX",
  "amount": 50000,
  "duration": 1
}'

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

# Faire la requête 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 = 'votre_token_api';
const apiSecret = 'votre_secret_api';
const requestBody = JSON.stringify({
  address: 'ADRESSE_TRX',
  amount: 50000,
  duration: 1
});

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

// Faire la requête 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 = 'votre_token_api';
$apiSecret = 'votre_secret_api';
$requestBody = json_encode([
  'address' => 'ADRESSE_TRX',
  'amount' => 50000,
  'duration' => 1
]);

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

// Faire la requête 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 = 'votre_token_api'
api_secret = 'votre_secret_api'
request_body = json.dumps({
  'address': 'ADRESSE_TRX',
  'amount': 50000,
  'duration': 1
})

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

# Faire la requête 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())

Réponse

La réponse fournit les informations détaillées de calcul pour l'achat d'énergie ou de bandwidth.

Champs de Réponse

Champ	Type	Description
code	integer	Code de réponse (0 = succès)
request_id	string	Identifiant unique de la requête
result	object	Données de réponse
result.address	string	L'adresse TRON fournie dans la requête
result.type	string	Type de ressource ("energy" ou "bandwidth")
result.amount	integer	La quantité d'énergie ou de bandwidth fournie dans la requête
result.energy	integer	Obsolète. Utilisez result.amount.
result.duration	integer	La durée en heures fournie dans la requête
result.price	float	Prix total pour l'achat d'énergie
result.activation_fee	float	Frais d'activation d'adresse (si nécessaire)
result.total	float	Prix final incluant l'activation si nécessaire

Exemple de Réponse

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

Exemple de Réponse (Adresse non activée)

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

Erreurs Possibles

Code d'Erreur	Key	Description
1	auth	Erreur d'authentification (token ou signature incorrecte)
10	invalid_tron_address	Adresse TRON invalide
11	invalid_energy_amount	Quantité d'énergie invalide
12	invalid_duration	Durée invalide
35	service_unavailable	Service non disponible
500	internal_server_error	Erreur interne du serveur

Notes

• La quantité d'énergie doit être d'au moins 50000.
• Actuellement, seule la durée de 1 heure est prise en charge.
• Ce endpoint calcule uniquement le coût sans créer de transaction.
• Pour créer une transaction d'achat d'énergie, utilisez le endpoint Créer une Transaction.