ردیابی پورتفولیوی ارزهای دیجیتال با Beancount.io

مدیریت یک پورتفولیوی ارز دیجیتال در صرافی‌های متعدد، کیف پول‌ها و پروتکل‌های دیفای (DeFi) می‌تواند چالش‌برانگیز باشد. این راهنمای جامع به شما نشان می‌دهد که چگونه با استفاده از سیستم حسابداری متن‌باز قدرتمند Beancount.io، ردیابی دقیق پورتفولیوی ارزهای دیجیتال را راه‌اندازی و نگهداری کنید.

چرا ردیاب‌های سنتی پورتفولیو ناکارآمد هستند

مشکلات رایج با ابزارهای پورتفولیوی ارز دیجیتال

• پشتیبانی محدود از صرافی‌ها: بسیاری از ابزارها از همه صرافی‌ها یا پروتکل‌های دیفای پشتیبانی نمی‌کنند.
• مبنای هزینه نادرست: محاسبات ساده‌شده FIFO/LIFO سناریوهای پیچیده را در نظر نمی‌گیرند.
• تراکنش‌های از قلم افتاده: محدودیت‌های API و شکاف‌های ورود دستی
• عدم سفارشی‌سازی: دسته‌بندی‌ها و ساختارهای گزارش‌دهی ثابت
• نگرانی‌های مربوط به حریم خصوصی: به اشتراک گذاری کلیدهای API با خدمات شخص ثالث
• وابستگی به فروشنده: فرمت‌های داده اختصاصی و گزینه‌های صادرات محدود

مزایای Beancount.io

• کنترل کامل: مالکیت داده‌های خود در قالب متن ساده
• سفارشی‌سازی نامحدود: ایجاد هر ساختار حساب مورد نیاز
• مبنای هزینه دقیق: ردیابی مبتنی بر لات (Lot) با شناسایی خاص
• پشتیبانی از چند پروتکل: رسیدگی به هر صرافی، کیف پول یا پروتکل دیفای
• محاسبات شفاف: مشاهده دقیق نحوه محاسبه اعداد
• مقاوم در برابر آینده: فرمت متن ساده دسترسی بلندمدت را تضمین می‌کند

راه‌اندازی ساختار پورتفولیوی ارز دیجیتال شما

سلسله مراتب حساب پایه

با یک ساختار حساب جامع شروع کنید که منعکس‌کننده اکوسیستم رمزنگاری شما باشد:

; حساب‌های صرافی - سازماندهی شده بر اساس پلتفرم
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:Coinbase:ADA

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:BNB

1970-01-01 open Assets:Crypto:Kraken:USD
1970-01-01 open Assets:Crypto:Kraken:BTC
1970-01-01 open Assets:Crypto:Kraken:ETH

; حساب‌های کیف پول - سازماندهی شده بر اساس نوع
1970-01-01 open Assets:Crypto:Wallet:Ledger:BTC
1970-01-01 open Assets:Crypto:Wallet:Ledger:ETH
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:TrustWallet:BNB

; حساب‌های پروتکل دیفای
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:DeFi:Compound:cUSDC
1970-01-01 open Assets:Staking:Ethereum:ETH
1970-01-01 open Assets:Staking:Cardano:ADA

; ردیابی درآمد
1970-01-01 open Income:Crypto:Staking:ETH
1970-01-01 open Income:Crypto:Staking:ADA
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 Expenses:Crypto:Fees:Trading
1970-01-01 open Expenses:Crypto:Fees:Network
1970-01-01 open Expenses:Crypto:Fees:Withdrawal

تعاریف کالا با فراداده (Metadata)

ارزهای دیجیتال خود را با فراداده غنی برای ردیابی بهتر تعریف کنید:

1970-01-01 commodity BTC
  name: "Bitcoin"
  asset-class: "cryptocurrency"
  sector: "digital-currency"
  price-source: "coinbase"
  website: "https://bitcoin.org"

1970-01-01 commodity ETH
  name: "Ethereum"
  asset-class: "cryptocurrency"
  sector: "smart-contract-platform"
  price-source: "coinbase"
  website: "https://ethereum.org"

1970-01-01 commodity ADA
  name: "Cardano"
  asset-class: "cryptocurrency"
  sector: "smart-contract-platform"
  price-source: "binance"
  website: "https://cardano.org"

1970-01-01 commodity DOT
  name: "Polkadot"
  asset-class: "cryptocurrency"
  sector: "interoperability"
  price-source: "kraken"
  website: "https://polkadot.network"

ردیابی پورتفولیوی چند صرافی

ثبت خریدها در صرافی‌های مختلف

