Как отслеживать транзакции криптокошелька в таблице (Руководство 2026)
Отслеживание транзакций криптокошелька в таблице состоит из четырех шагов. Экспортируйте по одному файлу для каждого адреса в каждой сети, затем скорректируйте сумму каждого токена с учетом его decimals. Отделите сетевые комиссии от суммы перевода и удалите переводы между собственными кошельками. Пропустите хотя бы один шаг — и итоговые суммы будут неверными.
Сам по себе экспорт не представляет сложности. Таблицу ломает сам файл. Экспорт из обозревателя блоков — это реестр событий блокчейна, а не аккуратная выписка о том, что вы отправили и получили.
В этом руководстве рассказывается, какие данные нужно собрать, как составить таблицу вручную и на каком этапе этот подход перестает себя оправдывать. Это рабочий процесс обработки данных, который не является инвестиционной или налоговой консультацией.
Что вам понадобится перед началом работы
Вам понадобится полный список контролируемых вами адресов, а также информация о том, в каких сетях использовался каждый из них. Пропущенный адрес не вызовет ошибку — он просто незаметно исказит общую картину, сделав ее неполной.
Перед началом работы также необходимо определиться с расчетной единицей. Смешивание исходных сумм и конвертированных значений в одном столбце — самая распространенная и фатальная ошибка.
Для начала стоит определиться с тремя вещами.
Один файл на один адрес в одной сети. Экспорт из обозревателей блоков устроен именно так. Два адреса в двух сетях — это четыре файла, и перед объединением в каждом из них должен быть столбец с меткой.
Какие типы событий вам нужны. Обычные транзакции, внутренние транзакции и переводы токенов обычно экспортируются отдельно. Если выгрузить только первые, вы упустите большую часть активности с токенами.
Ваш часовой пояс. Временные метки записываются в UTC. Сделайте конвертацию один раз при импорте и укажите, в каком часовом поясе составлена таблица.
Как сделать это вручную
Вариант 1: Экспорт, разметка и объединение
Выгрузите каждый экспорт и сразу добавьте два столбца: адрес, к которому он относится, и сеть, из которой он получен. Сделайте это до объединения данных, так как после слияния строк различить их будет невозможно.
Сохраняйте хэш транзакции. Это единственный надежный ключ для обнаружения дублирующихся событий, и пересборка таблицы без него будет означать начало работы с нуля.
Этот шаг выполняется быстро, и именно здесь важна дисциплина. Все последующие этапы зависят от понимания того, откуда взялась каждая строка.
Вариант 2: Нормализация сумм и выделение комиссий
Суммы токенов хранятся в блокчейне как целые числа и должны быть скорректированы с учетом значения decimals токена. Это поле описано в стандарте токенов ERC-20. Восемнадцать decimals — распространенное, но не универсальное значение, поэтому масштабирование всего подряд на 18 может незаметно увеличить некоторые балансы в триллион раз.
Сетевым комиссиям нужен собственный столбец. В Ethereum gas оплачивается в нативной валюте и не зависит от суммы, переданной в рамках транзакции. Добавление комиссии к сумме перевода исказит оба показателя.
Направление транзакции вычисляется, а не задается изначально. Сравните поля from и to со своим списком адресов и запишите In, Out или Internal в собственный столбец.
Вариант 3: Обработка четырех сценариев, которые ломают таблицу
Большинство неверных итогов вызваны четырьмя ситуациями, и для каждой из них требуется четкое правило.
Внутренние транзакции. Средства, перемещаемые смарт-контрактом, а не транзакцией верхнего уровня. Они находятся в отдельном файле экспорта и останутся невидимыми, если вы его не выгрузите.
Неудачные транзакции. Отклоненная транзакция все равно расходует gas. Перевод не состоялся, а комиссия была списана. Исключите их из общих сумм переводов, но оставьте в общих суммах комиссий.
Один хэш, несколько строк. Один своп может создать строку исходящего токена, строку входящего токена и комиссию. Сгруппируйте данные по хэшу перед любыми подсчетами, иначе одно и то же событие будет учтено трижды. Механика этого процесса описана в нашем руководстве по очистке и дедупликации данных.
Переводы между собственными кошельками. Это перемещение средств, а не активность. Сопоставьте их по хэшу в размеченных файлах и исключите, иначе показатели объема будут примерно вдвое выше реальных.
Общий предел. Все три шага предполагают фиксированный набор адресов. Стоит добавить один кошелек или начать использовать новую сеть, как набор файлов экспорта изменится, и всю нормализацию придется запускать заново.
Где ручной подход начинает буксовать
Первая сборка занимает полдня и работает. Проблема в том, что это не разовая задача.
Каждый месяц приносит новые файлы экспорта, а каждый экспорт требует повторного применения тех же правил для decimals, разделения комиссий и самопереводов. В самих данных этой логики нет, поэтому она хранится либо у вас в голове, либо на вкладке, в которой никто другой не разберется.
Разрастание масштабов только усугубляет ситуацию. С двумя адресами еще можно справиться. Шесть адресов в трех сетях — это уже 18 файлов. На этом этапе люди обычно тихо забрасывают обновление таблицы и начинают гадать по интерфейсу кошелька.
Существуют также затраты на сверку. Как только данные в таблице и интерфейсе кошелька расходятся, кому-то приходится выяснять, где ошибка. Такое расследование обходится дороже, чем первоначальная сборка таблицы.
Интерфейс кошелька не заменит таблицу. Он показывает текущие балансы, а не историю событий, и не подскажет, сколько комиссий вы заплатили в прошлом квартале.
Как отслеживать транзакции криптокошелька с помощью Powerdrill Bloom
Шаг 1: Загрузите файлы экспорта
Загрузите все файлы экспорта вместе, а не по одному. Powerdrill Bloom анализирует каждый файл, поэтому различные названия столбцов, смешанные форматы дат и несогласованная точность сумм будут видны еще до объединения данных.
Шаг 2: Опишите правила нормализации на естественном языке
Сформулируйте правила вместо того, чтобы настраивать их вручную. Запросите масштабирование сумм с учетом decimals каждого токена, отделение комиссий от переданного значения и исключение неудачных транзакций из общих сумм переводов.
Затем напрямую задайте вопрос о дедупликации. Спросите, какие строки имеют одинаковый хэш транзакции и какие переводы перемещают средства между адресами из вашего собственного списка.
Шаг 3: Экспортируйте график, отчет или презентацию
Получите нормализованную таблицу активности, график комиссий за определенный период или краткую письменную сводку о том, что и когда было перемещено.
Почему это лучше, чем пересобирать таблицу каждый месяц
| Ручной подход | Powerdrill Bloom | |
|---|---|---|
| Decimals токенов | Поиск и масштабирование для каждого токена | Запрос сумм, масштабированных по decimals |
| Комиссии против суммы перевода | Отдельный столбец для каждого экспорта | Достаточно один раз указать правило |
| Переводы самому себе | Ручное сопоставление хэшей | Запрос строк с перемещениями между собственными адресами |
| Новый адрес или сеть | Повторная нормализация всех данных | Простое добавление файла к загрузке |
Последняя строка — решающая для жизнеспособности таблицы. Процесс, который ломается при добавлении нового кошелька, будет заброшен уже через два квартала.
Распространенные ошибки
Добавление gas к сумме перевода. Комиссия и переданная сумма — это разные вещи. Их объединение завышает показатели оттока средств и делает невозможным последующий анализ комиссий.
Предположение, что у каждого токена 18 decimals. Некоторые популярные токены используют 6. Применение одного коэффициента масштабирования ко всей таблице приведет к ошибкам в балансах на много порядков.
Полное удаление неудачных транзакций. Их следует исключить из общих сумм переводов, но оставить в общих суммах комиссий. Удаление этих строк скрывает реальные расходы.
Двойной учет внутренних транзакций. Они приходят в отдельном файле экспорта и могут пересекаться с уже выгруженными данными. Сгруппируйте их по хэшу перед суммированием.
Пропуск адреса. Итоговые суммы будут выглядеть правдоподобно, но окажутся неполными. Храните список адресов в самой книге, а не в голове.
Отношение к таблице как к оценке портфеля. История транзакций кошелька описывает движение средств, а не их стоимость. Оценка каждой строки требует отдельного решения о том, какой курс и какую временную метку использовать.
Смешивание часовых поясов. Экспортные файлы создаются в UTC. Если конвертировать только часть файлов, транзакции могут попасть не в тот месяц, что незаметно нарушит любое сравнение периодов.
Заключение
Экспорт кошелька — это журнал событий, а не выписка. Размечайте каждый файл по адресу и сети, затем масштабируйте суммы по decimals и выделяйте комиссии. Исключайте неудачные переводы из общих сумм и удаляйте перемещения между собственными кошельками.
Запишите правила рядом с таблицей, так как журнал транзакций кошелька без описания правил невозможно воспроизвести заново.
Самое затратное — повторять все это при каждом появлении нового адреса или сети. Если именно на это уходит ваше время, попробуйте Powerdrill Bloom для работы с уже имеющимися файлами экспорта. Читайте также наши руководства по анализу CSV-экспорта криптобиржи и анализу криптопортфеля из CSV, а также страницу CSV AI-ассистента.
Frequently asked questions
Как экспортировать транзакции кошелька в таблицу?
Используйте обозреватель блоков для каждой сети и выполните экспорт для каждого адреса. Обычные транзакции, внутренние транзакции и переводы токенов обычно загружаются отдельно, поэтому выгрузите все три типа данных перед их объединением.
Почему суммы токенов выглядят неверно после импорта?
Суммы токенов хранятся в виде целых чисел и требуют масштабирования на основе значения decimals этого токена. Восемнадцать — распространенное, но не универсальное значение, и применение неверного коэффициента изменит баланс на несколько порядков.
Должна ли комиссия за gas включаться в сумму транзакции?
Нет. Комиссии оплачиваются в нативной валюте сети и отделены от переданной суммы. Храните их в отдельном столбце, чтобы общие суммы переводов и комиссий оставались независимыми.
Как избежать двойного учета переводов между собственными кошельками?
Ведите список всех контролируемых вами адресов, а затем сопоставляйте с ним поля from и to. Переводы, в которых обе стороны принадлежат вам, являются внутренним перемещением средств и должны быть исключены из общих итогов активности.
Имеют ли значение неудачные транзакции?
Да, для учета комиссий. Отклоненная транзакция не перемещает средства, но все равно расходует gas, поэтому исключите ее из общих сумм переводов, сохранив при этом списанную комиссию.