freqtrade_origin/docs/webhook-config.md

124 lines
3.2 KiB
Markdown
Raw Normal View History

2018-07-07 12:13:49 +00:00
# Webhook usage
## Configuration
Enable webhooks by adding a webhook-section to your configuration file, and setting `webhook.enabled` to `true`.
Sample configuration (tested using IFTTT).
```json
"webhook": {
"enabled": true,
"url": "https://maker.ifttt.com/trigger/<YOUREVENT>/with/key/<YOURKEY>/",
"webhookbuy": {
"value1": "Buying {pair}",
"value2": "limit {limit:8f}",
"value3": "{stake_amount:8f} {stake_currency}"
},
2020-02-08 20:02:52 +00:00
"webhookbuycancel": {
2020-02-11 14:58:40 +00:00
"value1": "Cancelling Open Buy Order for {pair}",
2020-02-08 20:02:52 +00:00
"value2": "limit {limit:8f}",
"value3": "{stake_amount:8f} {stake_currency}"
},
2018-07-07 12:13:49 +00:00
"webhooksell": {
"value1": "Selling {pair}",
"value2": "limit {limit:8f}",
"value3": "profit: {profit_amount:8f} {stake_currency}"
},
2020-02-08 20:02:52 +00:00
"webhooksellcancel": {
2020-02-11 14:58:40 +00:00
"value1": "Cancelling Open Sell Order for {pair}",
2020-02-08 20:02:52 +00:00
"value2": "limit {limit:8f}",
"value3": "profit: {profit_amount:8f} {stake_currency}"
},
2018-07-07 12:13:49 +00:00
"webhookstatus": {
"value1": "Status: {status}",
"value2": "",
"value3": ""
}
},
```
The url in `webhook.url` should point to the correct url for your webhook. If you're using [IFTTT](https://ifttt.com) (as shown in the sample above) please insert our event and key to the url.
Different payloads can be configured for different events. Not all fields are necessary, but you should configure at least one of the dicts, otherwise the webhook will never be called.
### Webhookbuy
The fields in `webhook.webhookbuy` are filled when the bot executes a buy. Parameters are filled using string.format.
Possible parameters are:
2019-04-05 04:47:03 +00:00
* `exchange`
* `pair`
* `limit`
2020-02-08 20:02:52 +00:00
* `amount`
2020-02-08 20:19:07 +00:00
* `open_date`
2019-04-05 04:47:03 +00:00
* `stake_amount`
* `stake_currency`
* `fiat_currency`
2019-06-17 05:03:33 +00:00
* `order_type`
2020-02-08 20:02:52 +00:00
* `current_rate`
### Webhookbuycancel
The fields in `webhook.webhookbuycancel` are filled when the bot cancels a buy order. Parameters are filled using string.format.
Possible parameters are:
* `exchange`
* `pair`
* `limit`
* `amount`
2020-02-08 20:19:07 +00:00
* `open_date`
2020-02-08 20:02:52 +00:00
* `stake_amount`
* `stake_currency`
* `fiat_currency`
* `order_type`
* `current_rate`
2018-07-07 12:13:49 +00:00
### Webhooksell
The fields in `webhook.webhooksell` are filled when the bot sells a trade. Parameters are filled using string.format.
Possible parameters are:
2019-04-05 04:47:03 +00:00
* `exchange`
* `pair`
* `gain`
* `limit`
* `amount`
* `open_rate`
* `current_rate`
* `profit_amount`
* `profit_percent`
* `stake_currency`
* `fiat_currency`
* `sell_reason`
2019-06-17 05:03:33 +00:00
* `order_type`
2019-12-08 13:10:26 +00:00
* `open_date`
* `close_date`
2018-07-07 12:13:49 +00:00
2020-02-08 20:02:52 +00:00
### Webhooksellcancel
The fields in `webhook.webhooksellcancel` are filled when the bot cancels a sell order. Parameters are filled using string.format.
Possible parameters are:
* `exchange`
* `pair`
* `gain`
* `limit`
* `amount`
* `open_rate`
* `current_rate`
* `profit_amount`
* `profit_percent`
* `stake_currency`
* `fiat_currency`
* `sell_reason`
* `order_type`
* `open_date`
2020-02-08 20:19:07 +00:00
* `close_date`
2020-02-08 20:02:52 +00:00
2018-07-07 12:13:49 +00:00
### Webhookstatus
The fields in `webhook.webhookstatus` are used for regular status messages (Started / Stopped / ...). Parameters are filled using string.format.
The only possible value here is `{status}`.