From 9d8a3b4ec5ca30ecfe6ff23d05ca0f7aacd386ab Mon Sep 17 00:00:00 2001 From: misagh Date: Sun, 16 Dec 2018 22:02:29 +0100 Subject: [PATCH] docs added --- docs/configuration.md | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/configuration.md b/docs/configuration.md index c4c0bed28..4db6c2e70 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -40,6 +40,7 @@ The table below will list all configuration parameters. | `ask_strategy.order_book_min` | 0 | No | Bot will scan from the top min to max Order Book Asks searching for a profitable rate. | `ask_strategy.order_book_max` | 0 | No | Bot will scan from the top min to max Order Book Asks searching for a profitable rate. | `order_types` | None | No | Configure order-types depending on the action (`"buy"`, `"sell"`, `"stoploss"`, `"stoploss_on_exchange"`). +| `order_time_in_force` | None | No | Configure time in force for buy and sell orders (`"buy"`, `"sell"`). [More info blow](#user-content-understand-order-time_in_force). | `exchange.name` | bittrex | Yes | Name of the exchange class to use. [List below](#user-content-what-values-for-exchangename). | `exchange.key` | key | No | API key to use for the exchange. Only required when you are in production mode. | `exchange.secret` | secret | No | API secret to use for the exchange. Only required when you are in production mode. @@ -161,6 +162,25 @@ The below is the default which is used if this is not configured in either Strat **NOTE**: Not all exchanges support "market" orders. The following message will be shown if your exchange does not support market orders: `"Exchange does not support market orders."` +### Understand order_time_in_force +Order time in force defines the policy by which the order is executed on the exchange. Three commonly used time in force are:
+`GTC (Goog Till Canceled):` +This is most of the time the default time in force. It means the order will remain on exchange till it is canceled by user. It can be fully or partially fulfilled. If partially fulfilled, the remaining will stay on the exchange till cancelled.
+`FOK (Full Or Kill):` +It means if the order is not executed immediately AND fully then it is canceled by the exchange.
+`IOC (Immediate Or Canceled):` +It is the same as FOK (above) except it can be partially fulfilled. The remaining part is automatically cancelled by the exchange. +
+`order_time_in_force` contains a dict buy and sell time in force policy. This can be set in the configuration or in the strategy. Configuration overwrites strategy configurations.
+possible values are: `gtc` (defaul), `fok` or `ioc`.
+``` python + "order_time_in_force": { + "buy": "gtc", + "sell": "gtc" + }, +``` +**NOTE**: This is an ongoing work. For now it is supported only for binance and only for buy orders. Please don't change the default value unless you know what you are doing.
+ ### What values for exchange.name? Freqtrade is based on [CCXT library](https://github.com/ccxt/ccxt) that supports 115 cryptocurrency @@ -215,7 +235,7 @@ production mode. ### Dynamic Pairlists -Dynamic pairlists select pairs for you based on the logic configured. +Dynamic pairlists select pairs for you based on the logic configured. The bot runs against all pairs (with that stake) on the exchange, and a number of assets (`number_assets`) is selected based on the selected criteria. By *default*, a Static Pairlist is used (configured as `"pair_whitelist"` under the `"exchange"` section of this configuration).