# Повний посібник з обліку криптовалют за допомогою Beancount.io

**Ви тонете в криптотранзакціях на численних біржах, боретеся зі складністю DeFi або панікуєте через податковий сезон?** Ви не самотні. Ландшафт криптовалют вибухнув від простих покупок біткойнів до складної екосистеми протоколів DeFi, винагород за стейкінг, прибуткового фермерства та крос-чейн активностей, які кидають виклик традиційним методам обліку.

Ось сувора реальність: **кожна криптотранзакція потенційно оподатковується**, і податкова служба (IRS) спостерігає. Незалежно від того, чи є ви звичайним власником біткойнів, чи досвідченим користувачем DeFi, який керує позиціями в десятках протоколів, ведення точних фінансових записів не є необов'язковим — це важливо для дотримання вимог та фінансової прозорості.

**Проблема?** Традиційне бухгалтерське програмне забезпечення має обмежену нативну підтримку складності криптовалют. Хоча такі інструменти, як QuickBooks, можуть працювати з криптовалютою за допомогою додаткових плагінів, а Excel може імпортувати дані блокчейну за допомогою скриптів, більшість рішень вимагають значної кастомізації для комплексного обліку криптовалют.

**Рішення?** Система обліку в текстовому форматі Beancount.io, побудована на потужній мові Beancount з відкритим вихідним кодом. **Важлива примітка**: Beancount — це мова бухгалтерського обліку з подвійним записом з відкритим вихідним кодом, створена Мартіном Бле (Martin Blais), тоді як Beancount.io — це комерційний хостинговий сервіс, який надає зручний інтерфейс та хмарну інфраструктуру для Beancount. Цей посібник охоплює як основні принципи Beancount, так і те, як ефективно використовувати їх через платформу Beancount.io.

## Кошмар бухгалтерського обліку криптовалют (і чому він погіршується)

### Ваш криптопортфель розкиданий всюди

Будьмо чесними щодо вашої ситуації. Ймовірно, у вас є:

- **3-5 різних бірж** (Coinbase для легких покупок, Binance для альткоїнів, Kraken для того одного токена...)
- **Кілька гаманців** (MetaMask для DeFi, Ledger для довгострокових утримань, той старий гаманець, про який ви забули...)
- **DeFi позиції на 10+ протоколах** (Uniswap, Compound, Aave та будь-яка нова дохідна ферма, що привернула вашу увагу)
- **Нагороди за стейкінг**, що надходять від різних валідаторів
- **Випадкові аірдропи**, що з'являються у вашому гаманці, наче крипторіздвяні подарунки

**Кожна платформа говорить різною мовою.** Coinbase надає вам CSV-файл, який зовсім не схожий на експорт Binance. Uniswap взагалі не має експорту. І навіть не починайте про відстеження ваших DeFi позицій у мережах другого рівня.

### Типи транзакцій, що кидають виклик традиційному бухгалтерському обліку

Ваша криптоактивність включає типи транзакцій, які традиційні системи бухгалтерського обліку спочатку не були розроблені для обробки:

- **Непостійна втрата** від надання ліквідності (спробуйте пояснити це QuickBooks)
- **Флеш-кредити**, що позичають і повертають мільйони в одній транзакції
- **Йілд-фармінг**, де ви заробляєте 5 різних токенів за надання ліквідності
- **Міжланцюгові мости**, які змушують активи зникати в одній мережі та з'являтися в іншій
- **Деривативи стейкінгу**, як-от stETH, які нараховують вартість інакше, ніж базовий актив
- **Токени управління DAO**, які ви отримали за використання протоколів

### Мінне поле податкової відповідності

Ось що не дає спати криптоінвесторам вночі:

- **Кожна окрема угода оподатковується** (так, навіть той обмін ETH на USDC)
- **Відстеження бази собівартості** стає неможливим при сотнях мікротранзакцій
- **Винагороди за стейкінг є доходом** у момент їх отримання (за справедливою ринковою вартістю)
- **Винагороди DeFi є доходом** навіть якщо ви ще не можете їх продати
- **IRS вимагає форму 8949** з переліком кожної окремої транзакції
- **Штрафи є суворими** за помилки

**Традиційне бухгалтерське програмне забезпечення вимагає значної кастомізації для такої складності.** Хоча рішення існують, вони часто вимагають додаткових плагінів, скриптів або ручних процесів для обробки повного обсягу криптовалютних операцій.

## Представляємо Beancount.io: Рішення для криптобухгалтерії, на яке ви чекали

