Pular para o conteúdo principal
Modelos e Exemplos de Criptomoedas

Modelos e Exemplos de Criptomoedas

Modelos práticos de Beancount e exemplos do mundo real para cenários comuns de criptomoedas, incluindo negociação, mineração, staking, airdrops e atividades DeFi.

Este guia fornece modelos práticos de Beancount e exemplos do mundo real para cenários comuns de criptomoedas. Copie e adapte estes modelos para as suas próprias necessidades de contabilidade de criptomoedas.

Explore um exemplo ao vivo de livro-razão de criptomoedas:

Modelo de Configuração Básica

Modelo de Estrutura de Contas

; =============================================================================
; MODELO DE CONFIGURAÇÃO DE CONTAS DE CRIPTOMOEDAS
; =============================================================================
 
; Contas de 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
 
; Contas de Carteira
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
 
; Contas de Protocolo 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
 
; Contas de Receita
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
 
; Contas de Despesa
1970-01-01 open Expenses:Crypto:Fees:Trading
1970-01-01 open Expenses:Crypto:Fees:Network
1970-01-01 open Expenses:Crypto:Fees:Withdrawal
 
; Definições de Commodities
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"

Modelos de Negociação

Compra Básica de Criptomoeda

; Modelo: Comprar criptomoeda na exchange
YYYY-MM-DD * "Comprar [AMOUNT] [CRYPTO] na [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
 
; Exemplo: Comprar 1 BTC na Coinbase
2024-01-15 * "Comprar 1 BTC na 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 Criptomoeda

; Modelo: Vender criptomoeda na exchange
YYYY-MM-DD * "Vender [AMOUNT] [CRYPTO] na [EXCHANGE]"
  Assets:Crypto:[EXCHANGE]:[CRYPTO]    -[AMOUNT] [CRYPTO] {[COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE]:USD          [PROCEEDS] USD
  Expenses:Crypto:Fees:Trading          [FEE] USD
  Assets:Crypto:[EXCHANGE]:USD         -[FEE] USD
  Income:CapitalGains:Crypto            [GAIN] USD  ; ou Expenses:CapitalLoss:Crypto
 
; Exemplo: Vender 0.5 BTC com lucro
2024-03-20 * "Vender 0.5 BTC na 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 - 30

Troca Crypto-para-Crypto

; Modelo: Trocar uma criptomoeda por outra
YYYY-MM-DD * "Trocar [AMOUNT1] [CRYPTO1] por [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  ; Evento tributável
  Expenses:Crypto:Fees:Trading          [FEE] USD
  Assets:Crypto:[EXCHANGE]:USD         -[FEE] USD
 
; Exemplo: Trocar BTC por ETH
2024-02-10 * "Trocar 1 BTC por 20 ETH na 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 USD

Modelos de Transferência

Transferência de Exchange para Carteira

; Modelo: Transferir criptomoeda da exchange para a carteira
YYYY-MM-DD * "Transferir [AMOUNT] [CRYPTO] da [EXCHANGE] para [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}
 
; Exemplo: Transferir BTC para Ledger
2024-01-20 * "Transferir 1 BTC da Coinbase para 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}

Transferência Entre Exchanges

; Modelo: Transferir entre exchanges
YYYY-MM-DD * "Transferir [AMOUNT] [CRYPTO] da [EXCHANGE1] para [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}
 
; Exemplo: Transferir ETH da Coinbase para Binance
2024-02-05 * "Transferir 10 ETH da Coinbase para 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}

Modelos de Staking

Ethereum Staking

; Modelo: Fazer staking de ETH
YYYY-MM-DD * "Fazer staking de [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}
 
; Exemplo: Fazer staking de 32 ETH
2024-01-10 * "Fazer staking de 32 ETH no 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}

Recompensas de Staking

; Modelo: Receber recompensas de staking
YYYY-MM-DD * "Recompensas de Staking de [CRYPTO] - [PERIOD]"
  Assets:Staking:[PROTOCOL]:[CRYPTO]    [AMOUNT] [CRYPTO] {[PRICE] USD}
  Income:Crypto:Staking:[CRYPTO]        [VALUE] USD
 
; Exemplo: Recompensas de staking de ETH
2024-02-01 * "Recompensas de Staking de ETH - Janeiro"
  Assets:Staking:Ethereum:ETH     0.08 ETH {2600.00 USD}
  Income:Crypto:Staking:ETH      208.00 USD

Modelos DeFi

Provisão de Liquidez Uniswap

; Modelo: Adicionar liquidez ao pool Uniswap
YYYY-MM-DD * "Adicionar liquidez ao pool [TOKEN1]-[TOKEN2]"
  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}
 
