Documentation REST API

Supported Currencies

We support over 1700 currency pairs on our api endpoints. A list of live exchange rates can be accessed by visting our live currencies list page. We also have CFDs, Visit CFD list page for codes. You can also see below the full CFD list we provide:

Live Currencies List

A list of the available currencies for the /live and the /convert endpoint, can be accessed through requesting the live_currencies_list endpoint. In order to request currency data, add the currencies codes together to form a currency pair. For example EURUSD can be requested by adding EUR and USD together. In order to get the inverse of the same pair, simply reverse the quote to USDEUR. To access JSON object containing all available currency codes verus USD, Simply append your api_key to the TraderMade exchange rates API apicurrencies endpoint.

Request URL  CopySign Up

https://marketdata.tradermade.com/api/v1/live_currencies_list?api_key=api_key 

Response JSON

{
  "available_currencies": {
    "AED": "UAE Dirham",
    "ARS": "Argentine Peso",
    "AUD": "Australian Dollar",
    "BRL": "Brazilian Real",
    "BTC": "Bitcoin",
    "CAD": "Canadian Dollar",
    "CHF": "Swiss Franc",
    "CLP": "Chilean Peso",
    "CNY": "Chinese Yuan",
    "COP": "Colombian Peso",
    "CZK": "Czech Koruna",
    "DKK": "Danish Krone",
    "EUR": "Euro",
    "GBP": "British Pound Sterling",
    "HKD": "Hong Kong Dollar",
    "HRK": "Croatian Kuna",
    "HUF": "Hungarian Forint",
    "IDR": "Indonesian Rupiah",
    "ILS": "Israeli New Sheqel",
    "INR": "Indian Rupee",
    "ISK": "Icelandic Krona",
    "JPY": "Japanese Yen",
    "KRW": "South Korean Won",
    "KWD": "Kuwaiti Dinar",
    "MAD": "Moroccan Dirham",
    "MXN": "Mexican Peso",
    "MYR": "Malaysian Ringgit",
    "NOK": "Norwegian Krone",
    "NZD": "New Zealand Dollar",
    "PEN": "Peruvian Nuevo Sol",
    "PHP": "Philippine Peso",
    "PLN": "Polish Zloty",
    "RON": "Romanian Leu",
    "RUB": "Russian Ruble",
    "SEK": "Swedish Krona",
    "SGD": "Singapore Dollar",
    "THB": "Thai Baht",
    "TRY": "Turkish Lira",
    "TWD": "Taiwanese Dollar",
    "USD": "US Dollar",
    "XAG": "Silver (troy ounce)",
    "XAU": "Gold (troy ounce)",
    "ZAR": "South African Rand"
  },
  "endpoint": "live_currencies"
}

Historical Currencies List

We support over 1600 currency pairs on our historical data endpoints A list of the available currencies for the historical, pandasDF, timeseries,, and the minute_historical endpoints, can be accessed through requesting the historical_currencies_list endpoint or visiting list of historical exchange rates page. Below example is an abbreviated version.

Request URL  CopySign Up

https://marketdata.tradermade.com/api/v1/historical_currencies_list?api_key=api_key 

Response JSON

{
  "available_currencies": [
    "AEDEUR", 
    ....
    "EURPHP", 
    "EURPLN", 
    "EURRON", 
    "EURRUB", 
    "EURSEK", 
    "EURSGD", 
    "EURTHB", 
    "EURTRY", 
    "EURTWD", 
    "EURUSD", 
    "EURXAG", 
    "EURXAU", 
    "EURZAR", 
    "GBPAED", 
    "GBPAUD", 
    "GBPBRL", 
    "GBPCAD", 
    "GBPCHF", 
    "GBPCZK", 
    "GBPDKK", 
    "GBPEUR", 
    "GBPHKD", 
    "GBPHUF", 
    "GBPINR", 
    "GBPJPY", 
    "GBPKRW", 
    "GBPMXN", 
    "GBPMYR", 
    "GBPNOK", 
    "GBPNZD", 
    .... 
    "ZARUSD"
  ], 
  "endpoint": "historical_currencies"
}

Error Codes

Below are the error codes and responses for all the api endpoints.

Request parameters:

400 Response JSON

// 400 will return error which includes the details of the error   
{
    "errors": {
        "date": "YYYY-MM-DD time data '2019-10-' does not match format '%Y-%m-%d'"
    },
    "message": "Input payload validation failed"
}
                 

Live Rates

Historical Rates

The historical endpoint provides daily exchange rate data for the available currency pairs. Our daily bars are 22/22 as is the norm in financial markets. The daily bar finishes at and starts from 22:00 GMT. Our API lets you query any trading day over the past 20+ years (for some exotic currency pairs history may be less). The trading week starts from 22:00 hours on a Sunday and if date is requested for Saturday or Sunday Friday date is returned.

Tick Historical Rates

The Tick historical endpoint provides tick FX rate data for 50+ currency pairs. You can visit full currencies list page for complete list of codes. Historical Tick provides one month of data with each chunk not exceeding 60 minutes. This is only available on Advanced plan and uses 20 API request each time and only can be requested one currency pair per request.

You can't access tick historical without advanced plan but you can request a sample tick (shown below) which will get you to tick data going back 4 working days not including today. A maximum chunk of tick data in one request is 30 minutes and will take 20 requests away. You can only request one currency pair per request.

Minute Historical Rates

The API lets you query historical data for any minute for the past 30-years. You can only request one currency pair and one minute of data in one single request.

Hour Historical Rates

The API provides historical rates (ohlc) for the given hour over the past two-years

Timeseries

Time series api provides historical currency rates (OHLC) for daily, hourly and granular endpoints. Daily timeseries data is available for upto 15-year (for some exotic currency pairs history may be less) but max request is one-year per request. Hourly data for up to 2-month and less than an hour for upto two days. For example, if you are requesting less than hour data say a minute data on Friday you can only request start date from Thursday 00:00 GMT. Only one currency pair can be requested at a time.

History - daily - five years | hourly - two months | minute - two days

Pandas Data Frame

PandasDF api endpoint provides daily OHLC data for the currency requested in a pandas Data Frame that makes it really easy for python developers to use historical currency data. Request single currency when field parameter is "ohlc". Can request multiple currency when field is "close". Data is available for upto 15-year (for some exotic currency pairs history may be less) but max request is one-year per request.

Convert

The API provides conversion from one currency to another in real-time.

PHP (CURL)

Python

JavaScript (fetch)

Below is an example for historical exchange rates data using jQuery:

JavaScript (fetch)  Copy

var requestOptions = {
method : 'GET',
redirect : 'follow'
};

fetch( 'https://marketdata.tradermade.com/api/v1/historical?currency=EURUSD%2CGBPUSD&date=2019-10-09&api_key=api_key', requestOptions)
.then(response => response.text())
.then(result =>  console.log(result))
.catch(error =>  console.log( 'error', error));

JavaScript (jQuery)

Below is an example for historical exchange rates data using jQuery:

JavaScript (jQuery)  Copy

var settings = {
"url": "/api/v1/historical?currency=EURUSD%2CGBPUSD&date=2019-10-09&api_key=api_key",
"method": "GET",
"timeout": 0,
};

$.ajax(settings).done(function (response) {
console.log(response);
});