Salta al contingut principal

Plantilles de transaccions cripto de Beancount a punt per copiar

Plantilles de Beancount per omplir, cadascuna amb un exemple carregable, per a compres, vendes, intercanvis, transferències, staking, préstecs DeFi, mineria i airdrops de cripto.

Aquesta guia ofereix plantilles pràctiques de Beancount i exemples reals per a escenaris habituals amb criptomonedes. Copia i adapta aquestes plantilles a les teves necessitats de comptabilitat cripto.

Com llegir aquests blocs​

Cada bloc delimitat a continuació és una de tres coses, i no són intercanviables:

  • Les plantilles contenen marcadors de posició [ENTRE CLAUDÀTORS] i dates YYYY-MM-DD. No es carregaran fins que substituïsca els valors reals — els claudàtors no són sintaxi de Beancount.
  • Els exemples es troben directament sota la seva plantilla, porten dates i imports reals, i estan escrits per carregar-se. Cadascun encara necessita que els comptes que toca estiguin oberts, i per a això serveix la Plantilla d'estructura de comptes d'aquí sota. L'única excepció és el bloc de conciliació, que afirma saldos que només el teu propi llibre pot satisfer.
  • El bloc d'Arbitratge amb Flash Loan és pseudocodi, i així s'etiqueta on apareix.

Dues convencions recorren tots ells:

  • Els comptes d'ingressos contenen crèdits, així que són negatius. Un guany realitzat és un apunt negatiu a Income:CapitalGains:…; una pèrdua realitzada és un apunt positiu a Expenses:CapitalLoss:…. Invertir això és la manera més habitual que un apunt cripto no quadri.
  • Una comissió es registra una vegada com a despesa i una vegada com a reducció d'efectiu. Els ingressos bruts van al compte d'efectiu, la comissió en surt, i la diferència és el que realment arriba al teu compte.

Explora un llibre d'exemple de criptomonedes en directe:

Obre Llibre d'exemple de criptomonedes en una pestanya nova

Plantilla de configuració bàsica​

Plantilla d'estructura de comptes​

; =============================================================================
; 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"

Plantilles de negociació​

Compra bàsica de criptomonedes​

; 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

Venda de criptomonedes​

; 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

El lot disposat val $22.500,00 a cost, la venda aporta $24.000,00 bruts, i $30,00 d'això van a l'intercanvi — així que arriben $23.970,00 d'efectiu i es realitzen $1.500,00 de guany. No compensis la comissió dins del guany: la comissió ja és una despesa, i restar-la una segona vegada és el que deixa la transacció sense quadrar.

Intercanvi de cripto per cripto​

; 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

Un intercanvi de cripto per cripto disposa de la primera mercaderia, així que realitza guany exactament com una venda per efectiu: 20 ETH adquirits a $2.400,00 són $48.000,00 de valor rebut contra $46.000,00 de base del BTC. La comissió de $40,00 es paga en efectiu i no canvia el guany.

Plantilles de transferència​

Transferència d'intercanvi a cartera​

; 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}

Una transferència no és una disposició, així que no realitza res: el mateix cost {45000.00 USD} viatja amb les monedes i el compte receptor hereta la base. Se'n deriven dues conseqüències. La comissió de retirada es paga en BTC i es registra com a despesa a aquest mateix cost, així que tampoc no realitza guany — si el teu tractament diu el contrari, valora la comissió amb @ i afegeix un apunt de guany. I el compte emissor ja ha de tenir 1,0005 BTC a aquest cost exacte, no 1,0, perquè la comissió surt del mateix lot. Una reducció sense un lot corresponent no es registra per bé que quadrin els totals.

Transferència entre intercanvis​

; 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}

Plantilles d'staking​

Staking d'Ethereum​

; 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}

Recompenses d'staking​

; 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

Una recompensa és un ingrés rebut en espècie, així que els dos apunts descriuen el mateix esdeveniment des de tots dos costats: arriben 0,08 ETH amb una base de $2.600,00 per unitat, i els $208,00 d'ingrés corresponents són un crèdit — negatiu. El {2,600.00 USD} és un preu extern que has d'obtenir tu mateix; Beancount el registra, no el busca. Anota'l de l'intercanvi o índex que realment utilitzis, i mantén la mateixa font al llarg de l'any.

Aquests $208,00 també són la base de cost de la recompensa a partir d'ara. Quan finalment venguis els 0,08 ETH, només el moviment des d'aquesta data és un guany — els $208,00 ja s'han gravat com a ingrés i no s'han de reconèixer dues vegades. Si l'ingrés és tributable en el moment de rebre'l o en el de disposar-ne varia segons la jurisdicció; el llibre registra els fets en qualsevol cas.

Plantilles de DeFi​

Provisió de liquiditat a 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}

Reconcilia això una mercaderia alhora: surten $25.000,00 d'ETH més $25.000,00 d'USDC, arriben $50.000,00 de token LP, i la comissió de gas mou $50,00 d'ETH de la cartera a una despesa. La part de stablecoin porta @ 1.00 USD perquè es manté sense base de cost — sense l'anotació de preu el seu pes és 25.000 USDC, que no poden cancel·lar dòlars. En moltes jurisdiccions dipositar en un pool és en si mateix una disposició de tots dos tokens; aquest apunt deliberadament trasllada la base, així que afegeix els apunts de guany si el teu tractament els requereix.

Préstec a 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}

Dues coses fan que això es carregui. La part d'USDC porta @ 1.00 USD perquè tots dos costats de l'intercanvi pesin en la mateixa moneda — sense això Beancount veu $10.000,00 de CUSDC apareixent contra 10.000 unitats d'USDC desapareixent, que són mercaderies diferents i no es cancel·len. I el token de rebut és CUSDC, no cUSDC: una primera lletra minúscula és un error de lexer tant en un component de compte com en un símbol de mercaderia, per molt que el protocol ho escrigui així a la seva pròpia interfície.

