Как импортировать историю сделок WEEX в Cryptact (для подачи криптоналоговой декларации в Японии)

Итог: в настоящее время WEEX не интегрирован в Cryptact автоматически (его нет в списке поддерживаемых Cryptact бирж, поэтому API-автосинхронизация и автоматический импорт файла недоступны). Чтобы использовать историю сделок с криптовалютой WEEX для расчёта прибыли и убытков в Cryptact, заполните универсальный «пользовательский файл» Cryptact — шаблон CSV/Excel из 10 столбцов — данными о сделках WEEX и загрузите его. В руководстве описаны (1) получение истории сделок из WEEX, (2) точный формат пользовательского файла Cryptact, (3) соответствие полей WEEX столбцам Cryptact, (4) разобранные примеры (все гипотетические) и (5) налоговый статус такой прибыли. Это только информационный материал, а не налоговая консультация. Уточните порядок налогообложения в вашем случае у лицензированного налогового специалиста (税理士) или в Национальном налоговом агентстве Японии.

Указанные здесь спецификации Cryptact и WEEX были проверены непосредственно по публичной документации обеих компаний (см. дату в конце страницы и факты в реестре). Спецификации могут измениться — всегда проверяйте актуальные официальные страницы перед началом работы. Между WEEX и Cryptact нет партнёрства. Cryptact упоминается исключительно фактически как один из широко используемых в Японии инструментов для расчёта налогов.

Зачем нужен «пользовательский файл»

Для поддерживаемых бирж Cryptact может получать историю через синхронизацию по API-ключу или автоматический импорт файла. Однако WEEX отсутствует в списке поддерживаемых Cryptact бирж (страница WEEX в Cryptact возвращает ошибку или не содержит записи; проверено 19.07.2026). Для неподдерживаемых бирж, а также для деривативов и маржинальных сделок Cryptact официально рекомендует универсальный пользовательский файл, который нужно заполнить самостоятельно. WEEX полностью относится к категории «неподдерживаемая биржа», поэтому пользовательский файл — подходящий способ.

Рабочий процесс (3 шага)

1. Получите историю сделок из WEEX (с экранов истории в приложении или на сайте либо через API).
2. Преобразуйте её в пользовательский файл Cryptact из 10 столбцов (используя таблицы соответствия ниже).
3. Загрузите файл в Cryptact как пользовательский файл.

Шаг 1. Получение истории сделок из WEEX

Реалистичные варианты зависят от объёма данных. На момент подготовки этого материала нам не удалось подтвердить наличие в WEEX официальной функции экспорта истории сделок в CSV одним нажатием (в Центре помощи такая статья не найдена; наличие или отсутствие кнопки экспорта на экранах торговли после входа не проверялось в рамках этого исследования). На практике остаются следующие варианты:

• Метод A — записать данные вручную с экранов истории в приложении или на сайте (лучший вариант для небольших объёмов). Используйте экраны истории ордеров, истории сделок и истории активов (средств) WEEX, перепишите дату и время исполнения, торговую пару, сторону, количество, цену и комиссию каждой сделки и внесите их в пользовательский файл.
• Метод B — получить данные через WEEX OpenAPI (лучше для больших объёмов и автоматизации). WEEX запустила OpenAPI (бета-версию) в марте 2026 года; историю можно прочитать с помощью ключа только для чтения и преобразовать в пользовательский файл. Основные конечные точки приведены ниже.

Конечные точки истории WEEX OpenAPI (только чтение)

Аутентификация использует подписанные заголовки (ACCESS-KEY / ACCESS-SIGN / ACCESS-PASSPHRASE / ACCESS-TIMESTAMP). Для конечных точек истории требуется разрешение USER_DATA (чтение), поэтому для получения истории достаточно API-ключа только для чтения (без разрешения на торговлю).

Данные об исполнениях фьючерсных сделок доступны за последние 365 дней, максимум за 7 дней в одном запросе; реестр доходов позволяет запрашивать период до 100 дней за один запрос. Все временные метки возвращаются в миллисекундах UTC (конвертация в JST рассматривается ниже).

Шаг 2. Формат пользовательского файла Cryptact (10 столбцов)

Пользовательский файл Cryptact содержит 10 столбцов (A–J) согласно официальной справочной статье Cryptact «Как создать пользовательский файл» (доступны для скачивания образцы Excel и CSV на японском и английском языках). Все столбцы, кроме «Комментария», обязательны.

Ключевые правила Cryptact (соблюдайте точно):

