Documentation REST API

Our exchange rate API documentation is extensive and you can see below all the available endpoints, currencies and CFDs supported to help you integrate and use our data within your systems and applications. You can run sample API queries from our data documentation page once you login. For more bespoke and detailed query visit our interactive documents page once you have the API Key

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

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

Request URL Examples

// live endpoint 
https://marketdata.tradermade.com/api/v1/live?currency=EURGBP,GBPJPY&api_key=api_key

// historical  
https://marketdata.tradermade.com/api/v1/historical?date=2019-10-10&api_key=api_key

// tick_historical  
https://marketdata.tradermade.com//api/v1/tick_historical/GBPUSD/2020-10-23 08:30/2020-10-23 09:00?format=json&api_key=api_key

// tick_historical_sample  
https://marketdata.tradermade.com//api/v1/tick_historical_sample/GBPUSD/2020-10-23 08:30/2020-10-23 09:00?format=json&api_key=api_key

// minute_historical 
https://marketdata.tradermade.com/api/v1/minute_historical?currency=EURUSD&date_time=2019-10-09-13:24&api_key=api_key

// hour_historical  
https://marketdata.tradermade.com/api/v1/hour_historical?currency=EURUSD&date_time=2019-10-10-13:00&api_key=api_key

// convert  
https://marketdata.tradermade.com/api/v1/convert?api_key=api_key&from=EUR&to=GBP&amount=1000

// timeseries  
https://marketdata.tradermade.com/api/v1/timeseries?start_date=2015-01-01&end_date=2015-05-01&api_key=api_key

// pandasDF  
https://marketdata.tradermade.com/api/v1/pandasDF?currency=EURUSD&start_date=2015-01-01&end_date=2015-05-01&api_key=api_key

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 endpoint provide live sub-second data for over 1700 currency pairs and 20+ cfds. Default is currency but in order to request CFDs you need to mention cfd in the request query and ignore currency as a parameter. For full list visit live currencies list page or check live currencies list endpoint section

Request URL example for currency  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/live?currency=EURUSD,GBPUSD&api_key=api_key  

Request URL example for CFD  Copy

https://marketdata.tradermade.com/api/v1/live?cfd=GER30,UK100&api_key=api_key

Response JSON

{
  "endpoint": "live",
  "quotes": [
    {
      "ask": 1.11121,
      "base_currency": "EUR",
      "bid": 1.1112,
      "mid": 1.1112,
      "quote_currency": "USD"
    }
  ],
  "requested_time": "Tue, 29 Oct 2019 22:47:57 GMT",
  "timestamp": 1572389278
}
  

Request parameters:

Request URL  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/historical?currency=EURUSD,GBPUSD&date=2019-10-09&api_key=api_key

Response JSON

{
  "date": "2019-10-09",
  "endpoint": "historical",
  "quotes": [
    {
      "base_currency": "EUR",
      "close": 1.09702,
      "high": 1.09905,
      "low": 1.0952,
      "open": 1.09571,
      "quote_currency": "USD"
    },
    {
      "base_currency": "GBP",
      "close": 1.2206,
      "high": 1.22925,
      "low": 1.21977,
      "open": 1.22188,
      "quote_currency": "USD"
    }
  ],
  "request_time": "Thu, 31 Oct 2019 14:40:52 GMT"
}
    

Request URL for Tick Sample  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/tick_historical_sample/GBPUSD/2020-10-23 08:30/2020-10-23 09:00?api_key=api_key&format=json   
                     

Request parameters:

Request URL  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/tick_historical/GBPUSD/2020-10-23 08:30/2020-10-23 09:00?api_key=api_key&format=json

Response JSON

{
  "end_date": "2020-10-13 09:00", 
  "endpoint": "tick_historical", 
  "instrument": "GBPUSD", 
  "quotes": [
    {
      "ask": 1.30363, 
      "bid": 1.30359, 
      "inst": "GBPUSD", 
      "time": 1602577800339
    }, 
    {
      "ask": 1.30363, 
      "bid": 1.30361, 
      "inst": "GBPUSD", 
      "time": 1602577800539
    }, 
    {
      "ask": 1.3036, 
      "bid": 1.30357, 
      "inst": "GBPUSD", 
      "time": 1602577800941
    }, 
    {
      "ask": 1.30363, 
      "bid": 1.3036, 
      "inst": "GBPUSD", 
      "time": 1602577801739
    }
    ...
    ], 
  "start_date": "2020-10-13 08:30"
}
    

