This repository hosts the Bitfinex Brokerage Plugin Integration with the QuantConnect LEAN Algorithmic Trading Engine. LEAN is a brokerage agnostic operating system for quantitative finance. Thanks to open-source plugins such as this LEAN can route strategies to almost any market.
LEAN is maintained primarily by QuantConnect, a US based technology company hosting a cloud algorithmic trading platform. QuantConnect has successfully hosted more than 200,000 live algorithms since 2015, and trades more than $1B volume per month.
Bitfinex was founded by Giancarlo Devasini and Raphael Nicolle in 2012 with the goal to "give our users the ultimate cryptocurrency trading experience". Bitfinex provides access to trading Crypto for clients outside prohibited jurisdictions with no minimum deposit to set up an account. If you fund your account with fiat currency, they enforce a 10,000 minimum for USD, EUR, and GBP. However, if you fund your account with Crypto, they do not enforce a minimum deposit. Bitfinex also provides Crypto staking, a mobile app, and an unrealized profit leaderboard for the traders on the platform. Bitfinex has always been at the forefront of technological innovation in digital asset trading.
For more information about the Bitfinex brokerage, see the QuantConnect-Bitfinex Integration Page.
You can deploy using a visual interface in the QuantConnect Cloud. For more information see the QuantConnect-Bitfinex Integration Page.
In the QuantConnect Cloud Platform you can harness the QuantConnect Live Data Feed. For most users this is substantially cheaper and easier than self-hosting.
Follow these steps to start local live trading with the Bitfinex brokerage:
-
Open a terminal in your CLI root directory.
-
Run
lean live "<projectName>" to start a live deployment wizard for the project in ./<projectName>and then enter the brokerage number.$ lean live 'My Project' Select a brokerage: 1. Paper Trading 2. Interactive Brokers 3. Tradier 4. OANDA 5. Bitfinex 6. Coinbase Pro 7. Binance 8. Zerodha 9. Samco 10. Terminal Link 11. Atreyu 12. Trading Technologies 13. Kraken 14. FTX Enter an option: -
Enter the number of the organization that has a subscription for the Bitfinex module.
$ lean live "My Project" Select the organization with the Bitfinex module subscription: 1. Organization 1 2. Organization 2 3. Organization 3 Enter an option: 1 -
Enter your API key id and secret.
$ lean live "My Project" API key: bbbMsqbxjytVM9cGvnLpKguz9rZf2T5qACxaVx7E8Mm API secret: *******************************************To create new API credentials, see the API Management page on the Bitfinex website.
-
Enter the number of the data feed to use and then follow the steps required for the data connection.
$ lean live 'My Project' Select a data feed: 1. Interactive Brokers 2. Tradier 3. Oanda 4. Bitfinex 5. Coinbase Pro 6. Binance 7. Zerodha 8. Samco 9. Terminal Link 10. Trading Technologies 11. Kraken 12. FTX 13. IQFeed 14. Polygon Data Feed 15. Custom Data Only To enter multiple options, separate them with comma:If you select Polygon Data Feed, see Polygon for set up instructions.
-
View the result in the
<projectName>live<timestamp>directory. Results are stored in real-time in JSON format. You can save results to a different directory by providing the--output <path>option in step 2.
If you already have a live environment configured in your Lean configuration file, you can skip the interactive wizard by providing the --environment <value> option in step 2. The value of this option must be the name of an environment which has live-mode set to true.
Bitfinex supports cash and margin accounts.
Bitfinex supports trading crypto and the following order types:
- Market Order
- Limit Order
- Limit-If-Touched Order
- Stop Market Order
- Stop-Limit Order
- Market-On-Open Order
- Market-On-Close Order
For local deployment, the algorithm needs to download the following dataset:
Lean models the brokerage behavior for backtesting purposes. The margin model is used in live trading to avoid placing orders that will be rejected due to insufficient buying power.
You can set the Brokerage Model with the following statements
SetBrokerageModel(BrokerageName.Bitfinex, AccountType.Cash);
SetBrokerageModel(BrokerageName.Bitfinex, AccountType.Margin);
We model the order fees of Bitfinex, which are a 0.1% maker fee and a 0.2% taker fee. If you place a limit order that hits a hidden order or you add liquidity to the order book by placing a limit order that doesn't cross the spread, you pay maker fees. If you place a hidden order or you remove liquidity from the order book by placing an order that crosses the spread, you pay taker fees. Bitfinex adjusts your fees based on your 30-day trading volume and LEO balance, but we don't currently model these metrics to adjust fees. To check the latest fees at all the fee levels, see the Fees Schedule page on the Bitfinex website.
To use the Bitfinex brokerage in a live algorithm, the following table shows the fee settings you need on your Account > Fees page on the Bitfinex website:
| Fee Setting | Value |
|---|---|
| Default currency for fees | USD |
| Fee type for Exchange orders | Currency Exchange Fee |
We model buying power and margin calls to ensure your algorithm stays within the margin requirements.
Bitfinex allows up to 3.3x leverage for margin accounts.
Regulation T margin rules apply. When the amount of margin remaining in your portfolio drops below 5% of the total portfolio value, you receive a warning. When the amount of margin remaining in your portfolio drops to zero or goes negative, the portfolio sorts the generated margin call orders by their unrealized profit and executes each order synchronously until your portfolio is within the margin requirements.
Orders through Bitfinex do not experience slippage in backtests. In paper trading and live trading, your orders may experience slippage.
We fill market orders immediately and completely in backtests. In live trading, if the quantity of your market orders exceeds the quantity available at the top of the order book, your orders are filled according to what is available in the order book.
Trades settle immediately after the transaction.
You can deposit and withdraw cash from your brokerage account while you run an algorithm that's connected to the account. We sync the algorithm's cash holdings with the cash holdings in your brokerage account every day at 7:45 AM Eastern Time (ET).
LEAN Engine is an open-source algorithmic trading engine built for easy strategy research, backtesting, and live trading. We integrate with common data providers and brokerages, so you can quickly deploy algorithmic trading strategies.
The core of the LEAN Engine is written in C#, but it operates seamlessly on Linux, Mac and Windows operating systems. To use it, you can write algorithms in Python 3.8 or C#. QuantConnect maintains the LEAN project and uses it to drive the web-based algorithmic trading platform on the website.
Contributions are warmly very welcomed but we ask you to read the existing code to see how it is formatted, commented and ensure contributions match the existing style. All code submissions must include accompanying tests. Please see the contributor guide lines.
We ask that our users adhere to the community code of conduct to ensure QuantConnect remains a safe, healthy environment for high quality quantitative trading discussions.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.