このガイドでは、一般的な暗号通貨シナリオ向けの実用的なBeancountテンプレートと実例を紹介します。独自の暗号通貨会計ニーズに合わせて、これらのテンプレートをコピーして調整してください。
これらのブロックの読み方
以下のフェンスで囲まれた各ブロックは、次の3つのうちのいずれかであり、これらは互換性がありません：
- テンプレートには、
[ブラケット]プレースホルダーとYYYY-MM-DD日付が含まれています。実際の値に置き換えるまで読み込まれません。ブラケットはBeancount構文ではありません。 - 例は、そのテンプレートの直下にあり、実際の日付と金額が入力されており、読み込み可能です。それぞれが触れる勘定科目が開いている必要があります。これは、以下の勘定科目構造テンプレートが存在する理由です。唯一の例外は、照合ブロックであり、これは自分の元帳だけが満たすことができる残高を主張します。
- フラッシュローン裁定ブロックは疑似コードであり、そのようにラベル付けされています。
2つの規則がすべてに適用されます：
- 収入勘定は貸方なので、負の値になります。 実現利益は
Income:CapitalGains:…への負の転記です。実現損失はExpenses:CapitalLoss:…への正の転記です。これを逆にすることは、暗号通貨エントリのバランスが崩れる最も一般的な原因です。 - 手数料は、費用として1回と現金の減少として1回の2回記録されます。 総収入は現金勘定科目に入り、手数料はそこから差し引かれ、その差額が実際にあなたの口座に入金されます。
ライブの暗号通貨元帳の例を探索する：
基本テンプレート
勘定科目構造テンプレート
; =============================================================================
; CRYPTOCURRENCY ACCOUNT SETUP TEMPLATE
; =============================================================================
; Bank Accounts
1970-01-01 open Assets:Checking
; 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:BNB
1970-01-01 open Assets:Crypto:Binance:ADA
; On-Chain and Mining Accounts
1970-01-01 open Assets:Crypto:Ethereum:ETH
1970-01-01 open Assets:Crypto:Polygon:ETH
1970-01-01 open Assets:Crypto:Mining:BTC
; Wallet Accounts
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:MetaMask:UNI
; DeFi Protocol Accounts
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
; 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:CapitalGains:LongTerm
; 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
1970-01-01 open Expenses:Crypto:Bridge:Fees
1970-01-01 open Expenses:Crypto:Mining:Electricity
1970-01-01 open Expenses:CapitalLoss:Crypto
; Commodity Definitions
1970-01-01 commodity BTC
name: "Bitcoin"
asset-class: "cryptocurrency"
1970-01-01 commodity ETH
name: "Ethereum"
asset-class: "cryptocurrency"
1970-01-01 commodity USDC
name: "USD Coin"
asset-class: "stablecoin"
; Compound writes this receipt token "cUSDC", but a Beancount commodity
; and every account component must start with a capital letter or a digit,
; so the ledger spells it CUSDC and keeps the display name in metadata.
1970-01-01 commodity CUSDC
name: "cUSDC (Compound USD Coin)"
asset-class: "defi-receipt"取引テンプレート
基本的な暗号通貨の購入
; Template: Buy cryptocurrency on exchange
YYYY-MM-DD * "Buy [AMOUNT] [CRYPTO] on [EXCHANGE]"
Assets:Crypto:[EXCHANGE]:[CRYPTO] [AMOUNT] [CRYPTO] {[PRICE] USD}
Assets:Crypto:[EXCHANGE]:USD -[TOTAL_COST] USD
Expenses:Crypto:Fees:Trading [FEE] USD
Assets:Crypto:[EXCHANGE]:USD -[FEE] USD
; Example: Buy 1 BTC on Coinbase
2024-01-15 * "Buy 1 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暗号通貨の売却
; Template: Sell cryptocurrency on exchange
YYYY-MM-DD * "Sell [AMOUNT] [CRYPTO] on [EXCHANGE]"
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[AMOUNT] [CRYPTO] {[COST_BASIS] USD} @ [SALE_PRICE] USD
Assets:Crypto:[EXCHANGE]:USD [GROSS_PROCEEDS] USD
Expenses:Crypto:Fees:Trading [FEE] USD
Assets:Crypto:[EXCHANGE]:USD -[FEE] USD
Income:CapitalGains:Crypto -[GAIN] USD ; a loss is a positive Expenses:CapitalLoss:Crypto instead
; Example: Sell 0.5 BTC with a gain
2024-03-20 * "Sell 0.5 BTC on Coinbase"
Assets:Crypto:Coinbase:BTC -0.5 BTC {45000.00 USD} @ 48000.00 USD
Assets:Crypto:Coinbase:USD 24000.00 USD ; gross proceeds, 0.5 * 48,000.00
Expenses:Crypto:Fees:Trading 30.00 USD
Assets:Crypto:Coinbase:USD -30.00 USD ; the fee leaves the same cash account
Income:CapitalGains:Crypto -1500.00 USD ; 24,000.00 proceeds - 22,500.00 basis処分されたロットの価値は取得原価で$22,500.00、売却により$24,000.00の総収入があり、そのうち$30.00が取引所に支払われるため、$23,970.00の現金が入金され、$1,500.00の利益が実現します。利益に手数料を相殺してはいけません。手数料はすでに費用であり、取引のバランスを崩すことになります。
暗号通貨間取引
; Template: Trade one crypto for another
YYYY-MM-DD * "Trade [AMOUNT1] [CRYPTO1] for [AMOUNT2] [CRYPTO2]"
Assets:Crypto:[EXCHANGE]:[CRYPTO1] -[AMOUNT1] [CRYPTO1] {[COST_BASIS] USD}
Assets:Crypto:[EXCHANGE]:[CRYPTO2] [AMOUNT2] [CRYPTO2] {[NEW_PRICE] USD}
Income:CapitalGains:Crypto -[GAIN] USD ; taxable event; a loss is a positive Expenses:CapitalLoss:Crypto
Expenses:Crypto:Fees:Trading [FEE] USD
Assets:Crypto:[EXCHANGE]:USD -[FEE] USD
; Example: Trade BTC for ETH
2024-02-10 * "Trade 1 BTC for 20 ETH on Binance"
Assets:Crypto:Binance:BTC -1.0 BTC {46000.00 USD}
Assets:Crypto:Binance:ETH 20 ETH {2400.00 USD}
Income:CapitalGains:Crypto -2000.00 USD ; 48,000.00 received - 46,000.00 basis
Expenses:Crypto:Fees:Trading 40.00 USD
Assets:Crypto:Binance:USD -40.00 USD暗号通貨間取引では、最初の暗号通貨が処分されるため、現金売却と同様に利益が正確に実現します。取得原価$2,400.00の20 ETHは、$46,000.00のBTC原価に対して$48,000.00の価値を受け取ります。$40.00の手数料は現金で支払われ、利益には影響しません。
送金テンプレート
取引所からウォレットへの送金
; Template: Transfer crypto from exchange to wallet
YYYY-MM-DD * "Transfer [AMOUNT] [CRYPTO] from [EXCHANGE] to [WALLET]"
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[AMOUNT] [CRYPTO] {[COST_BASIS] USD}
Assets:Crypto:Wallet:[WALLET]:[CRYPTO] [AMOUNT] [CRYPTO] {[COST_BASIS] USD}
Expenses:Crypto:Fees:Withdrawal [FEE] [CRYPTO] {[COST_BASIS] USD}
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[FEE] [CRYPTO] {[COST_BASIS] USD}
; Example: Transfer BTC to Ledger
2024-01-20 * "Transfer 1 BTC from Coinbase to Ledger"
Assets:Crypto:Coinbase:BTC -1.0 BTC {45000.00 USD}
Assets:Crypto:Wallet:Ledger:BTC 1.0 BTC {45000.00 USD}
Expenses:Crypto:Fees:Withdrawal 0.0005 BTC {45000.00 USD}
Assets:Crypto:Coinbase:BTC -0.0005 BTC {45000.00 USD}送金は処分ではないため、利益は実現しません。{45000.00 USD}の原価は暗号通貨とともに移動し、受け取り勘定科目がそのbasisを引き継ぎます。以下の2つの結果が続きます。引き出し手数料はBTCで支払われ、同じ原価で費用計上されるため、利益は実現しません。もしあなたの処理が別のことを言うなら、@で手数料を価格付けし、利益転記を追加してください。また、送金元の勘定科目は、正確に1.0005 BTCをその原価で保有している必要があります。1.0ではありません。手数料が同じロットから支払われるためです。一致するロットがない場合の減算は、合計がうまく収まっても、エントリのバランスを崩します。
クロス取引所送金
; Template: Transfer between exchanges
YYYY-MM-DD * "Transfer [AMOUNT] [CRYPTO] from [EXCHANGE1] to [EXCHANGE2]"
Assets:Crypto:[EXCHANGE1]:[CRYPTO] -[AMOUNT] [CRYPTO] {[COST_BASIS] USD}
Assets:Crypto:[EXCHANGE2]:[CRYPTO] [AMOUNT] [CRYPTO] {[COST_BASIS] USD}
Expenses:Crypto:Fees:Network [FEE] [CRYPTO] {[COST_BASIS] USD}
Assets:Crypto:[EXCHANGE1]:[CRYPTO] -[FEE] [CRYPTO] {[COST_BASIS] USD}
; Example: Transfer ETH from Coinbase to Binance
2024-02-05 * "Transfer 10 ETH from Coinbase to Binance"
Assets:Crypto:Coinbase:ETH -10 ETH {2500.00 USD}
Assets:Crypto:Binance:ETH 10 ETH {2500.00 USD}
Expenses:Crypto:Fees:Network 0.01 ETH {2500.00 USD}
Assets:Crypto:Coinbase:ETH -0.01 ETH {2500.00 USD}ステーキングテンプレート
イーサリアムのステーキング
; Template: Stake ETH
YYYY-MM-DD * "Stake [AMOUNT] ETH"
Assets:Crypto:Wallet:MetaMask:ETH -[AMOUNT] ETH {[PRICE] USD}
Assets:Staking:Ethereum:ETH [AMOUNT] ETH {[PRICE] USD}
Expenses:Crypto:Fees:Network [FEE] ETH {[PRICE] USD}
Assets:Crypto:Wallet:MetaMask:ETH -[FEE] ETH {[PRICE] USD}
; Example: Stake 32 ETH
2024-01-10 * "Stake 32 ETH on Ethereum 2.0"
Assets:Crypto:Wallet:MetaMask:ETH -32 ETH {2500.00 USD}
Assets:Staking:Ethereum:ETH 32 ETH {2500.00 USD}
Expenses:Crypto:Fees:Network 0.01 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.01 ETH {2500.00 USD}ステーキング報酬
; Template: Receive staking rewards
YYYY-MM-DD * "[CRYPTO] Staking Rewards - [PERIOD]"
Assets:Staking:[PROTOCOL]:[CRYPTO] [AMOUNT] [CRYPTO] {[PRICE] USD}
Income:Crypto:Staking:[CRYPTO] -[VALUE] USD ; [VALUE] = [AMOUNT] * [PRICE]
; Example: ETH staking rewards
2024-02-01 * "ETH Staking Rewards - January"
Assets:Staking:Ethereum:ETH 0.08 ETH {2600.00 USD}
Income:Crypto:Staking:ETH -208.00 USD ; 0.08 * 2,600.00報酬は現物で受け取る収入であるため、2つの転記は同じイベントを双方の側面から説明しています。0.08 ETHがユニットあたり$2,600.00で到着し、一致する$208.00の収入は貸方になります。{2,600.00 USD}は自分で調達しなければならない外部価格です。Beancountはそれを記録しますが、取得しません。実際に使用する取引所またはインデックスからそれをメモし、年間を通して同じソースを維持してください。
その$208.00は、今後この報酬の取得原価でもあります。最終的に0.08 ETHを売却するとき、この時点以降の変動のみが利益となります。$208.00はすでに収入として課税されており、二重計上してはなりません。収入が受領時または処分時に課税されるかは管轄によって異なります。元帳はどちらの場合でも事実を記録します。
DeFiテンプレート
Uniswap流動性提供
; Template: Add liquidity to Uniswap pool
YYYY-MM-DD * "Add liquidity to [TOKEN1]-[TOKEN2] pool"
Assets:Crypto:Wallet:MetaMask:[TOKEN1] -[AMOUNT1] [TOKEN1] {[PRICE1] USD}
Assets:Crypto:Wallet:MetaMask:[TOKEN2] -[AMOUNT2] [TOKEN2] {[PRICE2] USD}
Assets:DeFi:Uniswap:[TOKEN1]-[TOKEN2]-LP [LP_AMOUNT] [LP_TOKEN] {[LP_PRICE] USD}
Expenses:Crypto:Fees:Network [FEE] ETH {[ETH_PRICE] USD}
Assets:Crypto:Wallet:MetaMask:ETH -[FEE] ETH {[ETH_PRICE] USD}
; Example: Add ETH-USDC liquidity
2024-01-15 * "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-V3-ETH-USDC {500.00 USD}
Expenses:Crypto:Fees:Network 0.02 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.02 ETH {2500.00 USD}この取引は一度に1つのアイテムを調整します。$25,000.00のETHと$25,000.00のUSDCが出て行き、$50,000.00のLPトークンが到着し、ガス手数料がウォレットから費用へ$50.00移動します。ステーブルコインのレッグは@ 1.00 USDを運びます。これは、原価basisなしで保有されているためです。その価格注記がなければ、その重量は25,000 USDCであり、ドルを相殺することはできません。多くの管轄では、プールへの預入自体が両方のトークンの処分です。このエントリは意図的にbasisを運ぶため、あなたの処理がそれを要求する場合は、利益転記を追加してください。
Compound融資
; Template: Supply assets to Compound
YYYY-MM-DD * "Supply [AMOUNT] [TOKEN] to Compound"
Assets:Crypto:Wallet:MetaMask:[TOKEN] -[AMOUNT] [TOKEN] @ [TOKEN_PRICE] USD
Assets:DeFi:Compound:C[TOKEN] [C_AMOUNT] C[TOKEN] {[C_PRICE] USD}
Expenses:Crypto:Fees:Network [FEE] ETH {[ETH_PRICE] USD}
Assets:Crypto:Wallet:MetaMask:ETH -[FEE] ETH {[ETH_PRICE] USD}
; Example: Supply USDC to Compound
2024-01-20 * "Supply 10000 USDC to Compound"
Assets:Crypto:Wallet:MetaMask:USDC -10000 USDC @ 1.00 USD
Assets:DeFi:Compound:CUSDC 500 CUSDC {20.00 USD}
Expenses:Crypto:Fees:Network 0.008 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.008 ETH {2500.00 USD}この取引を成立させるものは2つあります。USDCレッグは@ 1.00 USDを運ぶため、スワップの両側は同じ通貨で重量が異なります。それがないと、Beancountは$10,000.00のCUSDCが10,000単位のUSDCと一致するのを認識しますが、これらは異なる商品であり、相殺されません。そして、受け取りトークンはCUSDCであり、cUSDCではありません。小文字の最初の文字は、勘定科目コンポーネントと商品シンボルの両方で字句エラーです。ただし、プロトコルは独自のインターフェースでそれを綴っています。
マイニングテンプレート
マイニング報酬
; Template: Receive mining rewards
YYYY-MM-DD * "[CRYPTO] Mining Reward - [POOL/SOLO]"
Assets:Crypto:Mining:[CRYPTO] [AMOUNT] [CRYPTO] {[PRICE] USD}
Income:Crypto:Mining:[CRYPTO] -[VALUE] USD ; [VALUE] = [AMOUNT] * [PRICE]
; Example: Bitcoin mining reward
2024-01-15 * "BTC Mining Reward - Slush Pool"
Assets:Crypto:Mining:BTC 0.01 BTC {45000.00 USD}
Income:Crypto:Mining:BTC -450.00 USD ; 0.01 * 45,000.00マイニング費用
; Template: Mining operational expenses
YYYY-MM-DD * "Mining [EXPENSE_TYPE] - [PERIOD]"
Expenses:Crypto:Mining:[EXPENSE_TYPE] [AMOUNT] USD
Assets:Checking -[AMOUNT] USD
; Example: Mining electricity costs
2024-01-31 * "Mining Electricity - January"
Expenses:Crypto:Mining:Electricity 800.00 USD
Assets:Checking -800.00 USDエアドロップテンプレート
トークンエアドロップ
; Template: Receive token airdrop
YYYY-MM-DD * "[TOKEN] Airdrop from [PROJECT]"
Assets:Crypto:Wallet:[WALLET]:[TOKEN] [AMOUNT] [TOKEN] {[PRICE] USD}
Income:Crypto:Airdrops -[VALUE] USD ; [VALUE] = [AMOUNT] * [PRICE]
; Example: UNI token airdrop
2024-03-01 * "UNI Airdrop from Uniswap"
Assets:Crypto:Wallet:MetaMask:UNI 400 UNI {8.00 USD}
Income:Crypto:Airdrops -3200.00 USD ; 400 * 8.00ステーキング報酬と同様に、エアドロップの認識された価値がその取得原価になります。四捨五入された数字ではなく、あなたが防御できる価格、つまりあなたが名前を挙げた情報源からのトークンの最初の相場を記録してください。
高度なテンプレート
フラッシュローン裁定
このブロックは疑似コードであり、テンプレートではありません。 フラッシュローン内での価値の移動の流れをスケッチしたものです。グループ間の空行が取引を終了させるため、値を置き換えても読み込まれません。Beancountは、以下の転記に対して構文エラーを報告します。実際のフラッシュローンを、空行のない単一の取引として記録し（レッグにインデントされた;コメントを付けてラベル付けし）、同じブロック内でゼロに相殺される中間レッグを削除してください。
Pseudocode: flash loan arbitrage
borrow Assets:Crypto:Temp:FlashLoan +[LOAN_AMOUNT] [TOKEN]
Liabilities:DeFi:[PROTOCOL]:Flash -[LOAN_AMOUNT] [TOKEN]
execute Assets:Crypto:Temp:FlashLoan -[LOAN_AMOUNT] [TOKEN]
Assets:Crypto:Temp:Arbitrage +[RETURN_AMOUNT] [TOKEN]
repay Liabilities:DeFi:[PROTOCOL]:Flash +[LOAN_AMOUNT] [TOKEN]
Assets:Crypto:Temp:Arbitrage -[LOAN_PLUS_FEE] [TOKEN]
keep Assets:Crypto:Wallet:[WALLET]:[TOKEN] +[PROFIT] [TOKEN]
Income:Crypto:Arbitrage -[PROFIT_USD] USDローンが触れたものはすべてブロックの終わりまでに消えているため、元帳が実際に記録する必要があるのは、利益とプロトコル手数料です。ポートフォリオ追跡ガイドの裁定取引の例は、単一取引の形状を示しています。
クロスチェーンブリッジ
; Template: Bridge assets across chains
YYYY-MM-DD * "Bridge [AMOUNT] [TOKEN] from [CHAIN1] to [CHAIN2]"
Assets:Crypto:[CHAIN1]:[TOKEN] -[AMOUNT] [TOKEN] {[PRICE] USD}
Assets:Crypto:[CHAIN2]:[TOKEN] [AMOUNT] [TOKEN] {[PRICE] USD}
Expenses:Crypto:Bridge:Fees [FEE] [TOKEN] {[PRICE] USD}
Assets:Crypto:[CHAIN1]:[TOKEN] -[FEE] [TOKEN] {[PRICE] USD}
; Example: Bridge ETH to Polygon
2024-02-05 * "Bridge 5 ETH from Ethereum to Polygon"
Assets:Crypto:Ethereum:ETH -5 ETH {2600.00 USD}
Assets:Crypto:Polygon:ETH 5 ETH {2600.00 USD}
Expenses:Crypto:Bridge:Fees 0.01 ETH {2600.00 USD}
Assets:Crypto:Ethereum:ETH -0.01 ETH {2600.00 USD}税制最適化テンプレート
税損回収
; Template: Tax loss harvesting
YYYY-MM-DD * "Tax loss harvesting - Sell [CRYPTO] at loss"
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[AMOUNT] [CRYPTO] {[HIGH_COST_BASIS] USD}
Assets:Crypto:[EXCHANGE]:USD [PROCEEDS] USD
Expenses:Crypto:Fees:Trading [FEE] USD
Assets:Crypto:[EXCHANGE]:USD -[FEE] USD
Expenses:CapitalLoss:Crypto [LOSS] USD
; Example: Harvest ADA loss
2024-12-15 * "Tax loss harvesting - Sell ADA at loss"
Assets:Crypto:Binance:ADA -1000 ADA {0.60 USD} @ 0.45 USD
Assets:Crypto:Binance:USD 450.00 USD ; gross proceeds, 1,000 * 0.45
Expenses:Crypto:Fees:Trading 5.00 USD
Assets:Crypto:Binance:USD -5.00 USD
Expenses:CapitalLoss:Crypto 150.00 USD ; 600.00 basis - 450.00 proceeds損失は利益の鏡像です。$600.00のbasisが出て行き、$450.00の総収入が入金され、$150.00の差額が費用勘定科目への正の転記となります。$5.00の手数料の後、$445.00の現金が実際に入金されます。
長期キャピタルゲイン
; Template: Long-term capital gains sale
YYYY-MM-DD * "Long-term sale - [CRYPTO] held > 1 year"
date-acquired: "[PURCHASE_DATE]"
holding-period: "[DAYS] days"
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[AMOUNT] [CRYPTO] {[COST_BASIS] USD} @ [SALE_PRICE] USD
Assets:Crypto:[EXCHANGE]:USD [GROSS_PROCEEDS] USD
Expenses:Crypto:Fees:Trading [FEE] USD
Assets:Crypto:[EXCHANGE]:USD -[FEE] USD
Income:CapitalGains:LongTerm -[GAIN] USD
; Example: Long-term BTC sale
2025-02-01 * "Long-term sale - BTC held 382 days"
date-acquired: "2024-01-15"
holding-period: "382 days"
Assets:Crypto:Coinbase:BTC -1.0 BTC {45000.00 USD} @ 55000.00 USD
Assets:Crypto:Coinbase:USD 55000.00 USD
Expenses:Crypto:Fees:Trading 50.00 USD
Assets:Crypto:Coinbase:USD -50.00 USD
Income:CapitalGains:LongTerm -10000.00 USD ; 55,000.00 proceeds - 45,000.00 basis利益は$10,000.00であり、$9,950.00ではありません。$50.00の手数料はすでに費用として記録されているため、それを利益に相殺すると二重控除になります。Income:CapitalGains:LongTermはIncome:CapitalGains:Cryptoとは別の勘定科目であり、保有期間がレポートに表示されるようにするためだけに存在します。Beancountはあなたの代わりに保有期間を計算しません。そのため、date-acquiredとholding-periodメタデータを保持する価値があります。
照合テンプレート
月次残高照合
; Template: Monthly balance assertions
YYYY-MM-DD balance Assets:Crypto:[EXCHANGE]:[CRYPTO] [EXPECTED_BALANCE] [CRYPTO]
YYYY-MM-DD balance Assets:Crypto:Wallet:[WALLET]:[CRYPTO] [EXPECTED_BALANCE] [CRYPTO]
; Example: January balance 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:Wallet:Ledger:BTC 1.0 BTCここにある他の例とは異なり、これは意図的に自己完結型ではありません。金額はあなた自身の取引所の画面が示すものであり、取引が元帳に記録されるまで照合は失敗します。これがこのテンプレートの目的全体です。balanceは指定された日の開始時の残高をチェックすることに注意してください。したがって、期間を締める日の翌日に照合を日付設定してください。
価格更新
; Template: Daily price updates
YYYY-MM-DD price [CRYPTO] [PRICE] USD
; Example: Daily prices
2024-01-15 price BTC 45000.00 USD
2024-01-15 price ETH 2500.00 USD
2024-01-15 price ADA 0.50 USD使用手順
-
取引タイプに応じたテンプレートをコピーします。
-
すべてのプレースホルダーを置き換えます。 テンプレートは、
YYYY-MM-DDと各[ブラケット]トークンが置き換えられるまで、有効なBeancountではありません。ブラケットはBeancount構文ではなく、残ったものは黙って無視される値ではなくパースエラーになります。置き換えは機械的です：プレースホルダー 置き換え 例 YYYY-MM-DD取引の日付 2024-03-20[AMOUNT]商品のユニット数（引用符なし） 0.5[CRYPTO]商品シンボル（大文字） BTC[EXCHANGE]取引所の勘定科目コンポーネント Coinbase[COST_BASIS]除去するロットのユニットあたりの原価 45000.00[SALE_PRICE]売却したユニットあたりの価格 48000.00[GROSS_PROCEEDS][AMOUNT]×[SALE_PRICE]（手数料控除前）24000.00[FEE]取引所の手数料（請求された通貨建て） 30.00[GAIN][GROSS_PROCEEDS]−[AMOUNT]×[COST_BASIS]1500.00その列を暗号通貨の売却テンプレートに置き換えると、その下に印刷されている計算例が再現されます。これは、テンプレートを正しく読んだことを確認する最も迅速な方法です。
-
勘定科目名を調整してあなたの勘定科目構造に合わせます。各勘定科目が勘定科目構造テンプレートによって開かれていることを確認してください。開かれたことのない勘定科目は、警告ではなくロードエラーになります。
-
税務申告または追跡のために、必要に応じてメタデータを追加します。
-
計算を検証するには、エントリを確定する前に
bean-check your-file.beanを実行します。バランスが取れていないエントリや、保有していないロットを減らすエントリは、誤ったレポートを静かに生成する代わりに、そこで失敗します。
ベストプラクティス
- 一貫性のある命名規則を使用する
- 取引IDをメタデータに含める
- 複雑な取引を徹底的に文書化する
- 為替レートと価格を検証する
- ファイルの定期的なバックアップを維持する
これらのテンプレートは、Beancount.ioでの暗号通貨会計のための強固な基盤を提供します。特定のニーズと取引パターンに基づいてカスタマイズしてください。