Коротко: для архива сделок обычно достаточно штатного экспорта в личном кабинете биржи. Выберите тип данных, аккаунт и период, дождитесь формирования файла и скачайте CSV напрямую с официальной страницы. Так история сохраняется у вас локально без передачи API-секрета портфельному сервису. Названия разделов, лимиты и сроки хранения ссылки различаются, поэтому перед выгрузкой сверяйтесь с актуальной справкой площадки.
Что подготовить до экспорта
Сначала определите, какие записи нужны. История исполненных сделок отличается от ордеров, депозитов, выводов и начислений. Для анализа купли-продажи важна таблица трейдов; для полной сверки аккаунта могут понадобиться отдельные отчёты по комиссиям, внутренним переводам, пополнениям и выводу. Один файл не всегда содержит всё. Составьте перечень требуемых типов операций и не считайте пустую колонку доказательством, что операции не было.
Сверьте правильный аккаунт и субаккаунт, рынок и диапазон дат. Некоторые биржи ограничивают период одной выгрузки или разделяют текущую и архивную историю. Временная зона тоже имеет значение: экспорт может использовать UTC или локальное время биржи. Если период пересекает границу суток, проверьте включительность дат, чтобы не пропустить или не задвоить строки на стыке файлов.
Отдельно подумайте о способе доступа. Если нужно только выгрузить историю, API-ключ часто не требуется. Если всё же используете автоматизацию, создайте ограниченный read-only ключ по инструкции о настройке и отзыве API-ключа. Не вводите пароль и секрет на внешнем сайте, который обещает «автоматическую синхронизацию», пока не проверите оператора и права доступа.
Экспорт из официального кабинета
Откройте биржу через собственную закладку или введённый адрес и перейдите в раздел истории, отчётов или экспорта. Перед входом проверьте домен, особенно если получили ссылку на скачивание в письме. Сторонние копии интерфейса могут выглядеть правдоподобно. Если сайт просит API secret для обычной выгрузки отчёта, остановитесь и сначала проверьте, действительно ли это официальный поток.
Выберите тип записи «сделки» или аналогичный раздел, затем задайте временной промежуток, аккаунт и необходимые рынки. Не добавляйте все типы данных без необходимости: большой объём сложнее проверять и безопасно хранить. Если биржа предлагает CSV, выберите его и дождитесь готовности отчёта. Некоторые площадки выдают файл сразу, другие сначала создают запрос и открывают временную ссылку позже.
Скачивайте файл только из кабинета биржи. Если ссылка имеет короткий срок действия, сохраните файл сразу и проверьте, что он открылся. Не пересылайте отчёт случайному бухгалтерскому сервису или в чат. Файл может раскрывать историю торговли, остатки, торговые пары, время операций и идентификаторы аккаунта. Доступ к нему нужно ограничить не слабее, чем к банковской выписке.
- Войдите в официальный аккаунт и включите многофакторную защиту.
- Откройте историю исполненных сделок или центр экспорта отчётов.
- Выберите нужный аккаунт, рынок и период, учитывая лимит длины выгрузки.
- Запросите CSV и дождитесь состояния готовности.
- Скачайте файл напрямую, проверьте имя, размер и период в содержимом.
- Сохраните оригинал в защищённом месте и создавайте копию перед обработкой.
Как проверить и свести CSV
Откройте файл в локальной таблице или текстовом редакторе, предварительно проверьте, что формат действительно CSV, а разделитель и кодировка распознаны правильно. Не открывайте неизвестные файлы с включёнными макросами. В CSV встречаются значения, которые табличные редакторы могут интерпретировать как формулы; импортируйте данные как обычный текст или отключите выполнение формул для полей, начинающихся с символов `=`, `+`, `-` или `@`. Это защищает от вредоносного содержимого в названии пары или заметке.
Проверьте заголовки колонок: время, идентификатор сделки или ордера, направление, торговая пара, количество, цена, комиссия и актив комиссии. Фактический набор зависит от биржи. Сохраните исходную единицу времени и не преобразуйте даты до создания резервной копии. Если числа записаны с десятичной точкой, русская локаль таблицы может прочитать их как текст или изменить точность. Для крупных значений используйте импорт с явным выбором разделителя и десятичного формата.
Посчитайте строки, найдите минимальное и максимальное время, проверьте дубликаты по идентификатору сделки и сравните несколько случайных записей с историей в кабинете. Если диапазон большой, проверьте каждую выгрузку после объединения и удалите повтор на границе только по надёжному ключу, а не по совпадающей сумме. Комиссия иногда списывается в третьем активе; её нельзя автоматически вычитать из полученной валюты без учёта поля актива комиссии.
Движение сделки на централизованной бирже не обязано создавать отдельную публичную транзакцию для каждой строки. Отличие внутренней записи от ончейн-перевода разобрано в материале о внутреннем переводе и выводе в сеть. Если сверяете вывод, отдельно запишите TxID и проверьте блокчейн по руководству о сопоставлении статуса биржи и сети.
Защита данных и долговременное хранение
Сохраните неизменённый оригинал отдельно от рабочей копии. Для учёта используйте структурированное имя с названием биржи, типом отчёта и периодом, но избегайте добавления логина или других персональных данных в filename. Храните файл на устройстве с шифрованием диска и резервной копией. Не размещайте его в общей папке, открытой ссылке или облаке с настройкой «доступен всем по ссылке».
Если вы загружаете копию в стороннюю программу, изучите её разрешения и политику хранения. Удалите временный CSV и экспортированные копии после того, как они больше не нужны, включая корзину и папку загрузок. Секретный ключ биржи не является частью CSV и не должен прикладываться к нему. Внешний сервис, которому нужна автоматическая синхронизация, должен получать строго ограниченный ключ отдельно, а не пароль от аккаунта.
Если отчёт неполный или отличается от кабинета
Проверьте, правильно ли выбраны спотовые сделки, деривативы и субаккаунты. Некоторые продукты имеют отдельную историю и отдельную выгрузку. Посмотрите ограничения по периоду и числу записей, статус сформированного отчёта, часовой пояс и включительность крайних дат. При расхождении скачайте один небольшой интервал и сравните конкретные строки. Если официальный экспорт не включает нужные данные, обратитесь в поддержку биржи с номером запроса, не раскрывая API secret.
Самостоятельная выгрузка оставляет контроль над доступом у владельца аккаунта. CSV удобен для фильтрации и локальной сверки, но требует аккуратности с временными зонами, комиссиями и приватностью. Проверяйте структуру файла, храните оригинал и передавайте только минимально необходимую копию доверенному получателю.
