141 lines
4.0 KiB
Markdown
141 lines
4.0 KiB
Markdown
# Telegram usage
|
|
|
|
This page explains how to command your bot with Telegram.
|
|
|
|
## Pre-requisite
|
|
To control your bot with Telegram, you need first to
|
|
[set up a Telegram bot](https://github.com/gcarq/freqtrade/blob/develop/docs/pre-requisite.md)
|
|
and add your Telegram API keys into your config file.
|
|
|
|
## Telegram commands
|
|
Per default, the Telegram bot shows predefined commands. Some commands
|
|
are only available by sending them to the bot. The table below list the
|
|
official commands. You can ask at any moment for help with `/help`.
|
|
|
|
| Command | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `/start` | | Starts the trader
|
|
| `/stop` | | Stops the trader
|
|
| `/status` | | Lists all open trades
|
|
| `/status table` | | List all open trades in a table format
|
|
| `/count` | | Displays number of trades used and available
|
|
| `/profit` | | Display a summary of your profit/loss from close trades and some stats about your performance
|
|
| `/forcesell <trade_id>` | | Instantly sells the given trade (Ignoring `minimum_roi`).
|
|
| `/forcesell all` | | Instantly sells all open trades (Ignoring `minimum_roi`).
|
|
| `/performance` | | Show performance of each finished trade grouped by pair
|
|
| `/balance` | | Show account balance per currency
|
|
| `/daily <n>` | 7 | Shows profit or loss per day, over the last n days
|
|
| `/help` | | Show help message
|
|
| `/version` | | Show version
|
|
|
|
## Telegram commands in action
|
|
Below, example of Telegram message you will receive for each command.
|
|
|
|
### /start
|
|
> **Status:** `running`
|
|
|
|
### /stop
|
|
> `Stopping trader ...`
|
|
> **Status:** `stopped`
|
|
|
|
## /status
|
|
For each open trade, the bot will send you the following message.
|
|
|
|
> **Trade ID:** `123`
|
|
> **Current Pair:** CVC/BTC
|
|
> **Open Since:** `1 days ago`
|
|
> **Amount:** `26.64180098`
|
|
> **Open Rate:** `0.00007489`
|
|
> **Close Rate:** `None`
|
|
> **Current Rate:** `0.00007489`
|
|
> **Close Profit:** `None`
|
|
> **Current Profit:** `12.95%`
|
|
> **Open Order:** `None`
|
|
|
|
## /status table
|
|
Return the status of all open trades in a table format.
|
|
```
|
|
ID Pair Since Profit
|
|
---- -------- ------- --------
|
|
67 SC/BTC 1 d 13.33%
|
|
123 CVC/BTC 1 h 12.95%
|
|
```
|
|
|
|
## /count
|
|
Return the number of trades used and available.
|
|
```
|
|
current max
|
|
--------- -----
|
|
2 10
|
|
```
|
|
|
|
## /profit
|
|
Return a summary of your profit/loss and performance.
|
|
|
|
> **ROI:** Close trades
|
|
> ∙ `0.00485701 BTC (258.45%)`
|
|
> ∙ `62.968 USD`
|
|
> **ROI:** All trades
|
|
> ∙ `0.00255280 BTC (143.43%)`
|
|
> ∙ `33.095 EUR`
|
|
>
|
|
> **Total Trade Count:** `138`
|
|
> **First Trade opened:** `3 days ago`
|
|
> **Latest Trade opened:** `2 minutes ago`
|
|
> **Avg. Duration:** `2:33:45`
|
|
> **Best Performing:** `PAY/BTC: 50.23%`
|
|
|
|
## /forcesell <trade_id>
|
|
|
|
> **BITTREX:** Selling BTC/LTC with limit `0.01650000 (profit: ~-4.07%, -0.00008168)`
|
|
|
|
## /performance
|
|
Return the performance of each crypto-currency the bot has sold.
|
|
> Performance:
|
|
> 1. `RCN/BTC 57.77%`
|
|
> 2. `PAY/BTC 56.91%`
|
|
> 3. `VIB/BTC 47.07%`
|
|
> 4. `SALT/BTC 30.24%`
|
|
> 5. `STORJ/BTC 27.24%`
|
|
> ...
|
|
|
|
## /balance
|
|
Return the balance of all crypto-currency your have on the exchange.
|
|
|
|
> **Currency:** BTC
|
|
> **Available:** 3.05890234
|
|
> **Balance:** 3.05890234
|
|
> **Pending:** 0.0
|
|
|
|
> **Currency:** CVC
|
|
> **Available:** 86.64180098
|
|
> **Balance:** 86.64180098
|
|
> **Pending:** 0.0
|
|
|
|
## /daily <n>
|
|
Per default `/daily` will return the 7 last days.
|
|
The example below if for `/daily 3`:
|
|
|
|
> **Daily Profit over the last 3 days:**
|
|
```
|
|
Day Profit BTC Profit USD
|
|
---------- -------------- ------------
|
|
2018-01-03 0.00224175 BTC 29,142 USD
|
|
2018-01-02 0.00033131 BTC 4,307 USD
|
|
2018-01-01 0.00269130 BTC 34.986 USD
|
|
```
|
|
|
|
## /version
|
|
> **Version:** `0.14.3`
|
|
|
|
### using proxy with telegram
|
|
in [freqtrade/freqtrade/rpc/telegram.py](https://github.com/gcarq/freqtrade/blob/develop/freqtrade/rpc/telegram.py) replace
|
|
```
|
|
self._updater = Updater(token=self._config['telegram']['token'], workers=0)
|
|
```
|
|
|
|
with
|
|
```
|
|
self._updater = Updater(token=self._config['telegram']['token'], request_kwargs={'proxy_url': 'socks5://127.0.0.1:1080/'}, workers=0)
|
|
```
|