Информация об адресе

Этот эндпоинт возвращает ресурсы (энергия, пропускная способность) и балансы токенов (TRX, USDT) для указанного TRON-адреса.

POST /v1/address-info

Запрос

Параметры запроса

Параметр	Тип	Обязательный	Описание
address	string	Да	TRON-адрес для запроса

Bash

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

# Расчет подписи
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Выполнение 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'
});

// Расчет подписи
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Выполнение 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'
]);

// Расчет подписи
$signature = hash('sha256', $requestBody . $apiSecret);

// Выполнение 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'
})

# Расчет подписи
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Выполнение 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())

Ответ

Ответ содержит текущие ресурсы и балансы токенов для указанного TRON-адреса.

Поля ответа

Поле	Тип	Описание
code	integer	Код ответа (0 = успех)
request_id	string	Уникальный идентификатор запроса
result	object	Данные ответа
result.resources	object	Ресурсы адреса
result.resources.energy	integer	Доступная энергия
result.resources.bandwidth	integer	Доступная пропускная способность
result.balances	object	Балансы токенов
result.balances.TRX	float	Баланс TRX
result.balances.USDT	float	Баланс USDT

Пример ответа

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

Возможные ошибки

Код ошибки	Key	Описание
1	auth	Ошибка аутентификации (неверный токен или подпись)
10	invalid_tron_address	Неверный TRON-адрес
500	internal_server_error	Внутренняя ошибка сервера