Questa guida fornisce modelli pratici di Beancount ed esempi reali per scenari comuni con criptovalute. Copia e adatta questi modelli per le tue esigenze di contabilità crypto.
Esplora un registro di criptovalute live di esempio:
Modello di Configurazione di Base
Modello della Struttura dei Conti
; =============================================================================
; MODELLO DI CONFIGURAZIONE DEI CONTI PER CRIPTOVALUTE
; =============================================================================
; Conti Exchange
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
; Conti Wallet
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
; Conti Protocolli DeFi
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
; Conti Reddito
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
; Conti Spese
1970-01-01 open Expenses:Crypto:Fees:Trading
1970-01-01 open Expenses:Crypto:Fees:Network
1970-01-01 open Expenses:Crypto:Fees:Withdrawal
; Definizioni delle Commodity
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"Modelli di Trading
Acquisto Base di Criptovaluta
; Modello: Acquista criptovaluta su exchange
YYYY-MM-DD * "Acquista [IMPORTO] [CRYPTO] su [EXCHANGE]"
Assets:Crypto:[EXCHANGE]:[CRYPTO] [IMPORTO] [CRYPTO] {[PREZZO] USD}
Assets:Crypto:[EXCHANGE]:USD -[COSTO_TOTALE] USD
Expenses:Crypto:Fees:Trading [COMMISSIONE] USD
Assets:Crypto:[EXCHANGE]:USD -[COMMISSIONE] USD
; Esempio: Acquista 1 BTC su Coinbase
2024-01-15 * "Acquista 1 BTC su 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 USDVendita di Criptovaluta
; Modello: Vendi criptovaluta su exchange
YYYY-MM-DD * "Vendi [IMPORTO] [CRYPTO] su [EXCHANGE]"
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[IMPORTO] [CRYPTO] {[BASE_COSTO] USD}
Assets:Crypto:[EXCHANGE]:USD [RICAVO] USD
Expenses:Crypto:Fees:Trading [COMMISSIONE] USD
Assets:Crypto:[EXCHANGE]:USD -[COMMISSIONE] USD
Income:CapitalGains:Crypto [GUADAGNO] USD ; o Expenses:CapitalLoss:Crypto
; Esempio: Vendi 0.5 BTC con guadagno
2024-03-20 * "Vendi 0.5 BTC su Coinbase"
Assets:Crypto:Coinbase:BTC -0.5 BTC {45000.00 USD}
Assets:Crypto:Coinbase:USD 24000.00 USD
Expenses:Crypto:Fees:Trading 30.00 USD
Assets:Crypto:Coinbase:USD -30.00 USD
Income:CapitalGains:Crypto 1470.00 USD ; 24000 - 22500 - 30Scambio Crypto-Crypto
; Modello: Scambia una criptovaluta per un'altra
YYYY-MM-DD * "Scambia [IMPORTO1] [CRYPTO1] per [IMPORTO2] [CRYPTO2]"
Assets:Crypto:[EXCHANGE]:[CRYPTO1] -[IMPORTO1] [CRYPTO1] {[BASE_COSTO] USD}
Assets:Crypto:[EXCHANGE]:[CRYPTO2] [IMPORTO2] [CRYPTO2] {[NUOVO_PREZZO] USD}
Income:CapitalGains:Crypto [GUADAGNO] USD ; Evento tassabile
Expenses:Crypto:Fees:Trading [COMMISSIONE] USD
Assets:Crypto:[EXCHANGE]:USD -[COMMISSIONE] USD
; Esempio: Scambia BTC per ETH
2024-02-10 * "Scambia 1 BTC per 20 ETH su 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 ; 48000 - 46000
Expenses:Crypto:Fees:Trading 40.00 USD
Assets:Crypto:Binance:USD -40.00 USDModelli di Trasferimento
Trasferimento da Exchange a Wallet
; Modello: Trasferisci criptovaluta da exchange a wallet
YYYY-MM-DD * "Trasferisci [IMPORTO] [CRYPTO] da [EXCHANGE] a [WALLET]"
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[IMPORTO] [CRYPTO] {[BASE_COSTO] USD}
Assets:Crypto:Wallet:[WALLET]:[CRYPTO] [IMPORTO] [CRYPTO] {[BASE_COSTO] USD}
Expenses:Crypto:Fees:Withdrawal [COMMISSIONE] [CRYPTO] {[BASE_COSTO] USD}
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[COMMISSIONE] [CRYPTO] {[BASE_COSTO] USD}
; Esempio: Trasferisci BTC su Ledger
2024-01-20 * "Trasferisci 1 BTC da Coinbase a 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}Trasferimento tra Exchange
; Modello: Trasferisci tra exchange
YYYY-MM-DD * "Trasferisci [IMPORTO] [CRYPTO] da [EXCHANGE1] a [EXCHANGE2]"
Assets:Crypto:[EXCHANGE1]:[CRYPTO] -[IMPORTO] [CRYPTO] {[BASE_COSTO] USD}
Assets:Crypto:[EXCHANGE2]:[CRYPTO] [IMPORTO] [CRYPTO] {[BASE_COSTO] USD}
Expenses:Crypto:Fees:Network [COMMISSIONE] [CRYPTO] {[BASE_COSTO] USD}
Assets:Crypto:[EXCHANGE1]:[CRYPTO] -[COMMISSIONE] [CRYPTO] {[BASE_COSTO] USD}
; Esempio: Trasferisci ETH da Coinbase a Binance
2024-02-05 * "Trasferisci 10 ETH da Coinbase a 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}Modelli di Staking
Staking di Ethereum
; Modello: Fai staking di ETH
YYYY-MM-DD * "Fai staking di [IMPORTO] ETH"
Assets:Crypto:Wallet:MetaMask:ETH -[IMPORTO] ETH {[PREZZO] USD}
Assets:Staking:Ethereum:ETH [IMPORTO] ETH {[PREZZO] USD}
Expenses:Crypto:Fees:Network [COMMISSIONE] ETH {[PREZZO] USD}
Assets:Crypto:Wallet:MetaMask:ETH -[COMMISSIONE] ETH {[PREZZO] USD}
; Esempio: Fai staking di 32 ETH
2024-01-10 * "Fai staking di 32 ETH su 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}Ricompense da Staking
; Modello: Ricevi ricompense da staking
YYYY-MM-DD * "Ricompense Staking [CRYPTO] - [PERIODO]"
Assets:Staking:[PROTOCOLLO]:[CRYPTO] [IMPORTO] [CRYPTO] {[PREZZO] USD}
Income:Crypto:Staking:[CRYPTO] [VALORE] USD
; Esempio: Ricompense staking ETH
2024-02-01 * "Ricompense Staking ETH - Gennaio"
Assets:Staking:Ethereum:ETH 0.08 ETH {2600.00 USD}
Income:Crypto:Staking:ETH 208.00 USDModelli DeFi
Fornitura di Liquidità su Uniswap
; Modello: Aggiungi liquidità al pool Uniswap
YYYY-MM-DD * "Aggiungi liquidità al pool [TOKEN1]-[TOKEN2]"
Assets:Crypto:Wallet:MetaMask:[TOKEN1] -[IMPORTO1] [TOKEN1] {[PREZZO1] USD}
Assets:Crypto:Wallet:MetaMask:[TOKEN2] -[IMPORTO2] [TOKEN2] {[PREZZO2] USD}
Assets:DeFi:Uniswap:[TOKEN1]-[TOKEN2]-LP [IMPORTO_LP] [LP_TOKEN] {[PREZZO_LP] USD}
Expenses:Crypto:Fees:Network [COMMISSIONE] ETH {[PREZZO_ETH] USD}
Assets:Crypto:Wallet:MetaMask:ETH -[COMMISSIONE] ETH {[PREZZO_ETH] USD}
; Esempio: Aggiungi liquidità ETH-USDC
2024-01-15 * "Aggiungi liquidità al pool ETH-USDC"
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-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}Prestito su Compound
; Modello: Fornisci asset a Compound
YYYY-MM-DD * "Fornisci [IMPORTO] [TOKEN] a Compound"
Assets:Crypto:Wallet:MetaMask:[TOKEN] -[IMPORTO] [TOKEN]
Assets:DeFi:Compound:c[TOKEN] [C_IMPORTO] c[TOKEN] {[C_PREZZO] USD}
Expenses:Crypto:Fees:Network [COMMISSIONE] ETH {[PREZZO_ETH] USD}
Assets:Crypto:Wallet:MetaMask:ETH -[COMMISSIONE] ETH {[PREZZO_ETH] USD}
; Esempio: Fornisci USDC a Compound
2024-01-20 * "Fornisci 10000 USDC a Compound"
Assets:Crypto:Wallet:MetaMask:USDC -10000 USDC
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}Modelli di Mining
Ricompense da Mining
; Modello: Ricevi ricompense da mining
YYYY-MM-DD * "Ricompensa Mining [CRYPTO] - [POOL/SOLO]"
Assets:Crypto:Mining:[CRYPTO] [IMPORTO] [CRYPTO] {[PREZZO] USD}
Income:Crypto:Mining:[CRYPTO] [VALORE] USD
; Esempio: Ricompensa mining Bitcoin
2024-01-15 * "Ricompensa Mining BTC - Slush Pool"
Assets:Crypto:Mining:BTC 0.01 BTC {45000.00 USD}
Income:Crypto:Mining:BTC 450.00 USDSpese di Mining
; Modello: Spese operative di mining
YYYY-MM-DD * "Mining [TIPO_SPESA] - [PERIODO]"
Expenses:Crypto:Mining:[TIPO_SPESA] [IMPORTO] USD
Assets:Checking -[IMPORTO] USD
; Esempio: Costi elettricità mining
2024-01-31 * "Mining Elettricità - Gennaio"
Expenses:Crypto:Mining:Electricity 800.00 USD
Assets:Checking -800.00 USDModelli di Airdrop
Airdrop di Token
; Modello: Ricevi airdrop di token
YYYY-MM-DD * "Airdrop [TOKEN] da [PROGETTO]"
Assets:Crypto:Wallet:[WALLET]:[TOKEN] [IMPORTO] [TOKEN] {[PREZZO] USD}
Income:Crypto:Airdrops [VALORE] USD
; Esempio: Airdrop token UNI
2024-03-01 * "Airdrop UNI da Uniswap"
Assets:Crypto:Wallet:MetaMask:UNI 400 UNI {8.00 USD}
Income:Crypto:Airdrops 3200.00 USDModelli Avanzati
Arbitraggio con Flash Loan
; Modello: Arbitraggio con flash loan
YYYY-MM-DD * "Arbitraggio flash loan - [STRATEGIA]"
; Flash loan
Assets:Crypto:Temp:FlashLoan [IMPORTO_PRESTITO] [TOKEN]
Liabilities:DeFi:[PROTOCOLLO]:Flash -[IMPORTO_PRESTITO] [TOKEN]
; Esecuzione arbitraggio
Assets:Crypto:Temp:FlashLoan -[IMPORTO_PRESTITO] [TOKEN]
Assets:Crypto:Temp:Arbitrage [IMPORTO_RITORNO] [TOKEN]
; Rimborso flash loan
Liabilities:DeFi:[PROTOCOLLO]:Flash [IMPORTO_PRESTITO] [TOKEN]
Assets:Crypto:Temp:Arbitrage -[IMPORTO_PRESTITO_PIU_COMMISSIONE] [TOKEN]
; Profitto
Assets:Crypto:Wallet:[WALLET]:[TOKEN] [PROFITTO] [TOKEN]
Income:Crypto:Arbitrage [PROFITTO_USD] USDBridge Cross-Chain
; Modello: Ponte asset tra chain
YYYY-MM-DD * "Ponte [IMPORTO] [TOKEN] da [CHAIN1] a [CHAIN2]"
Assets:Crypto:[CHAIN1]:[TOKEN] -[IMPORTO] [TOKEN] {[PREZZO] USD}
Assets:Crypto:[CHAIN2]:[TOKEN] [IMPORTO] [TOKEN] {[PREZZO] USD}
Expenses:Crypto:Bridge:Fees [COMMISSIONE] [TOKEN] {[PREZZO] USD}
Assets:Crypto:[CHAIN1]:[TOKEN] -[COMMISSIONE] [TOKEN] {[PREZZO] USD}
; Esempio: Ponte ETH su Polygon
2024-02-05 * "Ponte 5 ETH da Ethereum a 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}Modelli Ottimizzati per le Tasse
Tax Loss Harvesting
; Modello: Tax loss harvesting
YYYY-MM-DD * "Tax loss harvesting - Vendi [CRYPTO] in perdita"
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[IMPORTO] [CRYPTO] {[BASE_COSTO_ALTA] USD}
Assets:Crypto:[EXCHANGE]:USD [RICAVO] USD
Expenses:Crypto:Fees:Trading [COMMISSIONE] USD
Assets:Crypto:[EXCHANGE]:USD -[COMMISSIONE] USD
Expenses:CapitalLoss:Crypto [PERDITA] USD
; Esempio: Harvest perdita ADA
2024-12-15 * "Tax loss harvesting - Vendi ADA in perdita"
Assets:Crypto:Binance:ADA -1000 ADA {0.60 USD}
Assets:Crypto:Binance:USD 445.00 USD
Expenses:Crypto:Fees:Trading 5.00 USD
Assets:Crypto:Binance:USD -5.00 USD
Expenses:CapitalLoss:Crypto 150.00 USDPlusvalenze a Lungo Termine
; Modello: Vendita plusvalenze a lungo termine
YYYY-MM-DD * "Vendita a lungo termine - [CRYPTO] detenuta > 1 anno"
date-acquired: "[DATA_ACQUISTO]"
holding-period: "[GIORNI] giorni"
Assets:Crypto:[EXCHANGE]:[CRYPTO] -[IMPORTO] [CRYPTO] {[BASE_COSTO] USD}
Assets:Crypto:[EXCHANGE]:USD [RICAVO] USD
Expenses:Crypto:Fees:Trading [COMMISSIONE] USD
Assets:Crypto:[EXCHANGE]:USD -[COMMISSIONE] USD
Income:CapitalGains:LongTerm [GUADAGNO] USD
; Esempio: Vendita BTC a lungo termine
2025-02-01 * "Vendita a lungo termine - BTC detenuta 382 giorni"
date-acquired: "2024-01-15"
holding-period: "382 giorni"
Assets:Crypto:Coinbase:BTC -1.0 BTC {45000.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 9950.00 USDModelli di Riconciliazione
Verifica Saldo Mensile
; Modello: Asserzioni di saldo mensili
YYYY-MM-DD balance Assets:Crypto:[EXCHANGE]:[CRYPTO] [SALDO_ATTESO] [CRYPTO]
YYYY-MM-DD balance Assets:Crypto:Wallet:[WALLET]:[CRYPTO] [SALDO_ATTESO] [CRYPTO]
; Esempio: Verifica saldo gennaio
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 BTCAggiornamenti Prezzo
; Modello: Aggiornamenti prezzo giornalieri
YYYY-MM-DD price [CRYPTO] [PREZZO] USD
; Esempio: Prezzi giornalieri
2024-01-15 price BTC 45000.00 USD
2024-01-15 price ETH 2500.00 USD
2024-01-15 price ADA 0.50 USDIstruzioni per l'Uso
- Copia il modello pertinente per il tuo tipo di transazione
- Sostituisci i segnaposto (mostrati tra [PARENTESI]) con i valori reali
- Modifica i nomi dei conti per corrispondere alla tua struttura contabile
- Aggiungi metadati se necessario per la dichiarazione fiscale o il monitoraggio
- Verifica i calcoli prima di finalizzare le registrazioni
Best Practice
- Utilizza convenzioni di denominazione coerenti
- Includi ID transazione nei metadati
- Documenta a fondo le transazioni complesse
- Verifica tassi di cambio e prezzi
- Mantieni backup regolari dei tuoi file
Questi modelli forniscono una solida base per la contabilità delle criptovalute su Beancount.io. Personalizzali in base alle tue esigenze specifiche e ai tuoi modelli di trading.