Informações do Endereço

Este endpoint retorna os recursos (energia, largura de banda) e saldos de tokens (TRX, USDT) para um endereço TRON especificado.

POST /v1/address-info

Requisição

Parâmetros da Requisição

Parâmetro	Tipo	Obrigatório	Descrição
address	string	Sim	Endereço TRON a consultar

Bash

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

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

# Faz a requisição à 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 = 'seu_token_api';
const apiSecret = 'seu_segredo_api';
const requestBody = JSON.stringify({
  address: 'TKuV4gsNRCqEZwS8zRuHJHnCgvNBce7MPe'
});

// Calcula a assinatura
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Faz a requisição à 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 = 'seu_token_api';
$apiSecret = 'seu_segredo_api';
$requestBody = json_encode([
  'address' => 'TKuV4gsNRCqEZwS8zRuHJHnCgvNBce7MPe'
]);

// Calcula a assinatura
$signature = hash('sha256', $requestBody . $apiSecret);

// Faz a requisição à 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 = 'seu_token_api'
api_secret = 'seu_segredo_api'
request_body = json.dumps({
  'address': 'TKuV4gsNRCqEZwS8zRuHJHnCgvNBce7MPe'
})

# Calcula a assinatura
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Faz a requisição à 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())

Resposta

A resposta fornece os recursos atuais e saldos de tokens para o endereço TRON especificado.

Campos da Resposta

Campo	Tipo	Descrição
code	integer	Código da resposta (0 = sucesso)
request_id	string	Identificador único da requisição
result	object	Dados da resposta
result.resources	object	Recursos do endereço
result.resources.energy	integer	Energia disponível
result.resources.bandwidth	integer	Largura de banda disponível
result.balances	object	Saldos de tokens
result.balances.TRX	float	Saldo TRX
result.balances.USDT	float	Saldo USDT

Exemplo de Resposta

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

Possíveis Erros

Código do Erro	Key	Descrição
1	auth	Erro de autenticação (token ou assinatura incorretos)
10	invalid_tron_address	Endereço TRON inválido
500	internal_server_error	Erro interno do servidor