; Exemplo: Adicionar liquidez ETH-USDC
2024-01-15 * "Adicionar liquidez ao 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}

Empréstimo Compound

; Modelo: Fornecer ativos para o Compound
YYYY-MM-DD * "Fornecer [AMOUNT] [TOKEN] para o Compound"
  Assets:Crypto:Wallet:MetaMask:[TOKEN]  -[AMOUNT] [TOKEN]
  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}
 
; Exemplo: Fornecer 10000 USDC para o Compound
2024-01-20 * "Fornecer 10000 USDC para o 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}

Modelos de Mineração

Recompensas de Mineração

; Modelo: Receber recompensas de mineração
YYYY-MM-DD * "Recompensa de Mineração de [CRYPTO] - [POOL/SOLO]"
  Assets:Crypto:Mining:[CRYPTO]     [AMOUNT] [CRYPTO] {[PRICE] USD}
  Income:Crypto:Mining:[CRYPTO]     [VALUE] USD
 
; Exemplo: Recompensa de mineração de Bitcoin
2024-01-15 * "Recompensa de Mineração de BTC - Slush Pool"
  Assets:Crypto:Mining:BTC    0.01 BTC {45000.00 USD}
  Income:Crypto:Mining:BTC   450.00 USD

Despesas de Mineração

; Modelo: Despesas operacionais de mineração
YYYY-MM-DD * "Mineração [EXPENSE_TYPE] - [PERIOD]"
  Expenses:Crypto:Mining:[EXPENSE_TYPE]  [AMOUNT] USD
  Assets:Checking                       -[AMOUNT] USD
 
; Exemplo: Custos de eletricidade de mineração
2024-01-31 * "Eletricidade de Mineração - Janeiro"
  Expenses:Crypto:Mining:Electricity  800.00 USD
  Assets:Checking                    -800.00 USD

Modelos de Airdrop

Airdrops de Tokens

; Modelo: Receber airdrop de token
YYYY-MM-DD * "Airdrop de [TOKEN] do [PROJECT]"
  Assets:Crypto:Wallet:[WALLET]:[TOKEN]  [AMOUNT] [TOKEN] {[PRICE] USD}
  Income:Crypto:Airdrops                 [VALUE] USD
 
; Exemplo: Airdrop de token UNI
2024-03-01 * "Airdrop de UNI do Uniswap"
  Assets:Crypto:Wallet:MetaMask:UNI  400 UNI {8.00 USD}
  Income:Crypto:Airdrops            3200.00 USD

Modelos Avançados

Arbitragem de Flash Loan

; Modelo: Arbitragem de flash loan
YYYY-MM-DD * "Arbitragem de flash loan - [STRATEGY]"
  ; Flash loan
  Assets:Crypto:Temp:FlashLoan       [LOAN_AMOUNT] [TOKEN]
  Liabilities:DeFi:[PROTOCOL]:Flash -[LOAN_AMOUNT] [TOKEN]
  
  ; Execução da arbitragem
  Assets:Crypto:Temp:FlashLoan      -[LOAN_AMOUNT] [TOKEN]
  Assets:Crypto:Temp:Arbitrage       [RETURN_AMOUNT] [TOKEN]
  
  ; Reembolsar o flash loan
  Liabilities:DeFi:[PROTOCOL]:Flash  [LOAN_AMOUNT] [TOKEN]
  Assets:Crypto:Temp:Arbitrage      -[LOAN_PLUS_FEE] [TOKEN]
  
  ; Lucro
  Assets:Crypto:Wallet:[WALLET]:[TOKEN]  [PROFIT] [TOKEN]
  Income:Crypto:Arbitrage               [PROFIT_USD] USD

