Skip to main content

A Python Wrapper Class for the RESTful API as provided by FXCM Forex Capital Markets Ltd.

Project description

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. is a Python wrapper package for that API.

# To get started with the the API and the package, a demo account with FXCM is sufficient. You can open such an account under

# Installation happens via pip install on the command line.

pip install fxcmpy

# To connect to the API, you need an API token that you can create or revoke from within your (demo) account in the 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’, server=’demo’)

However, 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.

[FXCM] log_level = error log_file = PATH_TO_AND_NAME_OF_LOG_FILE 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’, server=’demo’)

# The detailed documentation of this wrapper is found under:

The detailed documentation of the API is found under:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for fxcmpy, version 1.2.9
Filename, size File type Python version Upload date Hashes
Filename, size fxcmpy-1.2.9-py3-none-any.whl (28.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size fxcmpy-1.2.9.tar.gz (62.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page