Інтеграція 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 | Швидкий старт, одноразовий імпорт | Нема пакетної обробки, ручне завантаження |
| JSON API | Автоматична синхронізація, великі обсяги | Потрібен API-ключ, ліміт запитів на годину |
| Direct exchange import | Підтримка 80+ бірж (Binance, Coinbase) | Не покриває кастомні контракти та DeFi |
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 транзакцій ручна обробка займає до тижня, автоматизована — менше дня.
Приклад порівняння часу
| Метод звітності | Час на 10 000 транзакцій | Ймовірність помилки |
|---|---|---|
| Ручний Excel | 40–80 годин | 15–25% |
| TokenTax з інтеграцією | 2–4 години | <1% |
Що входить в роботу з інтеграції TokenTax?
Ми надаємо повністю робоче рішення під ключ:
- Аналіз вихідних даних: вивчаємо схему ваших транзакцій, кастомні контракти, типові DeFi-операції.
- Розробка конвертера в Generic CSV або JSON API на TypeScript або Python (ваш вибір стеку).
- Реалізація групування: для LP-транзакцій, yield farming, multihop swapp-ів.
- Обробка edge case: ейрдропи, софт-форки, рефанди газу.
- Документація з експлуатації інтеграції.
- Тестування: на історичних даних за останні 12 місяців (до 100 000 транзакцій).
- Навчання вашого бухгалтера завантаженню та перевірці звітів.
- Місяць підтримки після впровадження.
Як ми це робимо: процес роботи
- Аналітика (1 день): ви надаєте вибірку транзакцій (JSON/CSV), ми виявляємо нестандартні патерни.
- Проектування (1 день): складаємо маппінг категорій, формат експорту, схему групувань.
- Реалізація (2-4 дні): пишемо конвертер, покриваючи 100% ваших типів операцій.
- Тестування (1 день): запускаємо на повній історії, звіряємо звіт TokenTax з ручним розрахунком.
- Деплой (кілька годин): налаштовуємо автоматичний запуск раз на місяць (через cron або по API).
Терміни та вартість
Стандартна інтеграція (CSV-експорт, до 10 типів транзакцій) — від 2 до 4 робочих днів. Комплексні проекти (REST API, багато мереж, мільйони записів) — до 2 тижнів. Точну оцінку даємо після аудиту ваших даних. Зв'яжіться з нами, щоб отримати консультацію. Вартість розраховується індивідуально залежно від обсягу та складності. Гарантуємо повну підтримку на етапі впровадження та 30 днів безкоштовної допомоги після завершення. Замовте інтеграцію прямо зараз, щоб отримати готовий конвертер для TokenTax.
Чому обирають нас?
У наших інженерів понад 5 років досвіду в блокчейн-розробці та інтеграціях з крипто-податковими сервісами. Ми успішно реалізували інтеграції для DeFi-протоколів, NFT-маркетплейсів та prop trading фірм. Кожна інтеграція супроводжується документацією та навчанням команди клієнта. Наше рішення в 10 разів швидше типових інтеграцій. Отримайте консультацію щодо вашої інтеграції.