{"id":13417946,"url":"https://github.com/ctubio/Krypto-trading-bot","last_synced_at":"2025-03-15T02:32:05.511Z","repository":{"id":37839144,"uuid":"94253765","full_name":"ctubio/Krypto-trading-bot","owner":"ctubio","description":"Self-hosted crypto trading bot (automated high frequency market making) written in C++","archived":false,"fork":false,"pushed_at":"2024-10-22T03:42:29.000Z","size":13795,"stargazers_count":3368,"open_issues_count":62,"forks_count":824,"subscribers_count":238,"default_branch":"master","last_synced_at":"2024-10-29T14:53:19.448Z","etag":null,"topics":["binance","bitcoin","bitfinex","bitmex","bob-marley","bot-platform","coinbase","cryptocurrency","exchange","hitbtc","kraken","kucoin","market-data","market-maker","skate-or-die","trade","trading","trading-bot","trading-platform","trading-strategies"],"latest_commit_sha":null,"homepage":"https://127.0.0.1:3000","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ctubio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"ctubio"}},"created_at":"2017-06-13T20:15:54.000Z","updated_at":"2024-10-26T05:34:53.000Z","dependencies_parsed_at":"2024-11-19T06:07:02.913Z","dependency_job_id":"0c8a4787-0acb-4049-abec-9c3f5a7f2d2a","html_url":"https://github.com/ctubio/Krypto-trading-bot","commit_stats":{"total_commits":5049,"total_committers":60,"mean_commits":84.15,"dds":0.2392552980788275,"last_synced_commit":"2ba77a4d9996f9c3b8dde7d06333e38cfce0badd"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ctubio%2FKrypto-trading-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ctubio%2FKrypto-trading-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ctubio%2FKrypto-trading-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ctubio%2FKrypto-trading-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ctubio","download_url":"https://codeload.github.com/ctubio/Krypto-trading-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243119546,"owners_count":20239321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["binance","bitcoin","bitfinex","bitmex","bob-marley","bot-platform","coinbase","cryptocurrency","exchange","hitbtc","kraken","kucoin","market-data","market-maker","skate-or-die","trade","trading","trading-bot","trading-platform","trading-strategies"],"created_at":"2024-07-30T22:00:55.966Z","updated_at":"2025-03-15T02:32:05.497Z","avatar_url":"https://github.com/ctubio.png","language":"C++","funding_links":["https://github.com/sponsors/ctubio"],"categories":["TODO scan for Android support in followings","Trading Bots","C++","Quantitative Trading \u0026 Backtesting","📦 Legacy \u0026 Inactive Projects","Open Source","Trading Bots and Bot Frameworks","Open source bots"],"sub_categories":["Crypto Trading","Market Making Bots"],"readme":"\u003cimg align=\"left\" src=\"https://user-images.githubusercontent.com/1634027/36237231-e611590e-11fa-11e8-8486-6675078501dc.jpg\" /\u003e\u003cp align=\"right\"\u003eself reminder:\u003cbr\u003e\u003cb\u003epatience is the mother of science\u003c/b\u003e\u003c/p\u003e\u003cbr\u003e\u003ca href=\"http://ciutatrefugi.barcelona/en/welcome-barcelona\"\u003e\\*\\*\\* REFUGEES WELCOME! \\*\\*\\*\u003c/a\u003e\u003cbr/\u003e\u0026thinsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003ca href=\"http://missingmigrants.iom.int/\"\u003e\\*\\*\\* FATAL ROUTES? \\*\\*\\*\u003c/a\u003e\n\u003cbr clear=\"left\"\u003e\n\n[![Release](https://img.shields.io/github/release/ctubio/Krypto-trading-bot.svg)](https://github.com/ctubio/Krypto-trading-bot/releases)\n[![Platform](https://img.shields.io/badge/platform-unix--like-111111.svg)](https://www.gnu.org/)\n[![g0t0 Counter](https://tinyurl.com/g0t0search)](https://tinyurl.com/g0t0docs)\n[![Code Size](https://img.shields.io/github/languages/code-size/ctubio/Krypto-trading-bot.svg)](https://github.com/ctubio/Krypto-trading-bot)\n[![Software License](https://img.shields.io/badge/license-ISC-551a8b.svg)](https://raw.githubusercontent.com/ctubio/Krypto-trading-bot/master/LICENSE)\n[![Software License](https://img.shields.io/badge/license-MIT-551a8b.svg)](https://raw.githubusercontent.com/ctubio/Krypto-trading-bot/master/COPYING)\n\n[`K`](https://github.com/ctubio/Krypto-trading-bot) is a family of (very customizable) very low latency [market making](https://github.com/ctubio/Krypto-trading-bot/blob/master/doc/MANUAL.md#what-is-market-making) trading bots with a fully featured [web interface](https://github.com/ctubio/Krypto-trading-bot#web-ui).\u003cbr /\u003eIt can place or cancel orders on [compatible exchanges](https://github.com/ctubio/Krypto-trading-bot#compatible-exchanges) in less than a few milliseconds per order on a decent machine.\n\nIf you don't want to configure or hardcode your own trading strategies in your own machine,\u003cbr /\u003e\nyou can fund liquidity pools of automated market makers at [tinyman.org](https://tinyman.org/) (or at any other defi out there),\u003cbr /\u003ejust remember:\n- \u003cb\u003e\u003cins\u003enever write on any defi website your private keys\u003c/ins\u003e\u003c/b\u003e (you have to sign transactions, not to share your wallet keys)\n- \u003cb\u003e\u003cins\u003enever tell anyone on any chat your private keys\u003c/ins\u003e\u003c/b\u003e (if you have questions, use a public forum and reject impostors)\n\n### \u003cimg src=\"https://github.githubassets.com/images/icons/emoji/unicode/1f4be.png\" height=\"64\" width=\"64\"  align=\"middle\" /\u003e Latest version at https://github.com/ctubio/Krypto-trading-bot \u003cimg src=\"https://github.githubassets.com/images/icons/emoji/unicode/1f51e.png\" height=\"64\" width=\"64\" align=\"middle\" /\u003e \u003cimg src=\"https://github.githubassets.com/images/icons/emoji/unicode/1f4b8.png\" height=\"64\" width=\"64\" align=\"middle\" /\u003e\n\n[![Build Status](https://github.com/ctubio/Krypto-trading-bot/workflows/test/badge.svg)](https://github.com/ctubio/Krypto-trading-bot/actions)\n[![Coverage Status](https://img.shields.io/coveralls/ctubio/Krypto-trading-bot/master.svg)](https://coveralls.io/r/ctubio/Krypto-trading-bot?branch=master)\n[![Quality Status](https://img.shields.io/badge/review-clang--tidy%20+%20pvs-4cc61e.svg)](https://www.codacy.com/gh/ctubio/Krypto-trading-bot/dashboard)\n[![Open Issues](https://img.shields.io/github/issues/ctubio/Krypto-trading-bot.svg)](https://github.com/ctubio/Krypto-trading-bot/issues)\n[![Last Commit](https://img.shields.io/github/last-commit/ctubio/Krypto-trading-bot.svg)](https://github.com/ctubio/Krypto-trading-bot)\n[![Downloads Last Releases](https://img.shields.io/github/downloads/ctubio/Krypto-trading-bot/total.svg?label=downloads%20last%20releases)](https://github.com/ctubio/Krypto-trading-bot)\n\nOur bots run on unix-like systems. Persistence is achieved through a built-in server-less SQLite C++ interface.\u003cbr\u003eData transfers are directly done from your machine to the exchange using the latest CURL and OpenSSL versions.\u003cbr\u003eInstallation in a dedicated [Debian](https://cdimage.debian.org/cdimage/release/current/), [Raspberry](https://www.raspberrypi.com/software/), [Red Hat](https://developers.redhat.com/products/rhel/download), [CentOS](https://www.centos.org/download/) or macOS instance without Docker is recommended.\n\nThe web UI is compatible with most web browsers/resolutions, but Brave or Firefox at 1600px are recommended.\u003cbr /\u003eDoesn't require configuration of any web server (unless installed behind your own reverse proxy).\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eK-trading-bot\u003c/b\u003e \u003csup\u003e(web UI + CLI)\u003c/sup\u003e\u003c/summary\u003e\nto control a fully configurable high frequency trading engine, with all features suggested by the community:\u003cbr /\u003e\n\n![trading-bot UI Preview](https://user-images.githubusercontent.com/1634027/44740469-d5c7ff00-aafa-11e8-9252-73b9c1283adb.png)\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eK-+portfolios\u003c/b\u003e \u003csup\u003e(web UI + CLI)\u003c/sup\u003e\u003c/summary\u003e\nto show all balances from one exchange, with buttons to create, edit or cancel orders and links to go to markets:\u003cbr /\u003e\n\n![+portfolios UI Preview](https://github.com/user-attachments/assets/e0e3ce7d-3388-45a9-a559-4ba239a9e880)\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eK-hello-world\u003c/b\u003e \u003csup\u003e(CLI)\u003c/sup\u003e\u003c/summary\u003e\nto print the current value of a given currency to stdout:\u003cbr /\u003e\n\n\u003cpre\u003e\n _________________________________________\n/ Hello, WORLD!                           \\\n|                                         |\n\\ pssst.. 1.00000000 BTC = 56683.49 EUR.  /\n -----------------------------------------\n        \\   ^__^\n         \\  (oo)\\_______\n            (__)\\       )\\/\\\n                ||----w |\n                ||     ||\n\u003c/pre\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eK-scaling-bot, K-stable--bot\u003c/b\u003e \u003csup\u003e(CLI)\u003c/sup\u003e\u003c/summary\u003e\nto easy mod and start developing a new custom bot.\n\u003c/details\u003e\n\n### Compatible Exchanges\n\nAll currency pairs are supported (use `--list` argument to see all currently tradable pairs on a given exchange).\n\n\u003ctable\u003e\u003ctbody\u003e\u003ctr\u003e\u003ctd\u003e\u003c/td\u003e\u003ctd align=\"center\"\u003e\u003cb\u003eunder maintenance\u003c/b\u003e\u003c/td\u003e\u003ctd colspan=\"2\" align=\"center\" nowrap\u003e\u003cb\u003eunder development or abandoned\u003c/b\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd align=\"center\"\u003e\u003cb\u003eSpot Trading\u003c/b\u003e\u003c/td\u003e\u003ctd nowrap\u003e\u003ca href=\"https://www.coinbase.com/en-es/advanced-trade\"\u003eCoinbase\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://help.coinbase.com/en/coinbase/trading-and-funding/advanced-trade/advanced-trade-fees\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 2 WebSockets\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\u003ca href=\"https://www.binance.com/\"\u003eBinance\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://www.binance.com/en/fee/schedule\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e\u003ca href=\"https://www.binance.us/\"\u003eBinance.US\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://www.binance.us/fees\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 1 WebSocket\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\u003ca href=\"https://www.bitmex.com/\"\u003eBitMEX\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://www.bitmex.com/wallet/fees/derivatives\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 1 WebSocket\u003c/i\u003e\u003c/td\u003e\u003ctd nowrap\u003e\u003ca href=\"https://www.kraken.com/\"\u003eKraken\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://www.kraken.com/features/fee-schedule\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 2 WebSockets\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\u003ca href=\"https://www.kucoin.com/\"\u003eKuCoin\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://www.kucoin.com/vip/level\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 1 WebSocket\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\u003ca href=\"https://www.bitfinex.com/\"\u003eBitfinex\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://www.bitfinex.com/fees\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e\u003ca href=\"https://www.ethfinex.com/\"\u003eEthfinex\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://www.ethfinex.com/fees\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 1 WebSocket\u003c/i\u003e\u003c/td\u003e\u003ctd nowrap\u003e\u003ca href=\"https://www.gate.io/\"\u003eGate.io\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://www.gate.io/fee\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 1 WebSocket\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\u003ca href=\"https://hitbtc.com/\"\u003eHitBTC\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://hitbtc.com/fee-tier\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e\u003ca href=\"https://bequant.io/\"\u003eBequant\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://bequant.io/fees-and-limits\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 2 WebSockets\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\u003ca href=\"https://www.poloniex.com/\"\u003ePoloniex\u003c/a\u003e \u003csub\u003e(\u003ca href=\"https://poloniex.com/fees/\"\u003efees\u003c/a\u003e)\u003c/sub\u003e\u003cbr\u003e \u0026#10239; \u003ci\u003eREST + 1 WebSocket\u003c/i\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd align=\"center\"\u003e\u003cb\u003eMargin Trading\u003c/b\u003e\u003c/td\u003e\u003ctd nowrap\u003e\u003ci\u003enone\u003c/i\u003e\u003c/td\u003e\u003ctd colspan=\"2\" nowrap\u003e\u003ci\u003enone\u003c/i\u003e\u003c/td\u003e\u003c/tr\u003e\u003c/tbody\u003e\u003c/table\u003e\n\nIf you ask me, [\u003cimg height=\"20px\" src=\"https://github.com/user-attachments/assets/e84f2708-d29a-423d-a702-42c87a8ffe5b\"\u003e](https://advanced.coinbase.com/join/KAME9XG) is the best and most secure by far, so here is my [referral link](https://advanced.coinbase.com/join/KAME9XG) for both of us to enjoy.\n\nIn case you are looking for referral links to other exchanges, feel free to post a [new issue](https://github.com/ctubio/Krypto-trading-bot/issues/new?title=Referral%20link%20for%20%5Bexchange%5D) asking to other active users.\n\n## README\n- Documentation\n  - [README](#readme)\n  - [MANUAL](https://github.com/ctubio/Krypto-trading-bot/blob/master/doc/MANUAL.md)\n- Installation\n  - [Docker Installation](#docker-installation)\n  - [Windows Installation](#windows-installation)\n  - [Manual GIT Installation](#manual-git-installation)\n  - [Manual ZIP Installation](#manual-zip-installation)\n  - [Configuration After Manual Installation](#configuration-after-manual-installation)\n  - [Upgrade to the latest commit](#upgrade-to-the-latest-commit)\n  - [Multiple instances party time](#multiple-instances-party-time)\n- Information\n  - [Compatible Exchanges](#compatible-exchanges)\n  - [Application Usage](#application-usage)\n  - [Web UI](#web-ui)\n  - [Databases](#databases)\n  - [Charts](#charts)\n  - [Cloud Hosting](#cloud-hosting)\n- Development\n  - [Build notes](#build-notes)\n  - [Changelogs](#changelog)\n- Humans and Milk Mammals\n  - [Unlock](#unlock)\n  - [Donations](#donations)\n  - [General Discussion](#general-discussion)\n  - [Very Special Thanks](#very-special-thanks-to)\n  - [Help](#help)\n  - [Issues](#issues)\n\n### Docker Installation\n\nSee [etc/Dockerfile](https://github.com/ctubio/Krypto-trading-bot/tree/master/etc#dockerfile) file.\n\n### Windows Installation\n\nBefore starting with a manual installation, ensure your target machine has Windows 7 or greater and [MSYS2](https://www.msys2.org/) installed.\n\nUse MSYS2 Terminal to install `make` (with command `pacman -S make`), then proceed as usual with the installation.\n\n### Manual GIT Installation\n\n0. Ensure you agree to install collaborative non-free software (see [Unlock](#unlock) section).\n\n1. Ensure your target machine has `git` and `make` installed.\n\n2. Download it wherever you want (feel free to customize the suggested folder name K) and execute the installer:\n```\n $ git clone ssh://git@github.com/ctubio/Krypto-trading-bot K\n $ cd K\n $ make install\n```\n\n3. Open and edit the config file `K.sh` in your favorite text editor:\n```\n $ vim K.sh\n```\n\nTo upgrade anytime see [Upgrade to the latest commit](#upgrade-to-the-latest-commit) section.\n\n### Manual ZIP Installation\n\n0. Ensure you agree to install collaborative non-free software (see [Unlock](#unlock) section).\n\n1. Ensure your target machine has `curl` and `make` installed.\n\n2. Download it wherever you want (feel free to customize the suggested folder name K) and execute the installer:\n```\n $ mkdir K\n $ cd K\n $ curl -O krypto.ninja/Makefile\n $ make install\n```\n\n3. Open and edit the config file `K.sh` in your favorite text editor:\n```\n $ vim K.sh\n```\n\nTo upgrade anytime to the latest release just run `make reinstall`.\n\n### Configuration After Manual Installation\n\nSee [etc/K.sh.dist](https://github.com/ctubio/Krypto-trading-bot/blob/master/etc/K.sh.dist) file or better your own copy of `K.sh` file located in the top level path.\n\nIt just contains a few variables with examples. The very end of the file contains the code that starts the bot.\n\nOnce your config file is ready, you can execute it to start the bot:\n```\n $ ./K.sh\n```\n\nAlternatively use `make start` to run `K.sh` in the background using [screen](https://kb.iu.edu/d/acuy) (to see the output, attach the screen with `make screen` [or run all at once with `make start screen`]).\n\nFeel free to run `make stop` or `make restart` anytime, and don't forget to [read the fucking manual](https://github.com/ctubio/Krypto-trading-bot/blob/master/doc/MANUAL.md).\n\nTroubleshooting:\n\n * If there is no wallet data on a given exchange, double-check the currency symbols with `--list` argument.\n\n Optional:\n\n * See at least once `./K.sh --help` to trade or `make help` to develop.\n\n * Use your own HTTP Basic Authentication credentials with `--user` and `--pass` arguments.\n\n * Use your own SSL certificate with `--ssl-crt` and `--ssl-key` arguments.\u003cbr\u003eOtherwise, the insecure built-in certificate is fully featured, but you may need to authorise it in your browser.\u003cbr\u003eIf you want to generate your own certificate see [SSL for internal usage](https://www.akadia.com/services/ssh_test_certificate.html).\u003cbr\u003eIn case you really want to use plain HTTP, use `--without-ssl` argument.\n\n### Upgrade to the latest commit\n\nIf you upgrade while having any instance running in the background, you will need to manually restart it using `make restart` or `make restartall` to start using the latest version.\n\n#### Upgrade under Manual ZIP Installation:\n\nPlease run `make reinstall` to download the upgraded source and executable files.\n\n#### Upgrade under Manual GIT Installation:\n\nFeel free anytime to check if there are new upgrades with `make diff`.\n\nOnce you decide that it is time to upgrade, execute `make upgrade` (or directly `make reinstall` to skip the validation of new commits).\n\nIf you only use `git` to pull the latest source files from the remote branch, you will still need to upgrade or recompile your executable files.\n\nTo not upgrade but instead recompile your own modified source files, use `make lib K` or just `make` (see [Build notes](#build-notes)).\n\n### Multiple instances party time\n\nPlease note, an \"instance\" is in fact a `*.sh` config file; using a single machine with a single installation, you can run as many instances as `*.sh` files you have (limited by the available free RAM).\n\nYou can list the current running instances with `make list`.\n\nIf you haven't defined a config file, `make start`, `make screen`, `make stop` and `make restart` will use the default config file `K.sh`.\n\nTo run multiple instances using a collection of config files:\n\n1. Create a new config file with `cp etc/K.sh.dist X.sh \u0026\u0026 chmod +x X.sh` (use `X.sh` or any name but keep `.sh` extension).\n\n2. Edit the new config file `vim X.sh`\n\n3. Run the new instance with `./X.sh` or to run in the background, use `K=X.sh make start`. To attach to the new instance's screen, use `K=X.sh make screen`. To stop the new instance, use `K=X.sh make stop` and to restart it, use `K=X.sh make restart`. The environment variable `K` specifies the filename of the config file that you want to use.\n\n4. Open in the web browser the different pages of the ports of the different running instances, or display the UI of all instances together in a single page using the MATRYOSHKA link in the footer (that can be predefined using the optional argument `--matryoshka=URL`).\n\nAfter multiple config files are setup, to control them all together instead of one by one, the commands `make startall`, `make stopall` and `make restartall` are also available, just remember that config files with a filename starting with underscore symbol \"_\" will be skipped.\n\n### Application Usage\n\n1. Open your web browser to connect to port `3000` (or your configured port number) of the machine running K. Using `localhost` or one of the public or private IPs of your machine (if you're running on Docker, use the IP address returned by `boot2docker ip`).\n\n2. Read up on how to use K and market making in the [manual](https://github.com/ctubio/Krypto-trading-bot/blob/master/doc/MANUAL.md).\n\n3. Use the web UI to change the quoting parameters. Click the big \"BTC/USD\" button to start making markets. Click it again to stop. When the button is green, the bot is actively placing orders.\n\n### Web UI\n\nOnce `K` is up and running, visit port `3000` (or your configured port number) to access the UI (i.e. [https://localhost:3000](https://localhost:3000)). There are inputs for quoting parameters, grids to display market orders, market trades, your trades, your order history, your positions, and a big button with the currency pair you are trading. When you're ready, click that button green to begin sending out quotes. The UI uses angularjs hydrated with websockets observed with reactivexjs.\n\n### Databases\n\nEach currency pair of each exchange will use a different sqlite database file with [WAL mode](https://www.sqlite.org/wal.html) enabled.\n\nAll database files are located at `/var/lib/K/db/K-*.db*`, outside the download folder to survive wild `rm -rf path/to/K` or reinstalls.\n\nYou can copy any group of `*.db*` files to another machine when migrating or as a backup.\n\nIf a database does not exist, the application will create it on boot; otherwise, it will use the existing one.\n\nTo explore each database you can use https://github.com/sqlitebrowser/sqlitebrowser or a similar tool.\n\nTo set a different database filename or to set an [in-memory database](https://sqlite.org/inmemorydb.html), use `--database=FILE` argument (see `--help`).\n\nEven if using an in-memory database, the quoting parameters are always loaded from and saved into the file database.\n\n### Charts\n\nThe metrics are not saved anywhere, it is just UI data collected with a visibility retention of `n` hours (where `n` is the value of `profit` quoting parameter), to display over time:\n\n * Market Fair Value with High and Low Prices\n * Trades Complete\n * Target Position for BTC currency (TBP)\n * Target Position for Fiat currency\n * STDEV and EWMA values for Quote Protection and APR\n * Amount available in wallet for buy\n * Amount held in open trades for buy\n * Amount available in wallet for sell\n * Amount held in open trades for sell\n * Total amount available and held at both sides in BTC currency\n * Total amount available and held at both sides in Fiat currency\n\n### Cloud Hosting\n\nIf you ask me, [\u003cimg height=\"20px\" src=\"https://user-images.githubusercontent.com/1634027/29756933-3e64c62e-8ba8-11e7-916a-3b0ae1481a52.png\"\u003e](https://www.dreamhost.com/r.cgi?475987/cloud/) is a very nice web hosting company (awesome support team, awesome servers). Feel free to use this referral link to get a discount subtracted from my referral earnings (i'm a user since 2008).\n\n### Build notes\n\nMake sure your build machine has [node](https://nodejs.org/en/download/package-manager/) installed, also ensure `make lib` provides all dependencies without errors.\n\nTo rebuild the application, see `make help` and choose a target (just `make` may be what you are looking for).\n\nTest units are executed before the application exits, only if the application was compiled with `KUNITS=1 make`.\n\nOtherwise, just `make` without the environment var `KUNITS` produces an application that simply exits on exit.\n\nA quick test runner therefore is `./K.sh --version` or the alias `make test` or all at once with `KUNITS=1 make K test`.\n\nTo pipe the output to stdout, execute the application in the foreground with `--naked` argument.\n\nFor more information consider to follow the *white rabbit*, but its dangerous to go alone, take this:\n\nc sandbox: [wandbox.org](https://wandbox.org)\n\njs sandbox: [jsfiddle.net](https://jsfiddle.net)\n\nws sandbox: [app.gosandy.io](https://app.gosandy.io/)\n\n\u003cdetails\u003e\u003csummary\u003e\u003ca id=\"changelog\"\u003e\u003cb\u003eRelease v0.7.x Changelog\u003c/b\u003e\u003c/a\u003e\u003c/summary\u003e\n\nUpdated Coinbase integration to Advanced Trade API.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eRelease v0.6.x Changelog\u003c/b\u003e\u003c/summary\u003e\n\nAdded Hello World bot, Portfolios bot, Scaling bot and Stable bot.\n\nAdded Binance, Kraken, KuCoin, Gate.io and BitMEX API.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eRelease v0.5.x Changelog\u003c/b\u003e\u003c/summary\u003e\n\nUpdated exchange integrations as simple libcurl wrappers.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eRelease v0.4.x Changelog\u003c/b\u003e\u003c/summary\u003e\n\nAdded main KryptoNinja class derived from all other classes and ready to be extended.\n\nAdded C++ OOP everywhere.\n\nAdded test units.\n\nAdded --interface=IP argument to bind outgoing traffic to a specific network interface.\n\nAdded Ethfinex ~~and FCoin~~ API.\n\nAdded build-in document root to stop reading files from disk.\n\nAdded build chain for win32.\n\n~~Updated OKEx websocket to binary data.~~\n\nAdded build chain for OSX v10.13.\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eRelease v0.3.x Changelog\u003c/b\u003e\u003c/summary\u003e\n\nUpdated HitBTC API v2.\n\nAdded ZIP installation steps for non-git-lovers.\n\nAdded HamelinRat quoting mode and Trend safety thanks to b-seite and serzhiio contributions.\n\nAdded command-line arguments.\n\nUpdated quoting engine and gateways without nodejs.\n\nAdded Makefile to replace npm scripts.\n\n~~Added PNG files as configuration files.~~\n\nAdded built-in C++ WWW Server to replace expressjs and socketio.\n\nAdded built-in SQLite C++ interface to replace external mongodb server.\n\nAdded Poloniex API.\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eRelease v0.2.x Changelog\u003c/b\u003e\u003c/summary\u003e\n\nUpdated application name to K because of Kira.\n\nAdded nodejs7, typescript2, angular4 and reactivexjs.\n\nAdded cleanup of bandwidth, source code, dependencies and installation steps.\n\nAdded many quoting parameters thanks to Camille92 genius suggestions.\n\nAdded support for multiple instances/config files with nested matryoshka UI.\n\nAdded npm scripts, david-dm, travis-ci, coveralls and codacy.\n\nAdded historical charts to replace grafana.\n\nAdded C++ math functions.\n\nUpdated OKCoin API (since https://www.okcoin.com/t-354.html).\n\nUpdated Bitfinex API v2.\n\nAdded Coinbase FIX API.\n\n~~Added Korbit API.~~\n\nAdded new quoting styles PingPong, Boomerang, AK-47.\n\nAdded cleanup of database records, memory usage and log recording.\n\nAdded audio notices, realtime wallet display, and grafana integration.\n\nAdded https, dark theme and new UI elements.\n\nAdded a bit of love to Kira.\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eRelease v0.1.0 Changelog\u003c/b\u003e\u003c/summary\u003e\n\nsee the upstream project [michaelgrosner/tribeca](https://github.com/michaelgrosner/tribeca).\n\u003c/details\u003e\n\n### Unlock\n\nThe bot is unlocked for collaborators and contributors (feel free to make acceptable Pull Requests for already opened issues or for anything you consider useful, and let me know the BTC Payment Address for the bot that you wish to unlock in the description of the PR, and I will credit it for you).\n\nWhile locked, the orderbook will be in realtime 121 seconds, and later it will be updated only once every 121 seconds.\n\nAnonymous users can also unlock any API Key by paying 0.00121000 BTC to the address displayed on exit.\n\nOnce unlocked you may use different bots or currency pairs or reinstall on a different machine with the same unlocked API Key. However, if you want to use more than one exchange, you will need to pay again to unlock the API Key for each exchange.\n\nOtherwise if you choose to not support further development by ctubio, just keep running some old commit and do not upgrade (any commit prior to v0.3.0 was completely unlocked).\n\nPlease don't open issues asking how much % less the bot generates with `--free-version`; it is relative to your trading strategy, the market conditions, and the bot's performance.\n\n### Donations\n\nnope, this project doesn't have maintenance costs. but you can donate to your favorite developer today!\u003cbr\u003e(or tomorrow!)\n\nor see the upstream project [michaelgrosner/tribeca](https://github.com/michaelgrosner/tribeca).\n\nor donate your time with programming or financial suggestions in the IRC channel [#krypto.ninja](https://kiwiirc.com/client/irc.libera.chat:6697/?theme=cli#krypto.ninja) at irc.libera.chat on port 6697 (SSL), or 6667 (plain); or feel free to make any question, but questions technically are not donations.\n\n### General Discussion\n\n[IRC](https://kiwiirc.com/client/irc.libera.chat:6697/?theme=cli#krypto.ninja) is awesome!\n\nBut if you dislike it.. consider to join the [discord server](https://discord.gg/jAX7GEzcWD). Or you can DM [ctubio on reddit](https://www.reddit.com/user/ctubio) privately.\n\nOtherwise, here on GitHub, just create a [new discussion](https://github.com/ctubio/Krypto-trading-bot/discussions) permanently readable by everybody.\n\n### Very Special Thanks to:\n\n- https://github.com/michaelgrosner/tribeca (https://github.com/michaelgrosner)\n- https://curl.haxx.se (https://github.com/bagder)\n- https://github.com/michaelgrosner/tribeca (https://github.com/michaelgrosner)\n- https://github.com/uNetworking (https://github.com/alexhultman)\n- https://github.com/michaelgrosner/tribeca (https://github.com/michaelgrosner)\n- https://nlohmann.github.io/json (https://github.com/nlohmann)\n- https://github.com/michaelgrosner/tribeca (https://github.com/michaelgrosner)\n- http://invisible-island.net\n- https://github.com/michaelgrosner/tribeca (https://github.com/michaelgrosner)\n- https://www.sqlite.org\n- https://github.com/michaelgrosner/tribeca (https://github.com/michaelgrosner)\n- but Most Special Thanks goes to [your mother](https://youtu.be/YDafHsyyTNk).\n\n### Help\n\nIf you need installation or usage support, please create a [new discussion](https://github.com/ctubio/Krypto-trading-bot/discussions/new).\n\n### Issues\n\nTo request new features open a [new issue](https://github.com/ctubio/Krypto-trading-bot/issues/new?title=Feature%20request) and explain your improvement as you consider.\n\nTo report errors open a [new issue](https://github.com/ctubio/Krypto-trading-bot/issues/new?title=Error%20report) only after collecting all possible relevant log messages.\n\nPull Requests are welcome, but adhere to the Contributor License Agreement:\n- Your biological and technological distinctiveness will be added to our own. Resistance is futile.\n\n### like yesterday, since 0day and ∞\n\n![bcn](https://user-images.githubusercontent.com/1634027/29495722-1d924018-85c5-11e7-8d61-d83f5716ae9e.jpg)\n\n#### every new day we sing:\n\n\u003cp\u003eIf love is so nice, tell me why are you so sad?\u003cbr\u003eIf love is so nice, tell me, oh tell me why are you hurt so bad?\u003cbr\u003eOne Love! get ready!\u003c/p\u003e\n\u003cp\u003eNow feel this drumbeat as it beats within,\u003cbr\u003eplayin' a riddim, resisting against the system:\u003c/p\u003e\n\n - https://youtu.be/g--fsK6aLf8\n - https://youtu.be/BncXzyjdREc\n - https://youtu.be/uEqxj58g6To\n - https://youtu.be/SS9DJX8gTKk\n - https://youtu.be/vu6WXLQT5r8\n - https://youtu.be/e8ULyjcSukM\n - https://youtu.be/Rom4qWtEkMA\n - https://youtu.be/InNk4Z-BGc8\n - https://youtu.be/xPg_e_3cK-E\n - https://youtu.be/KKpcQIfIAi8\n - https://youtu.be/pZAmer0EmMQ\n - https://youtu.be/50aXt1ctmUU\n - https://youtu.be/vofff0Ei3kk\n - https://youtu.be/4Ois3zB7SJ4\n - https://youtu.be/_wGDcWD1E1A\n - https://youtu.be/VOgFZfRVaww\n - https://youtu.be/1iZdJNH3Z1o\n - https://youtu.be/_e5hvHL2WTg\n - https://youtu.be/jQhtEYfax5c\n - add your song here (please open a [new issue](https://github.com/ctubio/Krypto-trading-bot/issues/new?title=Today,%20I%20sing) to share your link)\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/1634027/32134633-642bb47a-bbf1-11e7-809c-f2d4d57678e0.jpg\" /\u003e\n\u003cbr /\u003e\u003cbr /\u003e\nWe have already enough policemen,\u003cbr /\u003eif you like adventures choose to be a \u003ca href=\"https://youtu.be/pT_GM35fM7I\"\u003ebrave firefighter\u003c/a\u003e.\n\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/1634027/32695988-22681724-c76b-11e7-8557-7f2b15b2686b.jpg\" /\u003e\n\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003eViolence \u003ca href=\"https://www.cnvc.org/about/purpose-of-nvc\"\u003eshould not\u003c/a\u003e be the answer to those who\u003cbr /\u003eare \u003ca href=\"https://novact.org/en/\"\u003easking for\u003c/a\u003e freedom.\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/1634027/29746351-7478d556-8ad7-11e7-8b27-445eefa8f960.jpg\" /\u003e\n\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\n\u003ca href=\"https://hits.seeyoufarm.com\"\u003e\u003cimg src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fctubio%2FKrypto-trading-bot%2FREADME.md\u0026count_bg=%2379C83D\u0026title_bg=%23555555\u0026icon=known.svg\u0026icon_color=%2306FF18\u0026title=page+views\u0026edge_flat=false\"/\u003e\u003c/a\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fctubio%2FKrypto-trading-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fctubio%2FKrypto-trading-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fctubio%2FKrypto-trading-bot/lists"}