Informazioni Indirizzo

Questo endpoint restituisce le risorse (energia, larghezza di banda) e i saldi dei token (TRX, USDT) per un indirizzo TRON specificato.

POST /v1/address-info

Richiesta

Parametri della Richiesta

Parametro	Tipo	Obbligatorio	Descrizione
address	string	Sì	Indirizzo TRON da interrogare

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{"address":"TKuV4gsNRCqEZwS8zRuHJHnCgvNBce7MPe"}'

# 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/address-info" \
  -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: 'TKuV4gsNRCqEZwS8zRuHJHnCgvNBce7MPe'
});

// 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/address-info',
  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' => 'TKuV4gsNRCqEZwS8zRuHJHnCgvNBce7MPe'
]);

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

// Effettua la richiesta API
$ch = curl_init('https://api.tronzap.com/v1/address-info');
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': 'TKuV4gsNRCqEZwS8zRuHJHnCgvNBce7MPe'
})

# 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/address-info',
  headers=headers,
  data=request_body
)

print(response.json())

Risposta

La risposta fornisce le risorse attuali e i saldi dei token per l'indirizzo TRON specificato.

Campi della Risposta

Campo	Tipo	Descrizione
code	integer	Codice di risposta (0 = successo)
request_id	string	Identificatore univoco della richiesta
result	object	Dati della risposta
result.resources	object	Risorse dell'indirizzo
result.resources.energy	integer	Energia disponibile
result.resources.bandwidth	integer	Larghezza di banda disponibile
result.balances	object	Saldi dei token
result.balances.TRX	float	Saldo TRX
result.balances.USDT	float	Saldo USDT

Esempio di Risposta

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "resources": {
      "energy": 131000,
      "bandwidth": 600
    },
    "balances": {
      "TRX": 10,
      "USDT": 2
    }
  }
}

Possibili Errori

Codice Errore	Key	Descrizione
1	auth	Errore di autenticazione (token o firma errati)
10	invalid_tron_address	Indirizzo TRON non valido
500	internal_server_error	Errore interno del server