ردیابی یک ارز دیجیتال یکسان در صرافی‌های مختلف با مبنای هزینه دقیق:

; خریدهای بیت کوین در صرافی‌های مختلف
2024-01-15 * "Buy BTC on Coinbase"
  Assets:Crypto:Coinbase:BTC      1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD  -45000.00 USD
  Expenses:Crypto:Fees:Trading    50.00 USD
  Assets:Crypto:Coinbase:USD     -50.00 USD

2024-01-20 * "Buy BTC on Binance"
  Assets:Crypto:Binance:BTC       0.5 BTC {46000.00 USD}
  Assets:Crypto:Binance:USD   -23000.00 USD
  Expenses:Crypto:Fees:Trading    25.00 USD
  Assets:Crypto:Binance:USD      -25.00 USD

2024-01-25 * "Buy BTC on Kraken"
  Assets:Crypto:Kraken:BTC        0.8 BTC {44000.00 USD}
  Assets:Crypto:Kraken:USD    -35200.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Assets:Crypto:Kraken:USD       -30.00 USD

نقل و انتقالات بین صرافی‌ها

ردیابی نقل و انتقالات بین صرافی‌ها ضمن حفظ مبنای هزینه:

2024-02-01 * "Transfer BTC from Coinbase to Ledger"
  Assets:Crypto:Coinbase:BTC      -0.5 BTC {45000.00 USD}
  Assets:Crypto:Wallet:Ledger:BTC  0.5 BTC {45000.00 USD}
  Expenses:Crypto:Fees:Withdrawal  0.0005 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:BTC      -0.0005 BTC {45000.00 USD}

فرصت‌های آربیتراژ

ردیابی معاملات آربیتراژ بین صرافی‌ها:

2024-02-10 * "Arbitrage: Buy ETH on Binance, Sell on Coinbase"
  ; Buy on Binance
  Assets:Crypto:Binance:ETH       10 ETH {2500.00 USD}
  Assets:Crypto:Binance:USD   -25000.00 USD
  Expenses:Crypto:Fees:Trading    25.00 USD
  Assets:Crypto:Binance:USD      -25.00 USD
  
  ; Sell on Coinbase (higher price)
  Assets:Crypto:Coinbase:ETH     -10 ETH {2500.00 USD}
  Assets:Crypto:Coinbase:USD   25800.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Assets:Crypto:Coinbase:USD     -30.00 USD
  Income:Crypto:Arbitrage       745.00 USD

مدیریت پیشرفته مبنای هزینه

ردیابی مبتنی بر لات

سیستم مبتنی بر لات Beancount.io ردیابی دقیق مبنای هزینه را فراهم می‌کند:

; خریدهای متعدد با قیمت‌های مختلف
2024-01-01 * "BTC Purchase Lot 1"
  Assets:Crypto:Coinbase:BTC  1.0 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD -40000.00 USD

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

2024-03-01 * "BTC Purchase Lot 3"
  Assets:Crypto:Coinbase:BTC  1.0 BTC {50000.00 USD}
  Assets:Crypto:Coinbase:USD -50000.00 USD

روش شناسایی خاص

فروش لات‌های خاص برای مدیریت مالیات بهینه:

; فروش بالاترین لات مبنای هزینه ابتدا (برداشت زیان مالیاتی)
2024-04-01 * "Sell BTC Lot 3 for tax optimization"
  Assets:Crypto:Coinbase:BTC    -1.0 BTC {50000.00 USD}
  Assets:Crypto:Coinbase:USD   48000.00 USD
  Expenses:Crypto:Fees:Trading    50.00 USD
  Assets:Crypto:Coinbase:USD     -50.00 USD
  Expenses:CapitalLoss:Crypto   2000.00 USD  ; Realized loss

ردیابی FIFO در مقابل LIFO

پیاده سازی روش‌های مختلف مبنای هزینه:

; فروش FIFO (First In, First Out)
2024-05-01 * "FIFO Sale - Sell oldest BTC first"
  Assets:Crypto:Coinbase:BTC    -0.5 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD   26000.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Assets:Crypto:Coinbase:USD     -30.00 USD
  Income:CapitalGains:Crypto    6000.00 USD  ; 52000 - 20000 = 6000

; فروش LIFO (Last In, First Out) - در صورت استفاده از روش متفاوت
2024-05-01 * "LIFO Sale - Sell newest BTC first"
  Assets:Crypto:Coinbase:BTC    -0.5 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD   26000.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Assets:Crypto:Coinbase:USD     -30.00 USD
  Income:CapitalGains:Crypto    3500.00 USD  ; 26000 - 22500 = 3500

تجزیه و تحلیل عملکرد پورتفولیو

راه‌اندازی ردیابی قیمت

