Telegram Kraken Bot

Python 3 bot to trade on Kraken via Telegram messenger

Overview

This Python script is a polling (not webhook) based Telegram bot. It can trade crypto-currencies on the Kraken marketplace and has a user friendly interface (custom keyboards with buttons).

Features

• Bound to a specific Telegram user - only that user can use the bot
• No need to login to Kraken - start trading immediately, always
• Integrated update mechanism - get latest version from GitHub
• Notifies you once order is closed and trade successfully executed
• Fully usable with buttons - no need to enter commands manually
• Supports all currencies available on Kraken (configurable)
• Change bot settings via bot
• Following Kraken functionality is implemented
  • Create a buy / sell order (type limit or market)
  • Lookup last trade price for currencies
  • Show all your assets
  • Current market value of assets (one or all)
  • Show / close open orders
  • Sell all assets for current market price
  • Deposit & withdraw
  • Show real-time charts
  • List history of closed orders
  • Check state of Kraken API

Files

In the following list you will find detailed information about all the files that the project consists of - and if they are necessary to run the bot or not.

• .gitignore: Only relevant if you use git as your Source Code Management. If you put a filename in that file, then that file will not be commited to the repository. If you don't intend to code yourself, the file is not needed.
• _config.yml: Automatically genereated file from GitHub that holds the theme-name for the project page. This file is not needed.
• config.json: The configuration file for this bot. This file is needed.
• demo.gif: Animated image for GitHub README.md to demonstrate how the bot looks and behaves. This file is not needed.
• kraken.key: The content of this file has to remain secret! Do not tell anybody anything about the content. The file consists of two lines. First line: API key. Second line: API secret (you get both from Kraken). This file is needed.
• Procfile: This file is only necessary if you want to host the bot on Heroku. Otherwise, this file is not needed.
• README.md: The readme file you are reading right now. Includes instructions on how to run and use the bot. The file is not needed.
• requirements.txt: This file holds all dependencies (Python modules) that are required to run the bot. Once all dependencies are installed, the file is not needed anymore. If you need to know how to install the dependencies from this file, take a look at the dependencies section.
• telegram_python_bot.py: The bot itself. This file has to be executed with Python to run. For more details, see the installation section. This file is needed.

Summary

These are the files that are important to run the bot:

• kraken.key (API Secret)
• config.json (Configuration)
• telegram_kraken_bot.py (Bot itself)

Configuration

Before starting up the bot you have to take care of some settings. You need to edit two files:

config.json

This