**Що, якби я сказав вам, що існує бухгалтерська система, розроблена саме для цього хаосу?** Beancount.io — це не просто ще один інструмент для обліку — це **революція в текстовому обліку**, яка справляється зі складністю криптовалют, ніби була створена для цього.

### Чому Beancount.io домінує в криптобухгалтерії

**🔍 Повна прозорість**: Кожен розрахунок видимий. Жодних "чорних скриньок", жодних алгоритмів "довіртеся нам". Ви точно бачите, як розраховується ваша собівартість, як обчислюються прибутки та куди подівся кожен сатоші.

**📊 Необмежена гнучкість**: Створюйте будь-яку структуру рахунків, яка вам потрібна. Відстежуйте позиції DeFi, похідні інструменти стейкінгу, крос-чейн активи або той дивний токен, який ви отримали від голосування DAO. Якщо ви можете це уявити, ви можете це відстежити.

**🎯 Точна собівартість**: Відстеження за партіями з конкретною ідентифікацією. Вибирайте, який саме Біткойн ви продаєте для оптимальних податкових результатів. FIFO, LIFO або вибірковий вибір партій — ваш вибір.

**🔗 Перспективність**: Формат звичайного тексту означає, що ваші дані належать вам назавжди. Жодної прив'язки до постачальника, жодних пропрієтарних форматів, жодних електронних листів "вибачте, ми закриваємося".

**⚡ Потужність скриптів**: Автоматизуйте імпорт, генеруйте власні звіти та інтегруйтеся з будь-яким інструментом. Оскільки ваш криптопортфель унікальний, ваша бухгалтерія також має бути такою.

## Налаштування Вашого Криптовалютного Командного Центру

### Побудова архітектури ваших рахунків

Розглядайте це як проектування креслення для вашої криптоімперії. Ми створюємо структуру, яка може обробляти все: від вашої першої покупки Біткоїна до складних багатопротокольних DeFi-стратегій:

**Примітка**: У прикладах `1970-01-01` використовується як дата відкриття-заповнювач. Для фактичного використання замініть на ваші реальні дати відкриття рахунків, особливо якщо ви використовуєте автоматизовані інструменти імпорту, які фільтрують транзакції за датою.

```bean
; Exchange Accounts
1970-01-01 open Assets:Crypto:Coinbase:USD
1970-01-01 open Assets:Crypto:Coinbase:BTC
1970-01-01 open Assets:Crypto:Coinbase:ETH
1970-01-01 open Assets:Crypto:Binance:USD
1970-01-01 open Assets:Crypto:Binance:BTC
1970-01-01 open Assets:Crypto:Binance:ETH
1970-01-01 open Assets:Crypto:Binance:ADA

; Wallet Accounts
1970-01-01 open Assets:Crypto:Wallet:MetaMask:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:USDC
1970-01-01 open Assets:Crypto:Wallet:MetaMask:UNI
1970-01-01 open Assets:Crypto:Wallet:Ledger:BTC
1970-01-01 open Assets:Crypto:Wallet:Ledger:ETH

; DeFi Protocol Accounts
1970-01-01 open Assets:DeFi:Compound:CUSDC
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:Staking:Ethereum:ETH
1970-01-01 open Assets:Crypto:Mining:BTC

; Income Accounts
1970-01-01 open Income:Crypto:Staking:ETH
1970-01-01 open Income:Crypto:Mining:BTC
1970-01-01 open Income:Crypto:Airdrops
1970-01-01 open Income:Crypto:DeFi:Yield
1970-01-01 open Income:CapitalGains:Crypto
1970-01-01 open Income:Crypto:Trading:Margin

; Expense Accounts
1970-01-01 open Expenses:Crypto:Fees:Trading
1970-01-01 open Expenses:Crypto:Fees:Network
1970-01-01 open Expenses:Crypto:Fees:Withdrawal

; Additional accounts for advanced scenarios
1970-01-01 open Assets:Crypto:Binance:BTC-Margin
1970-01-01 open Liabilities:Crypto:Binance:Borrowed
1970-01-01 open Liabilities:Crypto:Binance:BTC
1970-01-01 open Assets:Checking
1970-01-01 open Expenses:Crypto:Mining:Electricity
```

### Визначення Комодітів

Визначте свої криптовалюти як комодіти з відповідними метаданими:

