--- title: "CFD and FOREX Brokerages" description: "Our OANDA integration lets you deploy live trading algorithms on our co-located servers that trade the capital you have in your OANDA account." canonical: https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages/cfd-and-forex-brokerages markdown: https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages/cfd-and-forex-brokerages.md language: python source: https://github.com/QuantConnect/Documentation/tree/master/01%20Cloud%20Platform/10%20Live%20Trading/02%20Brokerages/98%20CFD%20and%20FOREX%20Brokerages modified: 2026-11-03 index: https://www.quantconnect.com/llms.txt --- # CFD and FOREX Brokerages [Documentation](https://www.quantconnect.com/docs/v2.md) > [Cloud Platform](https://www.quantconnect.com/docs/v2/cloud-platform.md) > [Live Trading](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading.md) > [Brokerages](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages.md) > CFD and FOREX Brokerages > Code examples are shown in Python. Append `?lang=csharp` to this URL for the C# version of this page. ## Introduction QuantConnect enables you to run your algorithms in live mode with real-time market data. QuantConnect integrates with [OANDA](https://www.oanda.com/) for CFD and FOREX trading. OANDA was founded by Dr. Michael Stumm and Dr. Richard Olsen in 1995 with the goal to "transform all aspects of how the world interacts with currencies, whether that be trading or utilizing currency data and information". OANDA provides access to trading Forex and CFDs for clients in over 240 countries and territories with [no minimum deposit](https://www.oanda.com/ca-en/trading/deposits-and-withdrawals/). OANDA also provides demo accounts, advanced charting tools, and educational content To view the implementation of the OANDA brokerage integration, see the [Lean.Brokerages.OANDA repository](https://github.com/QuantConnect/Lean.Brokerages.OANDA). ## Account Types OANDA supports margin accounts. To set the account type in an algorithm, see the [OANDA brokerage model documentation](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/oanda.md). ### Create an Account Follow the [How to open an account](https://www.oanda.com/ca-en/trading/how-open-account/) page on the OANDA website to open an OANDA account. You will need your account number and access token to deploy live algorithms. To get your account number, open the [Account Statement](https://www.oanda.com/account/statement/) page on the OANDA website. Your account number is formatted as ###-###-######-###. To get your access token, open the [Manage API Access](https://www.oanda.com/account/tpa/personal_token) on the OANDA website. > Important note for European Union residents: On March 17th, 2023, OANDA Europe Markets Ltd. ("OEML") closed operations and transferred accounts to OANDA TMS Brokers S.A. ("OANDA TMS")[1](https://pages.oanda.com/rs/686-YQF-621/images/OEM-OT-Transfer-QA.pdf). OANDA TWS does not offer REST API endpoints for live trading. EU residents can trade with OANDA if they can open an account with another member of the OANDA Group, for example, US citizens. ### Paper Trading OANDA supports paper trading. Follow these steps to set up an OANDA paper trading account: 1. [Create an OANDA demo account](https://www.oanda.com/apply/demo). 2. Log in to your demo account. 3. On the Account page, in the **My Services** section, click **Manage API Access**. 4. On the Your key to OANDA's API page, click **Generate**. Your access token displays. Store it somewhere safe. You need your access token to deploy an algorithm with your paper trading account. 5. In the top navigation bar, click **My Account**. 6. On the Account page, in the **Manage Funds** section, click **View**. 7. On the My Funds page, in the **Account Summary** section, note your v20 Account Number. You need your v20 Account Number to deploy an algorithm with your paper trading account. ## Asset Classes Our OANDA integration supports trading [Forex](https://www.quantconnect.com/docs/v2/writing-algorithms/securities/asset-classes/forex.md) and [CFDs](https://www.quantconnect.com/docs/v2/writing-algorithms/securities/asset-classes/cfd.md). ## Data Providers The QuantConnect data provider provides [Forex](https://www.quantconnect.com/docs/v2/cloud-platform/datasets/quantconnect/forex.md) and [CFD](https://www.quantconnect.com/docs/v2/cloud-platform/datasets/quantconnect/cfd.md) trading data during live trading. ## Orders We model the OANDA API by supporting several order types, a `TimeInForce` order instruction, and order updates. When you deploy live algorithms, you can [place manual orders](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/algorithm-control.md#03-Place-Manual-Trades) through the IDE. ### Order Types The following table describes the available order types for each asset class that our OANDA integration supports: | Order Type | Forex | CFD | | --- | --- | --- | | [Market](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-types/market-orders.md) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | | [Limit](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-types/limit-orders.md) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | | [Stop market](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-types/stop-market-orders.md) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | | [Stop limit](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-types/stop-limit-orders.md) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ### Time In Force We model the `GOOD_TIL_CANCELED` [TimeInForce](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-properties.md#03-Time-In-Force) from the OANDA API. ### Updates We model the OANDA API by supporting [order updates](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-management/order-tickets.md#04-Update-Orders). ## Fees To view the OANDA trading fees, see the [Our Charges and Fees](https://www.oanda.com/ca-en/trading/our-charges/) page on the OANDA website. To view how we model their fees, see [Fees](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/oanda.md#06-Fees). ## Margin We model [buying power](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/oanda.md#07-Buying-Power) and [margin calls](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/margin-calls.md) to ensure your algorithm stays within the margin requirements. ## Slippage Orders through OANDA do not experience slippage in backtests. In OANDA paper trading and live trading, your orders may experience slippage. To view how we model OANDA slippage, see [Slippage](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/oanda.md#05-Slippage). ## Fills To view how we model OANDA order fills, see [Fills](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/oanda.md#04-Fills). ## Settlements Trades settle immediately after the transaction To view how we model settlement for OANDA trades, see [Settlement](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/oanda.md#08-Settlement). ## Security and Stability Note the following security and stability aspects of our OANDA integration. ### Account Credentials When you deploy live algorithms with OANDA, we don't save your credentials. ### API Outages We call the OANDA API to place live trades. Sometimes the API may be down. Check the [OANDA status page](https://uptime.com/oanda.com) to see if the API is currently working. ## Deposits and Withdrawals 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). ## Demo Algorithm The following algorithm demonstrates the functionality of the OANDA brokerage: ```python # Demonstrate OANDA brokerage functionality with an EMA crossover strategy on EURUSD. class OandaDemoAlgorithm(QCAlgorithm): def initialize(self) -> None: self.set_start_date(2024, 9, 1) self.set_end_date(2024, 12, 31) self.set_cash(100000) self.set_brokerage_model(BrokerageName.OANDA_BROKERAGE, AccountType.MARGIN) self._symbol = self.add_forex("EURUSD", Resolution.DAILY, Market.OANDA).symbol self._fast = self.ema(self._symbol, 10, Resolution.DAILY) self._slow = self.ema(self._symbol, 50, Resolution.DAILY) def on_data(self, slice: Slice) -> None: if not self._slow.is_ready: return if self._fast.current.value > self._slow.current.value and not self.portfolio.invested: self.set_holdings(self._symbol, 1) elif self._fast.current.value < self._slow.current.value and self.portfolio.invested: self.liquidate() ``` ## Deploy Live Algorithms You must have an available [live trading node](https://www.quantconnect.com/docs/v2/cloud-platform/organizations/resources.md#04-Live-Trading-Nodes) for each live trading algorithm you deploy. Follow these steps to deploy a live algorithm: 1. [Open the project](https://www.quantconnect.com/docs/v2/cloud-platform/projects/getting-started.md#02-View-All-Projects) you want to deploy. 2. Click the ![Lightning icon](https://cdn.quantconnect.com/i/tu/deploy-live-icon.png) **Deploy Live** icon. 3. On the Deploy Live page, click the **Brokerage** field and then click **OANDA** from the drop-down menu. 4. Enter your OANDA account Id and access token. To get your account ID and access token, see the **Create an Account** section in the [Account Types](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages/cfd-and-forex-brokerages.md#02-Account-Types) documentation. Your account details are not saved on QuantConnect. 5. Click the **Environment** field and then click one of the environments. The following table shows the supported environments: | Environment | Description | | --- | --- | | Real | Trade real money with fxTrade | | Demo | Trade paper money with fxTrade Practice | 6. In the **Region** section, click the [region](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/getting-started.md#07-Redundancy) where you want to run the algorithm. 7. Click the **Node** field and then click the live trading node that you want to use from the drop-down menu. 8. (Optional) In the **Data Provider** section, click **Show** and change the data provider or add additional providers. 9. (Optional) [Set up notifications](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/notifications.md). 10. Configure the **Automatically restart algorithm** setting. By enabling [automatic restarts](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/deployment.md#07-Automatic-Restarts), the algorithm will use best efforts to restart the algorithm if it fails due to a runtime error. This can help improve the algorithm's resilience to temporary outages such as a brokerage API disconnection. 11. Click **Deploy**. The deployment process can take up to 5 minutes. When the algorithm deploys, the [live results page](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/results.md) displays. If you know your brokerage positions before you deployed, you can verify they have been loaded properly by checking your equity value in the runtime statistics, your cashbook holdings, and your position holdings. Restarts, including automatic restarts and redeployments, don't save the state of your algorithm. To learn what a restart recovers and how to persist the rest, see [State Persistence](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/deployment.md#10-State-Persistence). ## Deployment Details When you deploy a live algorithm with OANDA, the brokerage shares some details of the deployment, like the account it trades. Use them to tell concurrent deployments apart or to check that the algorithm connected to the account you expect. The details never include credentials. The following table describes the deployment details that OANDA shares: | Key | Description | | --- | --- | | `oanda-account-id` | The OANDA account that receives the orders. | | `oanda-environment` | The OANDA environment of the account, which is `Trade` for live accounts and `Practice` for demo accounts. | The `deployment_details` property of your algorithm is a read-only dictionary of the details. LEAN populates it before it calls the `initialize` method, so you can read it anywhere in your algorithm. ```python deployment_details = [f'{kvp.key}:{kvp.value}' for kvp in self.deployment_details] self.log(f'deployment_details: {deployment_details}') ``` The [/live/read](https://www.quantconnect.com/docs/v2/cloud-platform/api-reference/live-management/read-live-algorithm/live-algorithm-statistics.md) API endpoint also returns the details in its `deploymentDetails` field, so you can read them outside of the algorithm.