Documentation Rates API v1

Available Currencies For Live and Convert Endpoints

A list of the available currencies for the /live and the /convert endpoint, can be accessed through requesting the live_currencies_list endpoint or visiting list of live exchange rates. 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.

We also have CFDs for live endpoint, following is the list to all the CFDs we provide through our live endpoint:

Request Example:

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

Response Example:

{
  "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"
}

Available Currencies For Historical, PandasDF, Timeseries, and Minute_Historical 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

Request Example:

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

Response Example:

{
  "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"
}

Response Parameters:

Endpoints

The TraderMade exchange rates API has seven API endpoints serving different sets of data. Below is a summary of these endpoints.

Available Endpoints:

API Endpoints

Historical Rates

The historical endpoint provides daily exchange rate data for the available currency pairs. Daily provides 10-years of data.

Minute Historical Rates

The API provides minute historical rate for the past 30-year for one currency pair in one single request.

Hour Historical Rates

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

Convert

The API provides daily exchange rate data for the past 10 years

Timeseries

Time series api provides historical currency rates (OHLC) for daily, hourly and granular endpoints. Daily timeseries data is avalable for upto 5-year. 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.

Pandas Data Frame

PandasDF api endpoint provides OHLC data for the currency requested in a pandas Data Frame that makes it really easy for python developers to use historical currency data.

PHP (CURL)

Python

JavaScript (fetch)

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

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

fetch( 'https://marketdata.tradermade.com/api/v1/historical?date=2019-10-09¤cy=EURUSD%2CGBPUSD&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:

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

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