• Формат временной метки — YYYY/MM/DD HH:mm:ss.
• Комиссию необходимо указывать даже при значении 0 (пустая ячейка Fee вызывает ошибку загрузки).
• Автоматическая ссылка на цену: оставить Price пустым и позволить Cryptact подставить рыночную цену можно только тогда, когда Base — монета, поддерживаемая Cryptact, а Counter — фиатная валюта (например, JPY). Если базовая монета не поддерживается или контрвалюта является криптовалютой (например, USDT), необходимо указать цену самостоятельно.
• Не помещайте символы ' " \ в поле Comment (загрузка завершится ошибкой).
• Прямое открытие или редактирование CSV может повредить файл (появится кракозябры). Редактируйте файл согласно инструкциям Cryptact. Для значений с 15 и более знаками после запятой используйте специальный образец файла Cryptact.

Шаг 3. Соответствие полей WEEX столбцам Cryptact

WEEX — это биржа, ориентированная прежде всего на фьючерсы (деривативы). Фьючерсные (маржинальные) и спотовые сделки в Cryptact фиксируются по-разному, поэтому используйте соответствующую таблицу. Строки с пометками [ASSUMPTION] / [JUDGED] не указаны в исходных спецификациях — это вывод или рекомендация данного руководства; проверьте их перед использованием.

Соответствие (1): спотовые сделки

Источник: WEEX «Получение истории сделок» GET /api/v3/myTrades (или экран истории сделок). Для символа BTCUSDT разделите его на Base = BTC, Counter = USDT.

Соответствие (2): фьючерсы и деривативы (маржа)

Cryptact официально рекомендует для деривативов метод «учитывать только изменение маржи/залога». Фьючерсы WEEX имеют маржу в USDT, поэтому фиксируйте чистое изменение реализованного PnL в USDT: прибыль как BONUS, убыток как LOSS (ликвидация или принудительное закрытие, уменьшающее маржу, также отражается как LOSS). Получайте данные из WEEX «Получение деталей сделки», поля realizedPnl, или «Получение доходов аккаунта», поля income.

[СУЖДЕНИЕ / примечания] В таблице выше приведён рекомендованный Cryptact метод «только изменение маржи». Если вы фиксируете чистое изменение залога (после комиссий и финансирования), Fee можно указать как «0». Если вы хотите отражать комиссии и финансирование отдельными операциями, используйте разбивку по incomeType из раздела «Получение доходов аккаунта» (position_close_long / position_funding / order_fill_fee_income и т. д.), однако для большинства пользователей достаточно простого метода изменения маржи. Cryptact также описывает расширенный вариант: добавить в английский пользовательский файл столбцы DerivType = fx/future/option/cfd и DerivDetails, но сам по себе этот метод не отражает изменение криптовалютного залога, поэтому в большинстве случаев предпочтителен описанный выше простой метод.

Разобранные примеры (все цифры гипотетические)

Они иллюстрируют только формат и не являются реальными сделками или ценами.

Пример 1. Покупка BTC на споте (гипотетический пример)

«15.01.2026 (JST) куплено 0,01 BTC в паре BTC/USDT по цене 95 000 USDT; комиссия — 0,0951 USDT (гипотетически)».

Пример 2. Продажа BTC на споте (гипотетический пример)

«03.02.2026 (JST) продано 0,01 BTC в паре BTC/USDT по цене 98 000 USDT; комиссия — 0,098 USDT (гипотетически)».

Пример 3. Реализованный PnL по фьючерсам — прибыль (гипотетический пример)

«При расчёте по фьючерсам BTCUSDT маржа в USDT увеличилась на +30 USDT реализованной прибыли (гипотетически)».

Пример 4. Реализованный PnL по фьючерсам — убыток (гипотетический пример)

«При другом расчёте маржа в USDT уменьшилась на −18 USDT реализованного PnL, включая ликвидацию (гипотетически)».

Следите за конвертацией UTC → JST

API WEEX возвращает все временные метки в формате UTC. Японское стандартное время (JST) опережает UTC на 9 часов. В пользовательском файле Cryptact для столбца Timestamp часовой пояс явно не указывается, но поскольку Cryptact ведёт расчёты на основе JST, безопаснее переводить время WEEX из UTC в JST (+9 ч), чтобы строки WEEX совпадали с остальными данными по Японии (это рекомендация данного руководства, поскольку спецификация прямо этого не устанавливает). Например, исполнение в UTC в момент 2026-02-09 18:00:00 соответствует 2026/02/10 03:00:00 по JST. История зарубежных бирж обычно основана на UTC, а на границе года (31 декабря / 1 января) дата может сместиться на один день, поэтому особенно внимательно проверяйте сделки в конце года.

