docker-finance | modern accounting for the power-user

Dedicated to Michael Morgan: a beautiful, beautiful soul. --- Internal signing keys: Aaron Fiore (sole author) - 518A22F85BEFD32BCC99C48603F90C4F35E0213E - 31ECA5C347A0CC0815EDE730A3EACCFCDA7E685E - C8187C585CB07A4DA81CC0F37318B50EBE9C0DA8 Internal repositories (rebased from): Staging: $ git log -n1 --pretty=format:"%H" c8e0cd66f6c89fa7b3c62f72fb524a4cc454b7b6 $ git rev-list --max-parents=0 HEAD ac3863b8c234755855f1aea3a07a853122decdf2 Private: $ git log -n1 --pretty=format:"%H" 69bb3591eaa2990a9637832bb484690e00c4f926 $ git rev-list --max-parents=0 HEAD a5c1cc9fb593c4cf09bc0adfef6cb6d2964511ae
2024-03-04 03:12:40 -08:00
commit b621e87df2
505 changed files with 37687 additions and 0 deletions
--- a/container/src/hledger-flow/accounts/bittrex/bittrex-shared.bash
+++ b/container/src/hledger-flow/accounts/bittrex/bittrex-shared.bash
@@ -0,0 +1,152 @@
+#!/usr/bin/env bash
+
+# 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/>.
+
+#
+# "Libraries"
+#
+
+[ -z "$DOCKER_FINANCE_CONTAINER_REPO" ] && exit 1
+source "${DOCKER_FINANCE_CONTAINER_REPO}/src/hledger-flow/lib/lib_preprocess.bash" "$1" "$2"
+
+#
+# Implementation
+#
+
+[ -z "$global_year" ] && exit 1
+[ -z "$global_subaccount" ] && exit 1
+
+[ -z "$global_in_path" ] && exit 1
+[ -z "$global_out_path" ] && exit 1
+
+#
+# Unified output format for all file types:
+#
+#   UID,Date,Type,OrderType,CurrencyOne,CurrencyTwo,Amount,Proceeds,Fees,Destination,TXID,Direction,Subaccount
+#
+
+function parse_deposit()
+{
+  # NOTE: headers can be variable, not possible to assert
+  xsv select "id,completedAt,currencySymbol,quantity,cryptoAddress,txId" "$global_in_path" \
+    | gawk -v global_year="$global_year" -v global_subaccount="$global_subaccount" \
+      '{
+         if (NR<2 || $2 !~ global_year)
+           next
+
+         cmd = "date --utc \"+%F %T\" --date="$2 | getline date
+
+         printf $1 OFS                   # UID
+         printf date OFS                 # Date
+         printf "DEPOSIT" OFS            # Type
+         printf OFS                      # OrderType
+         printf $3 OFS                   # CurrencyOne
+         printf OFS                      # CurrencyTwo
+         printf("%.8f", $4); printf OFS  # Amount
+         printf OFS                      # Proceeds
+         printf OFS                      # Fees
+         printf $5 OFS                   # Destination
+         printf $6 OFS                   # TXID
+         printf "IN" OFS                 # Direction
+         printf global_subaccount        # Subaccount
+
+         printf "\n"
+
+      }' FS=, OFS=, >"$global_out_path"
+}
+
+function parse_trade()
+{
+  # NOTE:
+  #  - Commissions are paid in base currency (one on the left)
+  #  - Proceeds are divided by quantity.
+  #    WARNING: don't use limit because market orders will be empty
+
+  # NOTE: headers can be variable, not possible to assert
+  xsv select "id,closedAt,direction,marketSymbol,fillQuantity,proceeds,commission" "$global_in_path" \
+    | gawk -v global_year="$global_year" -v global_subaccount="$global_subaccount" \
+      '{
+         if (NR<2 || $2 !~ global_year)
+           next
+
+         cmd = "date --utc \"+%F %T\" --date="$2 | getline date
+
+         # For trades, Bittrex doesnt create separate columns for pairs.
+         # So, turn BTC-USD into two separate columns.
+         sub(/-/, ",", $4)
+
+         printf $1 OFS                   # UID
+         printf date OFS                 # Date
+         printf "TRADE" OFS              # Type
+         printf $3 OFS                   # OrderType
+         printf $4 OFS                   # CurrencyOne
+         # see above                     # CurrencyTwo
+         printf("%.8f", $5); printf OFS  # Amount
+         printf("%.8f", $6); printf OFS  # Proceeds
+         printf("%.8f", $7); printf OFS  # Fees
+         printf OFS                      # Destination
+         printf OFS                      # TXID
+         printf OFS                      # Direction
+         printf global_subaccount        # Subaccount
+
+         printf "\n"
+
+      }' FS=, OFS=, >"$global_out_path"
+}
+
+function parse_withdrawal()
+{
+  # NOTE: headers can be variable, not possible to assert
+  xsv select "id,completedAt,currencySymbol,quantity,txCost,cryptoAddress,txId" "$global_in_path" \
+    | gawk -v global_year="$global_year" -v global_subaccount="$global_subaccount" \
+      '{
+         if (NR<2 || $2 !~ global_year)
+           next
+
+         cmd = "date --utc \"+%F %T\" --date="$2 | getline date
+
+         printf $1 OFS                   # UID
+         printf date OFS                 # Date
+         printf "WITHDRAWAL" OFS         # Type
+         printf OFS                      # OrderType
+         printf $3 OFS                   # CurrencyOne
+         printf OFS                      # CurrencyTwo
+         printf("%.8f", $4); printf OFS  # Amount
+         printf OFS                      # Proceeds
+         printf("%.8f", $5); printf OFS  # Fees
+         printf $6 OFS                   # Destination
+         printf $7 OFS                   # TXID
+         printf "OUT" OFS                # Direction
+         printf global_subaccount        # Subaccount
+
+         printf "\n"
+
+      }' FS=, OFS=, >"$global_out_path"
+}
+
+function main()
+{
+  # REST API provided files
+  lib_preprocess::test_header "source" && parse_deposit && return 0
+  lib_preprocess::test_header "direction" && parse_trade && return 0
+  lib_preprocess::test_header "txCost" && parse_withdrawal && return 0
+}
+
+main "$@"
+
+# vim: sw=2 sts=2 si ai et
--- a/container/src/hledger-flow/accounts/bittrex/bittrex-shared.rules
+++ b/container/src/hledger-flow/accounts/bittrex/bittrex-shared.rules
@@ -0,0 +1,77 @@
+# 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,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
+  comment2 %date +0000,BUY,bittrex,%currency_one,%amount_,%currency_two,%proceeds,,
+
+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
+  comment2 %date +0000,BUY,bittrex,%currency_one,%amount_,%currency_two,%proceeds,%currency_two,%fees
+
+if %type ^TRADE$
+& %order_type ^SELL$
+  amount -%amount_ %currency_one @@ %proceeds %currency_two
+  comment2 %date +0000,SELL,bittrex,%currency_one,%amount_,%currency_two,%proceeds,%currency_two,%fees
+
+# vim: sw=2 sts=2 si ai et
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex-shared.bash
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex-shared.bash
@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+# 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/>.
+
+[ -z "$DOCKER_FINANCE_CONTAINER_REPO" ] && exit 1
+source "${DOCKER_FINANCE_CONTAINER_REPO}/src/hledger-flow/accounts/bittrex/bittrex-shared.bash"
+
+# vim: sw=2 sts=2 si ai et
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex-shared.rules
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex-shared.rules
@@ -0,0 +1,20 @@
+# 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/>.
+
+include ../../../../../src/accounts/bittrex/bittrex-shared.rules
+
+# vim: sw=2 sts=2 si ai et
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2021/deposits.csv
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2021/deposits.csv
@@ -0,0 +1,10 @@
+id,currencySymbol,quantity,cryptoAddress,txId,confirmations,updatedAt,completedAt,status,source
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2023-01-01T01:01:01.01Z,2023-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2023-01-01T01:01:01.01Z,2023-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2023-01-01T01:01:01.01Z,2023-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2022-01-01T01:01:01.01Z,2022-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2022-01-01T01:01:01.01Z,2022-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2022-01-01T01:01:01.01Z,2022-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2021-01-01T01:01:01.01Z,2021-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2021-01-01T01:01:01.01Z,2021-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2021-01-01T01:01:01.01Z,2021-01-01T01:01:01.01Z,COMPLETED,BLOCKCHAIN
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2021/trades.csv
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2021/trades.csv
@@ -0,0 +1,10 @@
+id,marketSymbol,direction,type,quantity,timeInForce,fillQuantity,commission,proceeds,status,createdAt,updatedAt,closedAt,limit
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,SELL,MARKET,0.00123456,IMMEDIATE_OR_CANCEL,0.00123456,0.07423505,41.24169945,CLOSED,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,SELL,LIMIT,0.01234567,POST_ONLY_GOOD_TIL_CANCELLED,0.01234567,0.49490319,412.41933297,CLOSED,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,33405.990357140000
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH-USD,SELL,LIMIT,0.01234567,GOOD_TIL_CANCELLED,0.01234567,0.04909458,40.91215145,CLOSED,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,1368.66445481
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,SELL,MARKET,0.00123456,IMMEDIATE_OR_CANCEL,0.00123456,0.07423505,41.24169945,CLOSED,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,SELL,LIMIT,0.01234567,POST_ONLY_GOOD_TIL_CANCELLED,0.01234567,0.49490319,412.41933297,CLOSED,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,33405.990357140000
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH-USD,SELL,LIMIT,0.01234567,GOOD_TIL_CANCELLED,0.01234567,0.04909458,40.91215145,CLOSED,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,1368.66445481
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,SELL,MARKET,0.00123456,IMMEDIATE_OR_CANCEL,0.00123456,0.07423505,41.24169945,CLOSED,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,SELL,LIMIT,0.01234567,POST_ONLY_GOOD_TIL_CANCELLED,0.01234567,0.49490319,412.41933297,CLOSED,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,33405.990357140000
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH-USD,SELL,LIMIT,0.01234567,GOOD_TIL_CANCELLED,0.01234567,0.04909458,40.91215145,CLOSED,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,1368.66445481
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2021/withdrawals.csv
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2021/withdrawals.csv
@@ -0,0 +1,7 @@
+id,currencySymbol,quantity,cryptoAddress,fundsTransferMethodId,txCost,txId,status,createdAt,completedAt,target
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,150.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,123,COMPLETED,2023-03-03T03:03:03.03Z,2023-03-03T03:03:03.03Z,WIRE_TRANSFER
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.01234567,3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,,0.00050000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2023-03-03T03:03:03.03Z,2023-03-03T03:03:03.03Z,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,150.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,123,COMPLETED,2022-03-03T03:03:03.03Z,2022-03-03T03:03:03.03Z,WIRE_TRANSFER
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.01234567,3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,,0.00050000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2022-03-03T03:03:03.03Z,2022-03-03T03:03:03.03Z,BLOCKCHAIN
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,150.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,123,COMPLETED,2021-03-03T03:03:03.03Z,2021-03-03T03:03:03.03Z,WIRE_TRANSFER
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.01234567,3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,,0.00050000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2021-03-03T03:03:03.03Z,2021-03-03T03:03:03.03Z,BLOCKCHAIN
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2022/deposits.csv
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2022/deposits.csv
@@ -0,0 +1,10 @@
+id,currencySymbol,quantity,cryptoAddress,txId,confirmations,updatedAt,completedAt,status,source,fundsTransferMethodId
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2023-01-01T01:01:01.01Z,2023-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2023-01-01T01:01:01.01Z,2023-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,3,2023-01-01T01:01:01.01Z,2023-01-01T00:01:01.01Z,COMPLETED,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2022-01-01T01:01:01.01Z,2022-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2022-01-01T01:01:01.01Z,2022-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,3,2022-01-01T01:01:01.01Z,2022-01-01T00:01:01.01Z,COMPLETED,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2021-01-01T01:01:01.01Z,2021-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2021-01-01T01:01:01.01Z,2021-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,3,2021-01-01T01:01:01.01Z,2021-01-01T00:01:01.01Z,COMPLETED,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2022/trades.csv
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2022/trades.csv
@@ -0,0 +1,4 @@
+id,marketSymbol,direction,type,quantity,timeInForce,fillQuantity,commission,proceeds,status,createdAt,updatedAt,closedAt,limit,ceiling,clientOrderId
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,BUY,LIMIT,0.00123456,GOOD_TIL_CANCELLED,0.00123456,0.08630099,47.94499554,CLOSED,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,38835.694943220000,,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,BUY,LIMIT,0.00123456,GOOD_TIL_CANCELLED,0.00123456,0.08630099,47.94499554,CLOSED,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,38835.694943220000,,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC-USD,BUY,LIMIT,0.00123456,GOOD_TIL_CANCELLED,0.00123456,0.08630099,47.94499554,CLOSED,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,38835.694943220000,,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2022/withdrawals.csv
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2022/withdrawals.csv
@@ -0,0 +1,7 @@
+id,currencySymbol,quantity,cryptoAddress,txCost,txId,status,createdAt,completedAt,target,fundsTransferMethodId
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.02345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.00030000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2023-03-03T03:03:03.03Z,2023-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,200.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,COMPLETED,2023-03-03T03:03:03.03Z,2023-03-03T03:03:03.03Z,WIRE_TRANSFER,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.02345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.00030000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2022-03-03T03:03:03.03Z,2022-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,200.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,COMPLETED,2022-03-03T03:03:03.03Z,2022-03-03T03:03:03.03Z,WIRE_TRANSFER,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.02345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.00030000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2021-03-03T03:03:03.03Z,2021-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,200.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,COMPLETED,2021-03-03T03:03:03.03Z,2021-03-03T03:03:03.03Z,WIRE_TRANSFER,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2023/deposits
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2023/deposits
@@ -0,0 +1,10 @@
+id,currencySymbol,quantity,cryptoAddress,txId,confirmations,updatedAt,completedAt,status,source,fundsTransferMethodId
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2023-01-01T01:01:01.01Z,2023-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2023-01-01T01:01:01.01Z,2023-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,3,2023-01-01T01:01:01.01Z,2023-01-01T00:01:01.01Z,COMPLETED,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2022-01-01T01:01:01.01Z,2022-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2022-01-01T01:01:01.01Z,2022-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,3,2022-01-01T01:01:01.01Z,2022-01-01T00:01:01.01Z,COMPLETED,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,1.23456789,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,1234,2021-01-01T01:01:01.01Z,2021-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.12345678,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,123,2021-01-01T01:01:01.01Z,2021-01-01T00:01:01.01Z,COMPLETED,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,100.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,3,2021-01-01T01:01:01.01Z,2021-01-01T00:01:01.01Z,COMPLETED,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2023/trades.csv
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2023/trades.csv
@@ -0,0 +1,4 @@
+id,marketSymbol,direction,type,ceiling,timeInForce,fillQuantity,commission,proceeds,status,createdAt,updatedAt,closedAt,quantity
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,LTC-ETH,BUY,CEILING_MARKET,0.12345678,IMMEDIATE_OR_CANCEL,1.21733246,0.00057887,0.12345678,CLOSED,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,2023-02-02T02:02:02.02Z,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,LTC-ETH,BUY,CEILING_MARKET,0.12345678,IMMEDIATE_OR_CANCEL,1.21733246,0.00057887,0.12345678,CLOSED,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,2022-02-02T02:02:02.02Z,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,LTC-ETH,BUY,CEILING_MARKET,0.12345678,IMMEDIATE_OR_CANCEL,1.21733246,0.00057887,0.12345678,CLOSED,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,2021-02-02T02:02:02.02Z,
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2023/withdrawals.csv
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/1-in/mockup/2023/withdrawals.csv
@@ -0,0 +1,13 @@
+id,currencySymbol,quantity,cryptoAddress,txCost,txId,status,createdAt,completedAt,target,fundsTransferMethodId
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,3.45678910,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.05000000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2023-03-03T03:03:03.03Z,2023-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,LTC,0.12345678,ltc1qXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.01000000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2023-03-03T03:03:03.03Z,2023-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.32109876,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.00030000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2023-03-03T03:03:03.03Z,2023-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,250.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,COMPLETED,2023-03-03T03:03:03.03Z,2023-03-03T03:03:03.03Z,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,3.45678910,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.05000000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2022-03-03T03:03:03.03Z,2022-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,LTC,0.12345678,ltc1qXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.01000000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2022-03-03T03:03:03.03Z,2022-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.32109876,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.00030000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2022-03-03T03:03:03.03Z,2022-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,250.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,COMPLETED,2022-03-03T03:03:03.03Z,2022-03-03T03:03:03.03Z,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,ETH,3.45678910,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.05000000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2021-03-03T03:03:03.03Z,2021-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,LTC,0.12345678,ltc1qXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.01000000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2021-03-03T03:03:03.03Z,2021-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,BTC,0.32109876,1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,0.00030000,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,COMPLETED,2021-03-03T03:03:03.03Z,2021-03-03T03:03:03.03Z,BLOCKCHAIN,
+XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,USD,250.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,0.00000000,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX,COMPLETED,2021-03-03T03:03:03.03Z,2021-03-03T03:03:03.03Z,ACH,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/bittrex-exchange.rules
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/bittrex-exchange.rules
@@ -0,0 +1,20 @@
+# 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/>.
+
+include ../../bittrex-shared.rules
+
+# vim: sw=2 sts=2 si ai et
--- a/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/preprocess
+++ b/container/src/hledger-flow/accounts/bittrex/template/bittrex/exchange/preprocess
@@ -0,0 +1 @@
+../../bittrex-shared.bash