Documentation 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 data, add the currencies codes together to form a currency pair. For example, EURUSD can be requested by adding EUR and USD together. 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 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.

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 one-year for multiple currencies in 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 time-series data is available for up to 5-year. Hourly Data for up to 2-month and less than an hour for up to two days.

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);
});