FXCMPY Python Wrapper

FXCM provides a RESTful API to interact with its trading platform. Among others, it allows the retrieval of historical data as well as of streaming data. In addition, it allows to place different types of orders and to read out account information. The overall goal is to allow the implementation automated, algortithmic trading programs. fxcmpy.py is a Python wrapper package for that API.

Demo Account

To get started with the the API and the package, a demo account with FXCM is sufficient. You can open such an account under https://www.fxcm.com/uk/forex-trading-demo/.

Package Installation

Installation happens via pip install on the command line.

pip install fxcmpy

API Token

To connect to the API, you need an API token that you can create or revoke from within your (demo) account in Trading Station.

In an interactive context, you can use e.g. a variable called TOKEN to reference your unique API token.

Connecting to the server, then boils down to the following line of code.

con = fxcmpy.fxcmpy(access_token=TOKEN, log_level='error')

Configuration file

It is recommended to store the API token in a configuration file which allows for re-usability and hides the token on the GUI level. The file should contain the following lines.

log_level = error
access_token = YOUR_FXCM_API_TOKEN

It is assumed onwards that this file is in the current working directory and that its name is fxcm.cfg.

With such a configuration file in the current working directory, only the filename need to be passed as a parameter to connect to the API.

con = fxcmpy.fxcmpy(config_file='fxcm.cfg')


fxcmpy wrapper Sample Code

  1. EMA Crossover Strategy.ipynb
  2. Real-Time SMA Crossover Strategy.ipynb
  3. EMA Crossover Strategy and Backtest-checkpoint.ipynb
  4. Hull Moving Average Strategy.ipynb
  5. Bollinger Band Backtest Part 1.ipynb
  6. Bollinger Band Backtest Part 2.ipynb
  7. EMA Crossover Strategy backtest.py
  8. Introduction to Monte Carlo Simulation.ipynb
  9. Stochastic Strategy Backtest.py
  10. BB ADX Range Strategy.py
  11. Bitcoin Breakout Strategy.py
  12. Python Strategy Template.py
  13. RSI Range Strategy with Trading Time Range.py
  14. RSI Range Strategy.py
  15. RSI with SMA Trend Filter.py
  16. SMA Crossover Strategy.py


This is for personal use and abides by our EULA. For more information, you may contact us at api@fxcm.com


CFDs are complex instruments and come with a high risk of losing money rapidly due to leverage. 73.62% of retail investor accounts lose money when trading CFDs with this provider. You should consider whether you understand how CFDs work and whether you can afford to take the high risk of losing your money. High Risk Investment Notice: Trading Forex/CFD’s on margin carries a high level of risk and may not be suitable for all investors as you could sustain losses in excess of deposits. The products are intended for retail, professional and eligible counterparty clients. For clients who maintain account(s) with Forex Capital Markets Limited (“FXCM LTD”), retail clients could sustain a total loss of deposited funds but are not subject to subsequent payment obligations beyond the deposited funds and professional clients could sustain losses in excess of deposits. Prior to trading any products offered by FXCM LTD, inclusive of all EU branches, FXCM Australia Pty. Limited, FXCM South Africa (PTY) Ltd, any affiliates of aforementioned firms, or other firms within the FXCM group of companies [collectively the “FXCM Group”], carefully consider your financial situation and experience level. If you decide to trade products offered by FXCM Australia Pty. Limited (“FXCM AU”) (AFSL 309763), you must read and understand the Financial Services Guide, Product Disclosure Statement and Terms of Business. Our Forex/CFD prices are set by FXCM, are not made on an Exchange and are not governed under the Financial Advisory and Intermediary Services Act. The FXCM Group may provide general commentary which is not intended as investment advice and must not be construed as such. Seek advice from a separate financial advisor. The FXCM Group assumes no liability for errors, inaccuracies or omissions; does not warrant the accuracy, completeness of information, text, graphics, links or other items contained within these materials. Read and understand the Terms and Conditions on the FXCM Group’s websites prior to taking further action.