Request parameters:

Request URL  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/minute_historical?currency=EURUSD&date_time=2019-10-09-13:24&api_key=api_key

Response JSON

{
 "endpoint": "minute_historical",
 "currency": "EURUSD", 
 "date_time": "2019-10-09-13:24", 
 "close": 1.09802,  
 "high": 1.09816, 
 "low": 1.09798, 
 "open": 1.09807, 
 "request_time": "Thu, 31 Oct 2019 15:45:43 GMT"
}
    

Request parameters:

Request URL  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/hour_historical?currency=EURUSD&api_key=api_key&date_time=2019-10-10-13:00 

Response JSON

{
 "currency": "EURUSD", 
 "date_time": "2019-10-10-13:00", 
 "endpoint": "hour_historical", 
 "close": 1.10193, 
 "high": 1.10282, 
 "low": 1.10158, 
 "open": 1.10234, 
 "request_time": "Thu, 31 Oct 2019 15:45:43 GMT"
}
    

Request parameters:

Request URL for daily interval  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/timeseries?currency=EURUSD&api_key=api_key&start_date=2019-10-01&end_date=2019-10-10&format=records

Request URL for hourly interval  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/timeseries?currency=EURUSD&api_key=api_key&start_date=2020-10-23-00:00&end_date=2020-10-26-18:05&format=records&interval=hourly

Request URL for minute interval  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/timeseries?currency=EURUSD&api_key=api_key&start_date=2020-10-23-00:00&end_date=2020-10-26-18:05&format=records&interval=minute&period=15

Response JSON

{
  "base_currency": "EUR",
  "end_date": "2019-10-10",
  "endpoint": "timeseries",
  "quote_currency": "USD",
  "quotes": [
    {
      "close": 1.09331,
      "date": "2019-10-01",
      "high": 1.09437,
      "low": 1.0879,
      "open": 1.08991
    },
    {
      "close": 1.09591,
      "date": "2019-10-02",
      "high": 1.09638,
      "low": 1.09039,
      "open": 1.09331
    },
    ....
    {
      "close": 1.10055,
      "date": "2019-10-10",
      "high": 1.10341,
      "low": 1.09702,
      "open": 1.09711
    }
  ],
  "request_time": "Thu, 31 Oct 2019 15:34:09 GMT",
  "start_date": "2019-10-01"
}

Request parameters:

Request URL  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/pandasDF?currency=EURUSD&api_key=api_key&start_date=2019-10-01&end_date=2019-10-10&format=records&fields=ohlc

Response JSON

[
  {
    "close": 1.09331,
    "date": "2019-10-01",
    "high": 1.09437,
    "low": 1.0879,
    "open": 1.08991
  },
  {
    "close": 1.09591,
    "date": "2019-10-02",
    "high": 1.09638,
    "low": 1.09039,
    "open": 1.09331
  },
  ....
  {
    "close": 1.10055,
    "date": "2019-10-10",
    "high": 1.10341,
    "low": 1.09702,
    "open": 1.09711
  }
]
                

Request parameters:

Request URL  Copy Sign Up
                      

https://marketdata.tradermade.com/api/v1/convert?api_key=api_key&from=EUR&to=GBP&amount=1000

Response JSON

{
  "base_currency": "EUR",
  "quote": 0.861,
  "quote_currency": "GBP",
  "requested_time": "Thu, 31 Oct 2019 14:46:35 GMT",
  "timestamp": 1572533196,
  "total": 861
}

Below is an example for convert exchange rates data using PHP (CURL):

PHP (CURL)  Copy

?php

$curl = curl_init();

curl_setopt_array( $curl, array(
  CURLOPT_PORT => "443",
  CURLOPT_URL => "https://marketdata.tradermade.com/api/v1/convert?from=EUR&to=USD&amount=1000&api_key=api_key",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Below is an example for live exchange rates data using Python:

Python  Copy

import requests

url = "https://marketdata.tradermade.com/api/v1/live"

querystring = {"currency":"USDJPY","api_key":"api_key"}

response = requests.get(url, params=querystring)

print(response.json())

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