Баланс через balanceOf
/wallet/triggerconstantcontract с function_selector balanceOf(address) возвращает баланс USDT TRC-20 на адресе без комиссии и без подписи — подходит для регулярной проверки.
USDT · TRC-20 · TRON
USDT TRC-20 API
USDT TRC-20 API
приём и мониторинг переводов
USDT TRC-20 — это токен на ноде TRON, а не отдельная сеть, поэтому баланс, переводы и статус транзакций читаются теми же вызовами /wallet/*, что описаны для TRON API: triggerconstantcontract для чтения, triggersmartcontract и broadcasttransaction для отправки. Прокси прозрачен к пути и телу запроса.
HTTP REST API
та же нода TRON, что и для TRC-20
Контракт токена
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
Старт сегодня
доступ открывается в день обращения
# balanceOf — баланс USDT TRC-20 на адресе
curl -X POST https://nodes-api.cryptosafe.pro/proxy/tron/wallet/triggerconstantcontract \
-H "Authorization: $CSN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"owner_address":"TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW","contract_address":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","function_selector":"balanceOf(address)","parameter":"0000000000000000000000...","visible":true}'// gettransactioninfobyid — статус конкретного перевода по хэшу
const res = await fetch(
'https://nodes-api.cryptosafe.pro/proxy/tron/wallet/gettransactioninfobyid',
{
method: 'POST',
headers: {
'Authorization': process.env.CSN_TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({ value: '<хэш транзакции>' })
}
)
// в ответе — лог события Transfer с адресами и суммой
const data = await res.json()
Путь ноды — после /proxy/tron, как есть
Возможности
Что нужно для приёма USDT TRC-20
USDT TRC-20 работает как обычный TRC-20-контракт на ноде TRON — без своего протокола и своих методов. Приём и мониторинг переводов строятся на тех же вызовах, что и любая другая работа с контрактами TRON.
Мониторинг переводов
Каждый перевод USDT TRC-20 порождает событие Transfer в логах транзакции. /wallet/gettransactioninfobyid по хэшу возвращает статус и лог с адресами и суммой.
Отправка USDT
/wallet/triggersmartcontract с function_selector transfer(address,uint256) готовит транзакцию, а /wallet/broadcasttransaction отправляет подписанную транзакцию в сеть TRON.
Ключ с IP-ограничением
Ключ можно привязать к IP-адресам и подсетям CIDR ваших серверов. Запрос с незарегистрированного адреса получит ошибку 8003. Поддерживаются IPv4 и IPv6; до 50 записей на ключ.
Инфраструктура на нас
Синхронизация ноды TRON, обновления клиента и мониторинг — наша ответственность. Адрес вашего эндпоинта не меняется при любых обновлениях с нашей стороны. Как принимать USDT со стороны инфраструктуры — в статье в блоге.
Статистика по запросам
В личном кабинете видно количество запросов к ноде TRON, долю успешных и время ответа. Метрики собираются с первого дня без дополнительной настройки.
Подключение
Четыре шага до приёма USDT TRC-20
От первого сообщения до рабочей проверки баланса и мониторинга переводов — обычно в тот же день.
01
Напишите нам
Напишите нам в чат поддержки на сайте: скажите, что нужен доступ к TRON для работы с USDT TRC-20. Мы откроем кабинет в день обращения.
02
Выпустите ключ
В личном кабинете создайте ключ. При необходимости добавьте IP-адреса серверов, с которых будут идти запросы к ноде TRON.
03
Укажите базовый адрес
Базовый адрес для всех запросов — https://nodes-api.cryptosafe.pro/proxy/tron.
Контракт USDT TRC-20 — TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t.
Ключ передаётся в заголовке Authorization.
04
Проверяйте баланс и переводы
balanceOf через triggerconstantcontract — для баланса, gettransactioninfobyid — для статуса конкретного перевода по хэшу. В кабинете сразу начнёт накапливаться статистика по вашим вызовам.
Вопросы
Частые вопросы об USDT TRC-20 API
Как проверить баланс USDT TRC-20 на адресе?
Баланс читается вызовом balanceOf(address) через /wallet/triggerconstantcontract с адресом контракта токена. Это тот же путь ноды TRON, что и для остальных вызовов — прокси передаёт тело запроса без изменений и возвращает ответ как есть.
Чем triggerconstantcontract отличается от triggersmartcontract?
triggerconstantcontract выполняет вызов без комиссии и без подписи — подходит для чтения состояния, например баланса. triggersmartcontract готовит транзакцию, изменяющую состояние (например, перевод), — её нужно подписать и отправить через /wallet/broadcasttransaction.
Как отследить входящий перевод USDT?
Каждый перевод USDT TRC-20 порождает событие Transfer в логах транзакции. Статус конкретной транзакции по её хэшу возвращает /wallet/gettransactioninfobyid — там же видны логи с адресами отправителя, получателя и суммой перевода.
Какой адрес у контракта USDT TRC-20?
Официальный контракт Tether на TRON — TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. Он передаётся как contract_address в вызовах triggerconstantcontract и triggersmartcontract и не меняется.
Как правильно передавать ключ аутентификации?
Ключ передаётся в заголовке Authorization без префикса Bearer — именно как значение, без дополнительных слов. Пример: Authorization: ваш-ключ. Ключи выпускаются в личном кабинете; на компанию доступно до трёх ключей.
Можно ли ограничить доступ по IP?
Да. Каждый ключ можно привязать к списку IP-адресов и подсетей CIDR — до 50 записей. Поддерживаются IPv4 и IPv6. Пустой список означает доступ с любого адреса. Вспомогательный эндпоинт https://nodes-api.cryptosafe.pro/info/getip вернёт ваш текущий IP текстом.
Нужен приём USDT TRC-20 в вашем сервисе?
Напишите в чат поддержки — откроем доступ к ноде TRON для приёма и мониторинга USDT TRC-20 в день обращения. Ключ выпускаете сами в кабинете, инфраструктуру держим мы.