Plantilles de mineria​

Recompenses de mineria​

; 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

Despeses de mineria​

; 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

Plantilles d'airdrop​

Airdrops de tokens​

; 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

Com una recompensa d'staking, el valor reconegut de l'airdrop es converteix en la seva base de cost. Registra el preu que puguis defensar — la primera cotització líquida del token, d'una font que anomenis — en lloc d'un nombre rodó.

Plantilles avançades​

Arbitratge amb Flash Loan​

Aquest bloc és pseudocodi, no una plantilla. Esbossa la seqüència de moviments de valor dins d'un flash loan. No es carregarà ni tan sols després de substituir els valors, perquè les línies en blanc entre els grups acaben la transacció — Beancount informa d'un error de sintaxi en els apunts que segueixen un d'ells. Registra un flash loan real com una única transacció sense línies en blanc (etiquetant les parts amb comentaris ; indentats), eliminant les parts intermèdies que sumen zero dins del mateix bloc.

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

Tot el que el préstec ha tocat ha desaparegut al final del bloc, així que el que el llibre realment necessita registrar és el benefici i la comissió del protocol. L'exemple d'arbitratge a la guia de seguiment de cartera mostra la forma d'una única transacció.

Pont entre cadenes​

; 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}

Plantilles optimitzades fiscalment​

Collita de pèrdues fiscals​

; 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

La pèrdua és la imatge mirall d'un guany: surten $600,00 de base, arriben $450,00 d'ingressos bruts, i la diferència de $150,00 és un apunt positiu a un compte de despeses. Arriben realment $445,00 d'efectiu, després de la comissió de $5,00.

Guanys de capital a llarg termini​

; 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

El guany és de $10.000,00, no de $9.950,00: la comissió de $50,00 ja es registra com a despesa, així que compensar-la dins del guany la deduiria dues vegades. Income:CapitalGains:LongTerm és un compte separat d'Income:CapitalGains:Crypto només perquè el període de tinença sigui visible en un informe — Beancount no calcula períodes de tinença per tu, i per això val la pena portar les metadades date-acquired i holding-period.

Plantilles de conciliació​

Verificació mensual de saldos​

; 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

A diferència dels altres exemples d'aquí, aquest no és autocontingut per disseny: els imports són el que diguin les pantalles del teu propi intercanvi, i l'asserció falla fins que les teves transaccions siguin al llibre — que és precisament el seu propòsit. Tingues en compte que balance comprova el saldo a l'inici del dia indicat, així que data l'asserció el dia següent al període que estàs tancant.

Actualitzacions de preus​

; 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

Per a un llibre allotjat, Preus en directe pot mantenir automàticament els preus de valoració de cripto compatibles. Mantén els preus estàtics d'aquí dalt per a exemples reproduïbles. Els preus gestionats no omplen un preu de negociació, un ingrés d'staking ni una base de cost d'airdrop; registra aquests valors de transacció explícitament.

Instruccions d'ús​

  1. Copia la plantilla rellevant per al teu tipus de transacció

  2. Substitueix cada marcador de posició. Una plantilla no és Beancount vàlid fins que YYYY-MM-DD i cada testimoni [ENTRE CLAUDÀTORS] hagin desaparegut — els claudàtors no són sintaxi de Beancount, i un de sobrant és un error d'anàlisi, no un valor ignorat silenciosament. Substituir és mecànic:

    Marcador de posicióSubstitueix perExemple
    YYYY-MM-DDla data de la transacció2024-03-20
    [AMOUNT]unitats de la mercaderia, sense cometes0.5
    [CRYPTO]el símbol de la mercaderia, en majúsculesBTC
    [EXCHANGE]el component de compte del llocCoinbase
    [COST_BASIS]el cost per unitat del lot que estàs eliminant45000.00
    [SALE_PRICE]el preu per unitat al qual has venut48000.00
    [GROSS_PROCEEDS][AMOUNT] × [SALE_PRICE], abans de comissions24000.00
    [FEE]la comissió del lloc, en la moneda en què es va cobrar30.00
    [GAIN][GROSS_PROCEEDS] − [AMOUNT] × [COST_BASIS]1500.00

    Substituir aquesta columna a la plantilla de Venda de criptomonedes reprodueix l'exemple resolt imprès sota ella, que és la manera més ràpida de comprovar que has llegit la plantilla correctament.

  3. Ajusta els noms de compte perquè coincideixin amb la teva estructura de comptes, i assegura't que cadascun estigui obert per la Plantilla d'estructura de comptes — un compte que mai no s'obre és un error de càrrega, no un avís

  4. Afegeix metadades segons calgui per a la declaració fiscal o el seguiment

  5. Verifica els càlculs amb bea --file your-file.bean check abans de finalitzar els apunts. Un apunt que no quadra, o que redueix un lot que no tens, falla aquí en lloc de produir silenciosament un informe incorrecte

Bones pràctiques​

  • Utilitza convencions de nomenclatura consistents
  • Inclou identificadors de transacció a les metadades
  • Documenta a fons les transaccions complexes
  • Verifica els tipus de canvi i els preus
  • Mantén còpies de seguretat regulars dels teus fitxers

Aquestes plantilles ofereixen una base sòlida per a la comptabilitat de criptomonedes a Beancount.io. Personalitza-les segons les teves necessitats específiques i els teus patrons de negociació.

Font: https://beancount.io/ca/docs/Tips/cryptocurrency-templates-examples