diff --git a/README.md b/README.md index 43d403d..3887a50 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,21 @@ First off: Here's to you, [Bittr](https://getbittr.com/) – you will be missed! This script is not a full replacement for the incredible service Bittr offered, but it's a start: Automate your Stacking Sats process by regularly placing buy orders using the [Kraken API](https://www.kraken.com/features/api). +Holding significant amounts on an exchange is never a good idea. You should regularly take ownership of your coins by withdrawing to your own wallet. This can either be done manually or it can be automated. The script provided here will only withdraw to a previously defined Bitcoin address if the relative fees do not exceed a certain limit. +*It is optional to run the witdrawal script.* + +**Example 1** +- Max. relative fee: 0.5% +- Fixed Kraken fee: ₿ 0.00050 +- Balance: ₿ 0.06000 +- \> No withdrawal since fee actual (0.83%) is too high + +**Example 2** +- Max. relative fee: 0.5% +- Fixed Kraken fee: ₿ 0.00050 +- Balance: ₿ 0.12000 +- \> Withdrawal executed since actual fee (0.42%) is low enough + ## ✋ Caveat You need to install the dependency [kraken-api](https://github.com/nothingisdead/npm-kraken-api), which is a third-party package. @@ -20,6 +35,11 @@ Generate a new API key dedicated for stacking using the "Query Funds" and "Modif ![Kraken API Key Permissions](./api-permissions.png) +Only check the "Withdraw Funds" option if you plan to automatically withdraw Bitcoin from Kraken. + +## 🔑 Withrawal method +In case you plan to automatically withdraw from Kraken, a withdrawal method must first be defined. If you already set up a methode you can reuse it. Otherwise generate a new one by going to **Funding** > **Bitcoin (XBT) withdraw** > **Add address**. The description field will later be used as an environment variable in the script. + ## 📦 Setup Prerequisite: At least the current LTS version of [Node.js](https://nodejs.org/). @@ -33,10 +53,15 @@ npm install Setup the environment variables for the script: ```sh +# used to authenticate with Kraken export KRAKEN_API_KEY="apiKeyFromTheKrakenSettings" export KRAKEN_API_SECRET="privateKeyFromTheKrakenSettings" +# used only for buying export KRAKEN_API_FIAT="USD" # the governmental shitcoin you are selling export KRAKEN_BUY_AMOUNT=21 # fiat amount you trade for the future of money +# used only for withdrawing +export KRAKEN_MAX_REL_FEE=0.5 # maximum fee in % that you are willing to pay +export KRAKEN_WITHDRAW_KEY="descriptionOfWithdrawalAddress" ``` Use a dry run to test the script and see the output without placing an order: @@ -57,6 +82,20 @@ You should see something like this sample output: 📎 Transaction ID: 2121212121 ``` +To test the withdrawal of funds to your defined address run: +```sh +npm run test-withdraw-sats +``` +You should see something like this: +```text +💡 Relative fee of withdrawal amount: 5.57% + +❌ Don't withdraw now. Fee is too high. Max rel. fee: 0.50% + +🚨 THIS WAS JUST A VALIDATION RUN, NO WITHDRAWAL HAS BEEN PLACED! + +``` + ## 🤑 Stack sats When you are good to go, execute this command in a regular interval: @@ -98,6 +137,37 @@ Make it executable with `chmod +x stack-sats.sh` and go wild. [Stay humble!](https://twitter.com/matt_odell/status/1117222441867194374) 🙏 +## 🔑 Withraw sats + +It is recommended to run the withdrawal script every time you stacked sats: + +```sh +npm run withdraw-sats +``` +Since it can take a couple seconds or minutes for your order to fill, you should run the following script maybe a couple hours later after your `stack-sats` script ran. Just set up a second cron job which executes the following script. + +Here's a sample `withdraw-sats.sh` script: + +```sh +#!/bin/bash +set -e + +# hide deprecation warning +export NODE_OPTIONS="--no-deprecation" + +export KRAKEN_API_KEY="apiKeyFromTheKrakenSettings" +export KRAKEN_API_SECRET="privateKeyFromTheKrakenSettings" +export KRAKEN_MAX_REL_FEE=0.5 +export KRAKEN_WITHDRAW_KEY="descriptionOfWithdrawalAddress" + +BASE_DIR=$(cd `dirname $0` && pwd) +cd $BASE_DIR/stacking-sats-kraken +result=$(npm run withdraw-sats 2>&1) +echo $result +``` + +Make it executable with `chmod +x withdraw-sats.sh` and add it to your cron schedule. + ## ⚡️ RaspiBlitz Integration This script ships with the [RaspiBlitz](https://github.com/rootzoll/raspiblitz) (v1.6 and above). diff --git a/api-permissions.png b/api-permissions.png index 3193fe0..49c7593 100644 Binary files a/api-permissions.png and b/api-permissions.png differ diff --git a/package.json b/package.json index fe33864..dfc1a13 100644 --- a/package.json +++ b/package.json @@ -8,6 +8,8 @@ "main": "index.js", "scripts": { "stack-sats": "node index.js", + "withdraw-sats": "node withdraw.js", + "test-withdraw-sats": "node withdraw.js --validate", "test": "node index.js --validate" }, "dependencies": { diff --git a/withdraw.js b/withdraw.js new file mode 100644 index 0000000..cc315b3 --- /dev/null +++ b/withdraw.js @@ -0,0 +1,47 @@ +const assert = require('assert') +const Kraken = require('kraken-api') + +const { + KRAKEN_API_KEY: key, + KRAKEN_API_SECRET: secret, + KRAKEN_MAX_REL_FEE: max_fee, + KRAKEN_WITHDRAW_KEY: wdr_key +} = process.env + +assert(key && secret, 'Provide the KRAKEN_API_KEY and KRAKEN_API_SECRET environment variables.') +assert(max_fee && wdr_key, 'Provide the KRAKEN_MAX_REL_FEE and KRAKEN_WITHDRAW_KEY environment variables.') + +// https://www.kraken.com/features/api +const kraken = new Kraken(key, secret) +const crypto = 'XBT' +const validate = process.argv[2] === '--validate' + +;(async () => { + // Get withdrawal information + // URL: https://api.kraken.com/0/private/WithdrawInfo + const withdrawdetails = { asset: crypto, key: wdr_key, amount: 0 } + try { + const { result: { method, limit, fee } } = await kraken.api('WithdrawInfo', withdrawdetails); + const rel_fee = 1/parseFloat(limit)*parseFloat(fee) + console.log(`💡 Relative fee of withdrawal amount: ${(rel_fee*100).toFixed(2)}%`) + + // Place withdrawal when fee is low enough (relatively) + if (rel_fee < max_fee/100) { + console.log(`⏏️ Withdraw ${limit} ${crypto} now.`) + const withdraw = { asset: crypto, key: wdr_key, amount: limit } + if (!validate) { + try { + const { result: { refid } } = await kraken.api('Withdraw', withdraw) + if (refid) console.log(`📎 Withdrawal reference ID: ${refid}`) + } catch (err) { + console.log(`\n🚨 Failure:`, err.message) + } + } + }else{ + console.log(`\n❌ Don\'t withdraw now. Fee is too high. Max rel. fee: ${parseFloat(max_fee).toFixed(2)}%`); + } + } catch (err) { + console.log(`\n🚨 Failure:`, err.message) + } + if (validate) console.log('\n🚨 THIS WAS JUST A VALIDATION RUN, NO WITHDRAWAL HAS BEEN PLACED!') +})()