Ponte Cross-Chain

; Modelo: Ligar ativos entre chains
YYYY-MM-DD * "Ligar [AMOUNT] [TOKEN] de [CHAIN1] para [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}
 
; Exemplo: Ligar ETH para Polygon
2024-02-05 * "Ligar 5 ETH do Ethereum para 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}

Modelos Otimizados para Impostos

Recolha de Perdas Fiscais (Tax Loss Harvesting)

; Modelo: Recolha de perdas fiscais - Vender [CRYPTO] com perda
YYYY-MM-DD * "Recolha de perdas fiscais - Vender [CRYPTO] com perda"
  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
 
; Exemplo: Recolher perda de ADA
2024-12-15 * "Recolha de perdas fiscais - Vender ADA com perda"
  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 USD

Ganhos de Capital de Longo Prazo

; Modelo: Venda de ganhos de capital de longo prazo
YYYY-MM-DD * "Venda de longo prazo - [CRYPTO] mantido > 1 ano"
  date-acquired: "[PURCHASE_DATE]"
  holding-period: "[DAYS] days"
  Assets:Crypto:[EXCHANGE]:[CRYPTO]    -[AMOUNT] [CRYPTO] {[COST_BASIS] USD}
  Assets:Crypto:[EXCHANGE]:USD          [PROCEEDS] USD
  Expenses:Crypto:Fees:Trading          [FEE] USD
  Assets:Crypto:[EXCHANGE]:USD         -[FEE] USD
  Income:CapitalGains:LongTerm          [GAIN] USD
 
; Exemplo: Venda de BTC de longo prazo
2025-02-01 * "Venda de longo prazo - BTC mantido por 382 dias"
  date-acquired: "2024-01-15"
  holding-period: "382 days"
  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 USD

Modelos de Reconciliação

Verificação Mensal de Saldo

; Modelo: Declarações mensais de saldo
YYYY-MM-DD balance Assets:Crypto:[EXCHANGE]:[CRYPTO]  [EXPECTED_BALANCE] [CRYPTO]
YYYY-MM-DD balance Assets:Crypto:Wallet:[WALLET]:[CRYPTO]  [EXPECTED_BALANCE] [CRYPTO]
 
; Exemplo: Verificação de saldo de janeiro
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

Atualizações de Preços

; Modelo: Atualizações diárias de preços
YYYY-MM-DD price [CRYPTO] [PRICE] USD
 
; Exemplo: Preços diários
2024-01-15 price BTC 45000.00 USD
2024-01-15 price ETH 2500.00 USD
2024-01-15 price ADA 0.50 USD

Instruções de Uso

  1. Copie o modelo relevante para o seu tipo de transação
  2. Substitua os placeholders (mostrados em [BRACKETS]) com os valores reais
  3. Ajuste os nomes das contas para corresponder à sua estrutura de contas
  4. Adicione metadados conforme necessário para relatórios fiscais ou rastreamento
  5. Verifique os cálculos antes de finalizar as entradas

Melhores Práticas

  • Use convenções de nomenclatura consistentes
  • Inclua IDs de transação em metadados
  • Documente transações complexas completamente
  • Verifique as taxas de câmbio e os preços
  • Mantenha backups regulares dos seus arquivos

Estes modelos fornecem uma base sólida para a contabilidade de criptomoedas no Beancount.io. Personalize-os com base nas suas necessidades específicas e padrões de negociação.