راه‌اندازی فیدهای قیمت‌گذاری خودکار برای ارزش‌گذاری دقیق:

; به‌روزرسانی‌های روزانه قیمت
2024-01-15 price BTC 45000.00 USD
2024-01-15 price ETH 2500.00 USD
2024-01-15 price ADA 0.50 USD

2024-01-16 price BTC 46000.00 USD
2024-01-16 price ETH 2550.00 USD
2024-01-16 price ADA 0.52 USD

ردیابی تخصیص پورتفولیو

از ویژگی‌های گزارش‌دهی Beancount.io برای تجزیه و تحلیل تخصیص استفاده کنید:

; Query for portfolio allocation by asset
SELECT 
  account, 
  sum(position) as balance,
  value(sum(position)) as market_value
WHERE account ~ "Assets:Crypto"
GROUP BY 1
ORDER BY market_value DESC

معیارهای عملکرد

پیگیری شاخص‌های کلیدی عملکرد:

; Total portfolio value query
SELECT 
  sum(value(position)) as total_portfolio_value
WHERE account ~ "Assets:Crypto"

; Realized gains/losses
SELECT 
  sum(position) as realized_gains
WHERE account ~ "Income:CapitalGains:Crypto"

یکپارچه‌سازی استیکینگ و دیفای

ردیابی جوایز استیکینگ

ثبت جوایز استیکینگ با شناسایی درآمد مناسب:

2024-01-31 * "ETH Staking Rewards - January"
  Assets:Staking:Ethereum:ETH     0.08 ETH {2500.00 USD}
  Income:Crypto:Staking:ETH     200.00 USD

2024-01-31 * "ADA Staking Rewards - January"
  Assets:Staking:Cardano:ADA      25 ADA {0.50 USD}
  Income:Crypto:Staking:ADA      12.50 USD

ردیابی بازده دیفای

پیگیری موقعیت‌های پیچیده دیفای:

2024-02-01 * "Uniswap LP Position"
  Assets:Crypto:Wallet:MetaMask:ETH    -10 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC -25000 USDC
  Assets:DeFi:Uniswap:ETH-USDC-LP      100 UNI-V2-ETH-USDC {500.00 USD}

2024-02-28 * "Uniswap LP Rewards - February"
  Assets:Crypto:Wallet:MetaMask:UNI    50 UNI {8.00 USD}
  Income:Crypto:DeFi:Yield           400.00 USD

مدیریت خودکار پورتفولیو

راه‌اندازی یکپارچه‌سازی API

اتصال به APIهای صرافی برای وارد کردن خودکار داده‌ها:

# Example configuration for exchange API integration
exchanges:
  coinbase:
    api_key: "your_api_key"
    api_secret: "your_api_secret"
    passphrase: "your_passphrase"
  binance:
    api_key: "your_api_key"
    api_secret: "your_api_secret"

تطبیق خودکار

تنظیم تایید خودکار موجودی:

; Balance assertions for automated verification
2024-01-31 balance Assets:Crypto:Coinbase:BTC    2.5 BTC
2024-01-31 balance Assets:Crypto:Binance:ETH    15.0 ETH
2024-01-31 balance Assets:Crypto:Kraken:ADA   1000.0 ADA

اتوماسیون فید قیمت

پیکربندی به‌روزرسانی‌های خودکار قیمت:

; Price feed configuration
plugin "beancount.plugins.auto_accounts"
plugin "beancount.plugins.forecast"

; Automated price fetching
2024-01-01 custom "price-source" BTC "coinbase"
2024-01-01 custom "price-source" ETH "coinbase"
2024-01-01 custom "price-source" ADA "binance"

استراتژی‌های بهینه‌سازی مالیات

برداشت زیان مالیاتی

پیاده سازی سیستماتیک برداشت زیان مالیاتی:

; Identify positions with unrealized losses
2024-12-15 * "Tax loss harvesting - Sell ADA at loss"
  Assets:Crypto:Binance:ADA      -1000 ADA {0.60 USD}
  Assets:Crypto:Binance:USD       450.00 USD
  Expenses:Crypto:Fees:Trading      5.00 USD
  Assets:Crypto:Binance:USD        -5.00 USD
  Expenses:CapitalLoss:Crypto     150.00 USD  ; Realized loss

; Repurchase after wash sale period (31 days)
2025-01-16 * "Repurchase ADA after wash sale period"
  Assets:Crypto:Binance:ADA      1000 ADA {0.45 USD}
  Assets:Crypto:Binance:USD     -450.00 USD
  Expenses:Crypto:Fees:Trading     5.00 USD
  Assets:Crypto:Binance:USD       -5.00 USD