Налоговый статус (фактическое резюме)

Для резидента Японии прибыль от криптовалюты обычно классифицируется как «прочий доход» (雑所得) и облагается совокупным налогообложением (総合課税) — прибавляется к другим доходам, например к зарплате, и облагается прогрессивными ставками (вместе с местным налогом максимальная ставка может достигать примерно 55%). Торговля на зарубежной бирже не освобождает этот доход от налогообложения. В отличие от отечественных бирж, зарубежные площадки не выдают годовую выписку по операциям и используют временные метки UTC, поэтому необходимость самостоятельно хранить записи выше — именно поэтому точная история так важна.

• Записи имеют значение: если сохранять дату и время каждой сделки, символ, количество, цену, комиссию и реализованный PnL, подавать декларацию (обычно с середины февраля до середины марта) будет значительно проще.
• Использование расчётного инструмента: Cryptact (株式会社pafin) — один из японских инструментов для расчёта прибыли и убытков по криптовалютам; по данным компании, им пользуются более 200 000 человек. В этом руководстве он упоминается исключительно фактически; партнёрства или одобрения со стороны WEEX нет. Существуют и другие инструменты — выбирайте по своему усмотрению.
• Окончательное решение принимает специалист: порядок налогообложения конкретного человека (классификация, вычитаемые расходы, учёт убытков) зависит от обстоятельств. Всегда уточняйте его у лицензированного налогового специалиста (税理士) или в Национальном налоговом агентстве. Это не налоговая консультация.
• Открыть аккаунт WEEX

Торговля на WEEX (фокус на фьючерсах)

WEEX — криптовалютная биржа, ориентированная прежде всего на фьючерсы (деривативы). Фьючерсы и кредитное плечо увеличивают как прибыль, так и убытки, а резкое движение рынка может вызвать ликвидацию (принудительное закрытие), которое зафиксирует убыток. Перед торговлей изучите механику и риски. Получение истории и расчёт PnL выполняются по описанным выше шагам.

FAQ

Поддерживается ли WEEX в Cryptact автоматически?

На момент проверки (19.07.2026) WEEX отсутствует в списке поддерживаемых Cryptact бирж. Поэтому вместо API-автосинхронизации или автоматического импорта файла историю нужно импортировать через универсальный «пользовательский файл», который вы заполняете самостоятельно.

Есть ли в WEEX экспорт истории сделок в CSV одним нажатием?

В ходе исследования нам не удалось подтвердить наличие в WEEX официального экспорта истории сделок в CSV одним нажатием. На практике можно либо (1) вручную записать данные с экранов истории в приложении или на сайте (небольшие объёмы), либо (2) получить их через WEEX OpenAPI с ключом только для чтения. Проверьте текущие экраны после входа, чтобы узнать, есть ли кнопка экспорта.

Как учитывать PnL по фьючерсам (с кредитным плечом)?

Согласно рекомендованному Cryptact методу учитывайте только изменение маржи в USDT: прибыль отражайте как BONUS, убыток — как LOSS (включая ликвидацию), используя Base = USDT, Counter = JPY и оставляя Price пустым (см. соответствие (2)).

Нужно ли переводить время в JST?

Время в API WEEX указано в UTC. Поскольку Cryptact ведёт расчёты на основе JST, безопаснее переводить его в JST (+9 ч). Особенно внимательно проверяйте границу года, когда дата может сместиться на один день.

Что делать, если неизвестна валюта комиссии?

API истории спотовых сделок WEEX может не возвращать валюту комиссии. Проверьте в приложении, в какой валюте была списана комиссия (в полученной валюте, WXT и т. д.) и внесите её в FeeCcy. Даже если комиссии нет, в Fee укажите «0».

Этот материал предназначен только для информации и не является налоговой или инвестиционной консультацией. Уточните налоговый режим у лицензированного налогового специалиста (税理士) или в Национальном налоговом агентстве Японии. Между WEEX и Cryptact (株式会社pafin) нет партнёрства; название Cryptact и приведённые цифры цитируются фактически. Спецификации основаны на официальной документации обеих компаний (проверено 19.07.2026) и могут измениться — перепроверьте их перед началом работы. Фьючерсы и кредитное плечо несут риск увеличения убытков.