Información de Dirección

Este endpoint devuelve los recursos (energía, ancho de banda) y los balances de tokens (TRX, USDT) para una dirección TRON especificada.

POST /v1/address-info

Solicitud

Parámetros de Solicitud

Parámetro	Tipo	Requerido	Descripción
address	string	Sí	Dirección TRON a consultar

Bash

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

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

# Realizar solicitud a la 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'
});

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

// Realizar solicitud a la 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'
]);

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

// Realizar solicitud a la 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'
})

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

# Realizar solicitud a la 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())

Respuesta

La respuesta proporciona los recursos actuales y los balances de tokens para la dirección TRON especificada.

Campos de Respuesta

Campo	Tipo	Descripción
code	integer	Código de respuesta (0 = éxito)
request_id	string	Identificador único de la solicitud
result	object	Datos de respuesta
result.resources	object	Recursos de la dirección
result.resources.energy	integer	Energía disponible
result.resources.bandwidth	integer	Ancho de banda disponible
result.balances	object	Balances de tokens
result.balances.TRX	float	Balance de TRX
result.balances.USDT	float	Balance de USDT

Ejemplo de Respuesta

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

Posibles Errores

Código de Error	Key	Descripción
1	auth	Error de autenticación (token o firma incorrectos)
10	invalid_tron_address	Dirección TRON inválida
500	internal_server_error	Error interno del servidor