Files
docker-finance/container/src/hledger-flow/accounts/bittrex/bittrex-shared.rules
Aaron Fiore f228da98d8 hledger-flow: bittrex: cost-basis work-around for bitcoin.tax
Issue #51 describes at least a few undocumented bitcoin.tax issues:

  - Bicoin.tax gives unexpected cost-basis results when `Fee` is given
    with `Total` (when `Total` is given in place of `Price`). The
    expectation is that bitcoin.tax will perform the cost-basis
    calculation on `Total` when `Fee` is also given.

    However, bitcoin.tax *will* give expected cost-basis results if
    `Price` is given in place of `Total` (with `Fee` also given) *or* if
    `Total` is given *after* local cost-basis adjustments are made (but
    *without* `Fee` given).

    The rationale for why docker-finance doesn't use `Price`:

      * docker-finance has all of the `Total`s; so `Price` isn't
        necessary.

      * Local price information isn't available for most trades (and
        shouldn't be necessary since all `Total`s are available).

  - Additionally, when `Fee` is non-fiat (crypto), it now must be marked
    as a SPEND in order to be disposed (and to produce an accurate
    closing report).

  - Finally, if `FeeCurrency` *does* not match either `Symbol` or
    `Currency` (e.g., BTC-ETH w/ BNB fee), it's unknown if cost-basis
    must be calculated locally as well (if `Total` is given). Local
    calculations cannot be done because `Fee` price information is
    (almost certainly) not available for this type of trade.

Until upstream can assert that attaching the `Fee` will subsequently
adjust the cost-basis of `Total` *and* dispose of the `Fee` in the
process (while also allowing `Total` to be used in place of `Price`),
the `Fee` (and `FeeCurrency`) column(s) must not be populated and values
instead moved to SPEND (as described above).

Upstream is aware of these issues (since May) and they're in the process
of resolution. In the meantime, docker-finance work-arounds should
suffice for all trades that have a fiat `Fee` and/or a
`Fee`/`FeeCurrency` that matches one side of the trading pair.
2024-07-29 16:15:50 -07:00

114 lines
4.3 KiB
Plaintext

# docker-finance | modern accounting for the power-user
#
# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
fields code_,date,type,order_type,currency_one,currency_two,amount_,proceeds,fees,cost_basis,destination,txid,direction,subaccount
date-format %Y-%m-%d %H:%M:%S
description %date +0000
account1 assets:bittrex:%subaccount:%currency_one
amount %amount_ %currency_one
comment type:%type, code:%code_, destination:%destination, txid:%txid
################################################################################
# #
# TRANSFER #
# #
################################################################################
if %direction ^OUT$
amount -%amount_ %currency_one
# Default transfers as equity accounts
if %direction ^IN$
account2 equity:bittrex:%subaccount:withdrawal:%currency_one
if %direction ^OUT$
account2 equity:bittrex:%subaccount:deposit:%currency_one
if %direction ^OUT$
& %fees [1-9]
account3 assets:bittrex:%subaccount:%currency_one
amount3 -%fees %currency_one
account4 expenses:bittrex:%subaccount:fees:withdrawals:%currency_one
amount4 %fees %currency_one
comment type:%type, code:%code_, destination:%destination, txid:%txid, taxed_as:SPEND
comment2 %date +0000,SPEND,bittrex,%currency_one,%fees,USD,,FEE
################################################################################
# #
# TRADE #
# #
################################################################################
if %type ^TRADE$
account1 assets:bittrex:%subaccount:%currency_one
amount %amount_ %currency_one @@ %proceeds %currency_two
account2 assets:bittrex:%subaccount:%currency_two
comment type:%type, order_type:%order_type, code:%code_, taxed_as:%order_type
if %type ^TRADE$
& %fees [1-9]
account3 assets:bittrex:%subaccount:%currency_two
amount3 -%fees %currency_two
account4 expenses:bittrex:%subaccount:fees:trades:%currency_two
amount4 %fees %currency_two
#
# BUY
#
if %type ^TRADE$
& %order_type ^BUY$
comment2 %date +0000,BUY,bittrex,%currency_one,%amount_,%currency_two,%cost_basis,,
if %type ^TRADE$
& %order_type ^BUY$
& %fees [1-9]
comment2 %date +0000,BUY,bittrex,%currency_one,%amount_,%currency_two,%cost_basis,%currency_two,%fees
# TODO: HACK: re: #51, FeeCurrency and Fee are added even though cost_basis is calculated (for non-fiat fee disposal, see lib_taxes)
# TODO: HACK: see #51 and respective lib_taxes work-around
if %type ^TRADE$
& %order_type ^BUY$
& %fees [1-9]
& %currency_two ^USD$
comment2 %date +0000,BUY,bittrex,%currency_one,%amount_,%currency_two,%cost_basis,,
#
# SELL
#
if %type ^TRADE$
& %order_type ^SELL$
amount -%amount_ %currency_one @@ %proceeds %currency_two
comment2 %date +0000,SELL,bittrex,%currency_one,%amount_,%currency_two,%cost_basis,,
if %type ^TRADE$
& %order_type ^SELL$
& %fees [1-9]
comment2 %date +0000,SELL,bittrex,%currency_one,%amount_,%currency_two,%cost_basis,%currency_two,%fees
# TODO: HACK: re: #51, FeeCurrency and Fee are added even though cost_basis is calculated (for non-fiat fee disposal, see lib_taxes)
# TODO: HACK: see #51 and respective lib_taxes work-around
if %type ^TRADE$
& %order_type ^SELL$
& %fees [1-9]
& %currency_two ^USD$
comment2 %date +0000,SELL,bittrex,%currency_one,%amount_,%currency_two,%cost_basis,,
# vim: sw=2 sts=2 si ai et