Интеграция TokenTax: налоговая отчётность для DeFi и NFT

Интеграция TokenTax для сложной налоговой отчётности

Вы торгуете DeFi, фармите ликвидность, участвуете в AMM-пулах Uniswap V2/V3, Curve, Balancer и получаете токены в разных L2 сетях (Arbitrum, Optimism, Base). К концу года разобрать движение сотен тысяч транзакций вручную — невозможно. TokenTax — один из немногих сервисов, который переваривает LP группировку, софт-форки и сложные DeFi-операции. Но его интеграция требует точного маппинга данных и понимания налоговых категорий (Trade, Income, Mining и т.д.). Мы помогаем настроить кастомный экспорт из вашей инфраструктуры в TokenTax, чтобы отчётность формировалась за пару кликов.

Наши инженеры имеют многолетний опыт в интеграциях с крипто-налоговыми сервисами и работали с сотнями DeFi-протоколов. Стоимость интеграции рассчитывается индивидуально, а экономия на бухгалтерских услугах может быть значительной.

TokenTax поддерживает несколько форматов импорта. Для кастомных интеграций чаще всего используют Generic CSV или JSON API. Каждый формат имеет свои ниши. Generic CSV подходит для быстрого старта и одноразового импорта, но не позволяет автоматизировать синхронизацию. JSON API требует настройки ключей и лимит запросов, но позволяет обрабатывать миллионы транзакций без ручного вмешательства. Наше решение в 10 раз быстрее типовых интеграций за счёт готовых конвертеров. Подробнее о форматах можно узнать в официальной документации TokenTax.

Generic CSV — наиболее гибкий вариант. Мы подготовили шаблон с полным набором полей. Интерфейс TokenTaxRow позволяет точно сопоставить типы транзакций.

interface TokenTaxRow { type: "Trade" | "Income" | "Mining" | "Gift" | "Expense" | "Transfer"; buyAmount: string; buyCurrency: string; sellAmount: string; sellCurrency: string; feeAmount: string; feeCurrency: string; exchange: string; group: string; // для группировки связанных транзакций comment: string; date: string; // "YYYY-MM-DD HH:mm:ss" } function exportToTokenTaxCSV(transactions: InternalTransaction[]): string { const headers = [ "Type", "BuyAmount", "BuyCurrency", "SellAmount", "SellCurrency", "FeeAmount", "FeeCurrency", "Exchange", "Group", "Comment", "Date" ]; const rows = transactions.map(tx => [ mapToTokenTaxType(tx.taxCategory), tx.amountIn?.toString() ?? "", tx.assetIn ?? "", tx.amountOut?.toString() ?? "", tx.assetOut ?? "", tx.feeAmount?.toString() ?? "", tx.feeCurrency ?? "", tx.source ?? "", tx.groupId ?? "", // объединять LP операции в группы tx.notes ?? "", format(tx.timestamp, "yyyy-MM-dd HH:mm:ss"), ].join(",")); return [headers.join(","), ...rows].join("\n"); } function mapToTokenTaxType(category: TaxCategory): string { const typeMap: Record<TaxCategory, string> = { [TaxCategory.SWAP]: "Trade", [TaxCategory.BUY]: "Trade", [TaxCategory.SELL]: "Trade", [TaxCategory.STAKING_REWARD]: "Income", [TaxCategory.AIRDROP]: "Income", [TaxCategory.MINING_REWARD]: "Mining", [TaxCategory.TRANSFER]: "Transfer", [TaxCategory.GAS_FEE]: "Expense", }; return typeMap[category] || "Trade"; } 

Почему важна правильная группировка DeFi-транзакций?

При добавлении ликвидности в Uniswap V3 вы отдаёте два токена и получаете один LP. Без группировки TokenTax увидит две продажи (token0 и token1) и одну покупку LP — это сгенерирует фиктивную реализованную прибыль. Решение — объединить связанные строки через поле Group. Мы реализовали функцию exportLPOperationAsGroup, которая создаёт две записи с одинаковым Group ID.

function exportLPOperationAsGroup( lpDeposit: LiquidityDepositEvent, groupId: string ): TokenTaxRow[] { // Два токена отдали → LP токен получили return [ { type: "Trade", buyAmount: lpDeposit.lpTokenAmount.toString(), buyCurrency: `${lpDeposit.token0}-${lpDeposit.token1}-LP`, sellAmount: lpDeposit.token0Amount.toString(), sellCurrency: lpDeposit.token0, feeAmount: "", feeCurrency: "", exchange: "Uniswap", group: groupId, comment: "LP deposit token0", date: format(lpDeposit.timestamp, "yyyy-MM-dd HH:mm:ss"), }, { type: "Trade", buyAmount: "", buyCurrency: "", sellAmount: lpDeposit.token1Amount.toString(), sellCurrency: lpDeposit.token1, feeAmount: lpDeposit.gasUSD?.toString() ?? "", feeCurrency: "USD", exchange: "Uniswap", group: groupId, comment: "LP deposit token1", date: format(lpDeposit.timestamp, "yyyy-MM-dd HH:mm:ss"), }, ]; } 

Как интеграция TokenTax ускоряет отчётность?

Интеграция через API сокращает время формирования отчёта в 5 раз по сравнению с ручным CSV-импортом. Для портфеля из 100 000 транзакций ручная обработка занимает до недели, автоматизированная — менее дня.

Что входит в работу по интеграции TokenTax?

Мы предоставляем полностью рабочее решение под ключ:

• Анализ исходных данных: изучаем схему ваших транзакций, кастомные контракты, типичные DeFi-операции.
• Разработка конвертера в Generic CSV или JSON API на TypeScript или Python (ваш выбор стека).
• Реализация группировки: для LP-транзакций, yield farming, multihop swapp-ов.
• Обработка edge case: эйрдропы, софт-форки, рефанды газа.
• Документация по эксплуатации интеграции.
• Тестирование: на исторических данных за последние 12 месяцев (до 100 000 транзакций).
• Обучение вашего бухгалтера загрузке и проверке отчётов.
• Месяц поддержки после внедрения.

Как мы это делаем: процесс работы

1. Аналитика (1 день): вы предоставляете выборку транзакций (JSON/CSV), мы выявляем нестандартные паттерны.
2. Проектирование (1 день): составляем маппинг категорий, формат экспорта, схему группировок.
3. Реализация (2-4 дня): пишем конвертер, покрывая 100% ваших типов операций.
4. Тестирование (1 день): запускаем на полной истории, сверяем отчёт TokenTax с ручным расчётом.
5. Деплой (несколько часов): настраиваем автоматический запуск раз в месяц (через cron или по API).

Сроки и стоимость

Стандартная интеграция (CSV-экспорт, до 10 типов транзакций) — от 2 до 4 рабочих дней. Комплексные проекты (REST API, много сетей, миллионы записей) — до 2 недель. Точную оценку даём после аудита ваших данных. Свяжитесь с нами, чтобы получить консультацию. Стоимость рассчитывается индивидуально в зависимости от объёма и сложности. Гарантируем полную поддержку на этапе внедрения и 30 дней бесплатной помощи после завершения. Закажите интеграцию прямо сейчас, чтобы получить готовый конвертер для TokenTax.

Почему выбирают нас?

У наших инженеров более 5 лет опыта в блокчейн-разработке и интеграциях с крипто-налоговыми сервисами. Мы успешно реализовали интеграции для DeFi-протоколов, NFT-маркетплейсов и prop trading фирм. Каждая интеграция сопровождается документацией и обучением команды клиента. Наше решение в 10 раз быстрее типовых интеграций. Получите консультацию по вашей интеграции.