سودهای بلندمدت در مقابل کوتاه‌مدت

پیگیری دوره‌های نگهداری برای بهینه‌سازی مالیات:

; Use metadata to track purchase dates
2024-01-01 * "BTC Purchase - Long-term hold" ^long-term-btc
  Assets:Crypto:Coinbase:BTC  1.0 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD -40000.00 USD

; Sell after one year for long-term capital gains treatment
2025-01-02 * "BTC Sale - Long-term capital gains" ^long-term-btc
  Assets:Crypto:Coinbase:BTC    -1.0 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD   55000.00 USD
  Income:CapitalGains:LongTerm 15000.00 USD

گزارش‌دهی و تجزیه و تحلیل

گزارش‌های خلاصه پورتفولیو

تولید گزارش‌های جامع پورتفولیو:

-- Portfolio allocation by cryptocurrency
SELECT 
  commodity,
  sum(position) as total_units,
  value(sum(position)) as market_value,
  value(sum(position)) / (
    SELECT value(sum(position)) 
    FROM positions 
    WHERE account ~ "Assets:Crypto"
  ) * 100 as allocation_percentage
WHERE account ~ "Assets:Crypto"
GROUP BY commodity
ORDER BY market_value DESC;

تجزیه و تحلیل عملکرد

پیگیری عملکرد پورتفولیو در طول زمان:

-- Monthly portfolio performance
SELECT 
  year(date) as year,
  month(date) as month,
  value(sum(position)) as portfolio_value
WHERE account ~ "Assets:Crypto"
GROUP BY year, month
ORDER BY year, month;

تحلیل درآمد

تجزیه و تحلیل منابع درآمد:

-- Income breakdown by source
SELECT 
  account,
  sum(position) as total_income
WHERE account ~ "Income:Crypto"
GROUP BY account
ORDER BY total_income DESC;

بهترین شیوه‌ها و نکات

1. ثبت مداوم

• ثبت تراکنش‌ها بلافاصله پس از اجرا
• استفاده از توضیحات تراکنش استاندارد
• درج هش‌های تراکنش در فراداده

2. تطبیق منظم

• تأیید موجودی به صورت هفتگی در تمام پلتفرم‌ها
• استفاده از ادعاهای موجودی برای تشخیص مغایرت‌ها
• نظارت بر تراکنش‌های از قلم افتاده

3. پشتیبان‌گیری و امنیت

• به طور مرتب از فایل‌های Beancount خود پشتیبان تهیه کنید.
• استفاده از کنترل نسخه (Git) برای ردیابی تغییرات
• رمزگذاری داده‌های حساس

4. مستندسازی

• مستندسازی تصمیمات مربوط به ساختار حساب خود
• یادداشت‌برداری در مورد تراکنش‌های پیچیده
• نگهداری سوابق پیکربندی‌های API

5. آماده‌سازی مالیات

• تولید گزارش‌ها به صورت فصلی برای برنامه‌ریزی مالیات
• نگهداری سوابق دقیق برای اهداف ممیزی
• مشورت با متخصصان مالیاتی برای موقعیت‌های پیچیده

نتیجه‌گیری

ردیابی موثر پورتفولیوی ارز دیجیتال نیازمند دقت، پایداری و ابزارهای مناسب است. Beancount.io انعطاف‌پذیری و قدرت لازم برای مدیریت پورتفولیوهای پیچیده ارز دیجیتال در صرافی‌های متعدد، کیف پول‌ها و پروتکل‌های دیفای را فراهم می‌کند.

مزایای کلیدی استفاده از Beancount.io برای ردیابی پورتفولیوی ارز دیجیتال:

• مالکیت کامل داده: داده‌های شما در قالب متن ساده
• مبنای هزینه دقیق: ردیابی مبتنی بر لات با شناسایی خاص
• انعطاف‌پذیری نامحدود: ساختارهای حساب و گزارش‌دهی سفارشی
• بهینه‌سازی مالیات: استراتژی‌های پیشرفته برای به حداقل رساندن بدهی مالیاتی
• مقاوم در برابر آینده: فرمت باز دسترسی بلندمدت را تضمین می‌کند

با یک راه‌اندازی اولیه شروع کنید و به تدریج ردیابی خود را با افزایش پیچیدگی پورتفولیوی خود گسترش دهید. سرمایه‌گذاری در راه‌اندازی مناسب، سود سهام را در گزارش‌دهی دقیق، بهینه‌سازی مالیات و بینش پورتفولیو پرداخت خواهد کرد.

آیا آماده‌اید کنترل پورتفولیوی ارز دیجیتال خود را در دست بگیرید؟ همین امروز با Beancount.io شروع کنید.