```bean
1970-01-01 commodity BTC
  name: "Bitcoin"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity ETH
  name: "Ethereum"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity ADA
  name: "Cardano"
  asset-class: "cryptocurrency"
  price-source: "binance"

1970-01-01 commodity USDC
  name: "USD Coin"
  asset-class: "stablecoin"
  price-source: "coinbase"

1970-01-01 commodity UNI
  name: "Uniswap"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity UNI-V2-ETH-USDC
  name: "Uniswap V2 ETH-USDC LP Token"
  asset-class: "liquidity-pool"
```

## Освоєння криптотранзакцій: від простих до складних

**Готові побачити Beancount.io в дії?** Давайте розглянемо реальні сценарії, з якими не впоралися б інші облікові системи, але які елегантно вирішуються тут.

### 1. Ваша перша покупка біткоїна (Вхідний квиток)

Кожна криптомандрівка починається з чогось. Ось як зафіксувати той момент, що змінює життя, коли ви придбали свій перший біткоїн:

```bean
2024-01-15 * "Купівля 0.5 BTC на Coinbase"
  Assets:Crypto:Coinbase:BTC     0.5 BTC {30000.00 USD}
  Assets:Crypto:Coinbase:USD  -15025.00 USD
  Expenses:Crypto:Fees:Trading    25.00 USD
```

### 2. Фіксація прибутку (або обмеження збитків) як професіонал

**Момент істини**: продаж вашої криптовалюти. Саме тут більшість бухгалтерських систем дають збій, але Beancount.io вирізняється точним відстеженням собівартості:

```bean
2024-03-20 * "Sell 0.3 BTC on Coinbase"
  Assets:Crypto:Coinbase:BTC    -0.3 BTC {30000.00 USD}
  Assets:Crypto:Coinbase:USD   10440.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Income:CapitalGains:Crypto  -1470.00 USD  ; 10470 - (0.3 × 30000) = 1470
```

### 3. Винагороди за стейкінг: Заробляйте, поки спите

**Пасивний дохід у найкращому вигляді.** Але пам'ятайте, Податкова служба США (IRS) вимагає повідомляти винагороди за стейкінг як оподатковуваний дохід при отриманні, на основі справедливої ринкової вартості на момент отримання (згідно з вказівками IRS щодо цифрових активів, 2024). Хоча триває судовий розгляд (Джарретт проти Сполучених Штатів), поточна офіційна позиція вимагає негайного звітування. Ось як їх правильно відстежувати:

```bean
2024-02-01 * "ETH Staking Rewards"
  Assets:Staking:Ethereum:ETH      0.05 ETH {2500.00 USD}
  Income:Crypto:Staking:ETH     -125.00 USD
```

### 4. DeFi-фермерство дохідності: Де стає цікаво 🌶️

**Ласкаво просимо до розширеного обліку в DeFi.** DeFi-фермерство дохідності включає складні багатотокенні транзакції, що вимагають ретельного відстеження. Ось як правильно обліковувати позицію ліквідності Uniswap:

```bean
; Initial liquidity provision
2024-01-10 * "Add liquidity to ETH-USDC pool"
  Assets:Crypto:Wallet:MetaMask:ETH    -10 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC -25000 USDC {1.00 USD}
  Assets:DeFi:Uniswap:ETH-USDC-LP     100 UNI-V2-ETH-USDC {500.00 USD}

; Claiming rewards
2024-02-10 * "Claim Uniswap LP rewards"
  Assets:Crypto:Wallet:MetaMask:UNI    50 UNI {8.00 USD}
  Income:Crypto:DeFi:Yield          -400.00 USD
```

### 5. Міжбіржові перекази

Переказ Біткоїна з Coinbase на гаманець Ledger:

```bean
2024-01-20 * "Переказ BTC з Coinbase на Ledger"
  Assets:Crypto:Coinbase:BTC      -1.0 BTC {30000.00 USD}
  Assets:Crypto:Wallet:Ledger:BTC  0.9995 BTC {30000.00 USD}
  Expenses:Crypto:Fees:Withdrawal  0.0005 BTC {30000.00 USD}
```

## Просунуті криптовалютні сценарії

### Маржинальна торгівля

**Довга позиція з кредитним плечем 2x** означає, що половину позиції ви фінансуєте самі, а другу половину позичаєте. Тут 17 500 USD власної застави плюс маржинальний кредит на 17 500 USD купують 1,0 BTC за 35 000 USD. Кредит — це зобов'язання, а не дохід: позичені гроші не роблять вас багатшими, а його погашення — не витрата. Тому прибуток або збиток дає лише зміна ціни партії BTC:

```bean
; Відкриття довгої позиції з кредитним плечем 2x: власна застава в USD плюс маржинальний кредит в USD купують BTC
2024-02-15 * "Відкриття довгої позиції BTC з плечем 2x за рахунок маржинального кредиту в USD"
  Assets:Crypto:Binance:BTC-Margin         1.0 BTC {35000.00 USD}
  Assets:Crypto:Binance:USD           -17550.00 USD  ; застава + комісія
  Liabilities:Crypto:Binance:Borrowed -17500.00 USD
  Expenses:Crypto:Fees:Trading            50.00 USD

; Закриття довгої позиції: продаж партії BTC і погашення маржинального кредиту з виручки
2024-02-20 * "Продаж BTC з плечем і погашення маржинального кредиту"
  Assets:Crypto:Binance:BTC-Margin        -1.0 BTC {35000.00 USD} @ 38000.00 USD
  Liabilities:Crypto:Binance:Borrowed  17500.00 USD
  Assets:Crypto:Binance:USD            20450.00 USD
  Expenses:Crypto:Fees:Trading            50.00 USD
  Income:CapitalGains:Crypto           -3000.00 USD  ; 38000 - 35000 = 3000
```

Розрахунок рядок за рядком:

- **Реалізований прибуток**: 38 000 − 35 000 = 3 000 USD за партією 1,0 BTC — удвічі більше за ті 1 500 USD, які ті самі 17 500 USD принесли б при купівлі 0,5 BTC без плеча.
- **Повернені грошові кошти**: 38 000 USD виручки − 17 500 USD погашення кредиту − 50 USD комісії = 20 450 USD.
- **Чистий результат**: 20 450 − 17 550 = 2 900 USD, тобто прибуток 3 000 USD за вирахуванням двох торгових комісій по 50 USD.

Плече так само збільшує збитки: продаж за 32 000 USD відобразив би втрату капіталу в розмірі 3 000 USD за тієї самої застави в 17 500 USD. Якщо біржа нараховує відсотки за кредитом, відображайте їх окремою проводкою витрат, як і комісії, — і ніколи не включайте їх у залишок кредиту чи в прибуток.

### Ейрдропи та Форки

Облік безкоштовних розподілів токенів:

```bean
2024-03-01 * "Received UNI airdrop"
  Assets:Crypto:Wallet:MetaMask:UNI   400 UNI {8.00 USD}
  Income:Crypto:Airdrops            -3200.00 USD
```

### Майнінгові операції

Для майнерів криптовалют:

```bean
2024-01-01 * "Bitcoin mining reward"
  Assets:Crypto:Mining:BTC    0.1 BTC {45000.00 USD}
  Income:Crypto:Mining:BTC  -4500.00 USD

; Mining expenses
2024-01-31 * "Mining electricity costs"
  Expenses:Crypto:Mining:Electricity  800.00 USD
  Assets:Checking                    -800.00 USD
```

## Податкова звітність та дотримання вимог

### Відстеження собівартості

Beancount.io автоматично відстежує собівартість, використовуючи систему партій:

```bean
; Multiple purchases at different prices
2024-01-01 * "Buy BTC batch 1"
  Assets:Crypto:Coinbase:BTC  1.0 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD -40000.00 USD

2024-02-01 * "Buy BTC batch 2"
  Assets:Crypto:Coinbase:BTC  1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD -45000.00 USD

; Selling specific lots (FIFO, LIFO, or specific identification)
2024-03-01 * "Sell BTC using FIFO"
  Assets:Crypto:Coinbase:BTC    -0.5 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD   22440.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Income:CapitalGains:Crypto   -2470.00 USD  ; 22470 - 20000 = 2470
```

### Генерування податкових звітів

Використовуйте систему запитів Beancount та плагіни для генерування податкових звітів:

- **Форма 8949**: Приріст та втрати капіталу (за допомогою bean-query або сторонніх плагінів)
- **Додаток D**: Зведення приросту капіталу (потребує додаткових скриптів)
- **Форма 1040**: Дохід від стейкінгу, майнінгу, аірдропів (за допомогою користувацьких звітів)
- **Детальні журнали транзакцій**: Для аудиту

**Примітка**: Генерування податкових звітів вимагає додаткових плагінів, скриптів або інтеграції зі спеціалізованим податковим програмним забезпеченням. Beancount надає основу даних, але конкретні податкові форми зазвичай вимагають власної розробки або сторонніх інструментів.

## Найкращі практики для обліку криптовалют

### 1. Регулярна звірка

- Імпортувати дані обміну щотижня
- Перевіряти баланси гаманців щомісяця
- Перехресно звіряти з блокчейн-експлорерами

