История транзакций TRC20: как выгрузить в CSV для учёта через Tronscan и API

Коротко: история транзакций TRC20 хранится в блокчейне TRON и доступна любому по адресу кошелька. Для учёта её выгружают двумя способами: кнопкой экспорта в CSV на странице адреса в Tronscan — быстро, но с ограничениями по объёму и периоду, — или через API TronGrid, где можно забрать все переводы USDT за любой срок постранично. Комиссии в TRX и сожжённую энергию лучше выгружать отдельно: в списке переводов токена их обычно нет.

Зачем выгружать историю переводов USDT

Кошелёк показывает последние операции, но не годится как учётный документ: в нём нет фильтров по периоду, контрагентам и комиссиям, а при смене приложения история «пропадает» из интерфейса. В самом блокчейне она остаётся навсегда, поэтому выгрузка — это просто способ забрать данные в удобный формат.

Чаще всего выгрузка нужна в четырёх ситуациях:

• Сверка с бухгалтерией или отчётом для партнёра: сколько USDT пришло и ушло за месяц.
• Подсчёт расходов на комиссии сети: сколько TRX сгорело и сколько энергии ушло на переводы.
• Разбор спорного платежа: найти хэш, время и адрес отправителя за конкретную дату.
• Подготовка данных для налоговой декларации — как именно учитывать операции, решают законы вашей страны и ваш бухгалтер, статья об этом не консультирует.

Что есть в истории адреса, а чего нет

У одного адреса TRON несколько типов записей, и в разных выгрузках они лежат отдельно:

• Переводы TRX — обычные транзакции перевода родной монеты.
• Переводы TRC-20 токенов (USDT и другие) — вызовы смарт-контракта, которые оставляют событие Transfer. Именно их Tronscan показывает во вкладке переводов токенов.
• Служебные операции: заморозка TRX, делегирование энергии, голосование, смена permissions, approve.
• Комиссии: сколько bandwidth и энергии списано и сколько TRX сожжено, если своих ресурсов не хватило. Это поля квитанции (receipt) конкретной транзакции, а не отдельная операция.

Важная деталь для учёта: неудачная транзакция со статусом REVERT или OUT_OF_ENERGY не переводит USDT, поэтому в списке переводов токена её нет. Но TRX за неё сгорели — и в расходах на комиссии она должна быть.

Как выгрузить историю транзакций TRC20 с Tronscan в CSV

Самый простой путь, без программирования. Подходит, если операций немного и нужен разовый отчёт.

• Откройте tronscan.org и вставьте адрес кошелька в поиск. Ключи и сид-фраза не нужны: история публичная.
• Перейдите во вкладку переводов (Transfers) и выберите раздел токенов TRC-20.
• Отфильтруйте токен USDT. Сверьте адрес контракта: настоящий USDT в TRON — TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t.
• Задайте период — для учёта удобнее выгружать по календарным месяцам.
• Нажмите кнопку загрузки (Export / Download CSV). Tronscan может попросить пройти проверку «я не робот».
• Откройте файл в Excel или Google Таблицах. Если кириллица или числа отображаются криво — импортируйте файл через «Данные → Из текста/CSV» с кодировкой UTF-8 и разделителем «запятая».

Ограничения, о которых стоит знать заранее. Объём одной выгрузки и доступный период у Tronscan ограничены, а интерфейс со временем меняется. Если история длинная, выгружайте по месяцам и проверяйте, что число строк совпадает с количеством операций на странице. Во выгрузке переводов токена обычно нет колонки с комиссией — её берут отдельно.

Как получить историю транзакций TRC20 через API

Если операций сотни и тысячи или отчёт нужен регулярно, удобнее API. У TronGrid есть отдельный метод для переводов TRC-20 по адресу:

GET https://api.trongrid.io/v1/accounts/<адрес>/transactions/trc20?contract_address=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&limit=200

Параметры, которые пригодятся для учёта:

• contract_address — оставляет только USDT и отсекает спам-токены.
• limit — сколько записей на странице, по документации максимум 200.
• fingerprint — метка следующей страницы из поля meta.fingerprint предыдущего ответа. Запрашивайте страницы, пока она приходит.
• min_timestamp и max_timestamp — границы периода в миллисекундах.
• only_confirmed=true — только подтверждённые транзакции, чтобы в отчёт не попало то, что ещё не закрепилось в сети.
• only_to или only_from — только входящие или только исходящие.

В каждой записи есть transaction_id (хэш), block_timestamp, from, to, value и token_info с числом знаков после запятой. Для отчёта сделайте три преобразования: value разделите на 10 в степени decimals (у USDT шесть знаков, то есть 1 000 000 в value — это 1 USDT); время из миллисекунд UTC переведите в ваш часовой пояс; направление определите сравнением from и to с вашим адресом.

Без ключа API действуют строгие лимиты запросов. Бесплатный ключ выдаётся в кабинете TronGrid и передаётся в заголовке TRON-PRO-API-KEY. Сам ключ даёт только доступ к чтению публичных данных — к вашим средствам он отношения не имеет.

Как добавить в отчёт комиссии: энергию и сожжённые TRX

Метод переводов TRC-20 не возвращает комиссию. Её достают по хэшу каждой транзакции методом gettransactioninfobyid. В ответе есть поле fee — сколько TRX сожжено, в SUN (1 TRX = 1 000 000 SUN), и квитанция receipt: energy_usage_total — всего энергии на транзакцию, energy_fee — сколько SUN сожжено за недостающую энергию, net_usage и net_fee — то же для bandwidth.

Ориентиры для проверки цифр: перевод USDT на адрес, где уже есть USDT, тратит около 64 500–65 000 энергии, на пустой адрес — примерно вдвое больше, около 131 000. Если своей или арендованной энергии не было, сеть сжигает около 6,5 TRX, на пустой адрес — около 13. Если в вашей выгрузке у одинаковых переводов расход заметно другой, проверьте, не было ли в этот день повышенного множителя динамической энергии у контракта.

Как привести выгрузку в порядок перед учётом

• Уберите нулевые и копеечные входящие переводы с похожих адресов — это следы атаки «отравление адреса», а не реальные платежи.
• Оставьте только контракт TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t: токены с названием USDT, но другим контрактом — подделки.
• Удалите дубли по хэшу: при постраничной выгрузке одна запись может попасть на стык страниц дважды.
• Разделите операции на свои переводы (между вашими кошельками) и внешние — иначе оборот задвоится.
• Сохраните хэш в каждой строке: по нему любую операцию можно проверить в Tronscan спустя годы.
• Для вводов и выводов с биржи возьмите ещё и выгрузку самой биржи: в блокчейне видны только адреса её горячих кошельков, а внутренние операции биржи в сеть не попадают.

Что делать с цифрой расходов на комиссии

Выгрузка с полями fee и energy_usage_total показывает, сколько вы на самом деле платите сети. Если в отчёте много строк с сожжёнными TRX, значит, переводы шли без энергии. Для частых переводов это закрывается арендой: энергия делегируется на ваш адрес на срок, ключи и доступ к кошельку не передаются.

Блокчейн уже ведёт учёт за вас. Ваша задача — правильно забрать данные: отдельно переводы, отдельно комиссии, и хэш в каждой строке.