### 2. Належна Документація

- Зберігайте всі підтвердження транзакцій
- Документуйте мету кожної транзакції
- Ведіть облік ринкових цін на момент транзакції

### 3. Розділяйте бізнес та особисті фінанси

```bean
; Personal crypto investments
Assets:Personal:Crypto:Coinbase:BTC

; Business crypto operations
Assets:Business:Crypto:Treasury:BTC
```

### 4. Облік усіх джерел доходу

- Винагороди за стейкінг (оподатковується як дохід)
- Винагороди за майнінг (оподатковується як дохід)
- Еірдропи (оподатковується за справедливою ринковою вартістю)
- Дохід від DeFi (оподатковується як дохід)

### 5. Облік комісій

Обліковуйте всі комісії окремо для належного податкового вирахування:

```bean
Expenses:Crypto:Fees:Trading     ; Exchange trading fees
Expenses:Crypto:Fees:Network     ; Blockchain network fees
Expenses:Crypto:Fees:Withdrawal  ; Withdrawal fees
```

## Інтеграція з Популярними Криптоінструментами

### Інтеграція з API бірж

Beancount.io може інтегруватися з основними біржами:

- **Coinbase Pro API**: Автоматичний імпорт транзакцій
- **Binance API**: Оновлення балансу в реальному часі
- **Kraken API**: Синхронізація історичних даних

### Аналіз блокчейну

Підключіться до оглядачів блокчейнів:

- **Etherscan**: перевірка транзакцій Ethereum
- **Blockchain.info**: відстеження транзакцій Bitcoin
- **BscScan**: моніторинг Binance Smart Chain

### Відстеження Портфоліо

Синхронізація з інструментами управління портфоліо:

- **CoinTracker**: Генерація податкових звітів
- **Koinly**: Агрегація з багатьох бірж
- **Blockfolio**: Мобільне відстеження портфоліо

## Важливі застереження

**Податкове та юридичне застереження**: Цей посібник надає загальну інформацію про облік криптовалют за допомогою Beancount і не є професійною податковою, юридичною чи фінансовою консультацією. Податковий режим криптовалютних транзакцій відрізняється залежно від юрисдикції та індивідуальних обставин. Складні сценарії, такі як крос-чейн мости, непостійні втрати та флеш-кредити, можуть мати нечіткі податкові наслідки згідно з чинними нормативними актами. Для отримання конкретних вказівок щодо того, чи є транзакції оподатковуваними відчуженнями, зверніться до IRS FAQ Q-15 – Q-18 (2024) або проконсультуйтеся з місцевими податковими нормативними актами. Завжди консультуйтеся з кваліфікованим податковим фахівцем або дипломованим бухгалтером (CPA), який знайомий з оподаткуванням криптовалют у вашій юрисдикції, перш ніж приймати рішення, пов'язані з податками.

**Роз'яснення щодо програмного забезпечення**: Приклади в цьому посібнику використовують стандартний синтаксис Beancount. Хоча Beancount.io надає зручний інтерфейс для Beancount, основні принципи бухгалтерського обліку застосовуються до будь-якої реалізації Beancount.

## Висновок

Облік криптовалют не має бути надмірним. Завдяки потужній системі обліку в текстовому форматі Beancount, доступній через платформу Beancount.io, ви можете:

- **Забезпечити повну прозорість**: Кожна транзакція є видимою та піддається аудиту
- **Забезпечити податкову відповідність**: Належне відстеження собівартості та звітність про доходи
- **Масштабувати з вашим портфелем**: Обробляти від простих угод до складних DeFi-стратегій
- **Безперешкодно інтегрувати**: Підключатися до бірж, гаманців та податкових інструментів
- **Захистити ваші записи на майбутнє**: Текстовий формат забезпечує довгострокову доступність

Незалежно від того, чи є ви звичайним власником біткоїнів, чи досвідченим DeFi-фермером, Beancount надає основу та гнучкість, необхідні для опанування обліку криптовалют. Почніть з базових транзакцій і поступово включайте складніші сценарії в міру розвитку вашого крипто-шляху.

Приклади в цьому посібнику забезпечують міцну основу, але пам'ятайте, що облік криптовалют є сферою, що постійно розвивається. Будьте в курсі регуляторних змін, консультуйтеся з податковими фахівцями та адаптуйте свої облікові практики за потреби.

Ознайомтесь з живим прикладом криптовалютної книги:

<LedgerEmbed
  username="open_ledger"
  ledger="crypto-example"
  page=""
  title="Cryptocurrency Example Ledger"
/>
