Try our API in 3 Easy Steps

Our documentation is extensive and you can start in minutes.

Step 1

Sign up for API

Signup

Step 2

Get your API Key

Get API Key

Step 3

Start getting data

Run Request

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 clicking the link stated here. 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. In order to get the inverse of the same pair, simly 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://tm-marketdata.com/api/v1/live_currencies_list?api_key=api_key

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 clicking the link stated here.

Request Example:
https://tm-marketdata.com/api/v1/historical_currencies_list?api_key=api_key

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:
Field Type Description
currencies JSON Object Returns all currency pair codes and thier names in a (string) format that are available through the API

Endpoints

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

Available Endpoints:
API Endpoints
https://tm-marketdata.com/api/v1/live?&api_key=api_key¤cy=EURGBP,GBPJPY
https://tm-marketdata.com/api/v1/historical?date=2019-10-10&api_key=api_key
https://tm-marketdata.com/api/v1/convert?api_key=api_key&from=EUR&to=GBP&amount=1000
https://tm-marketdata.com/api/v1/timeseries?start_date=2015-01-01&end_date=2015-05-01&api_key=api_key
https://tm-marketdata.com/api/v1/minute_historical?currency=EURUSD&date_time=2019-10-10&api_key=api_key
https://tm-marketdata.com/api/v1/pandasDF?currency=EURUSD&start_date=2015-01-01&end_date=2015-05-01&api_key=api_key

Live Rates

Live rates endpoint provide live sub-second data for over 40 currencies

Params
currency EURUSD,GBPUSD
api_key Your API key
Request Example 
https://tm-marketdata.com/api/v1/live?api_key=api_key&currency=EURUSD,GBPUSD

Response Example:
{
  "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
}


Params
currency EURUSD,GBPUSD
date 2019-10-09
api_key Your API key
Request Example 
https://tm-marketdata.com/api/v1/historical?api_key=api_key&date=2019-10-09&currency=EURUSD,GBPUSD

Response Example:
{
  "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"
}

Params
from EUR
to GBP
amount 1000
api_key Your API key
Request Example 
https://tm-marketdata.com/api/v1/convert?api_key=api_key&from=EUR&to=GBP&amount=1000

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

Params
currency EURUSD
date_time 2019-10-10-13:24
api_key Your API key
Request Example 
https://tm-marketdata.com/api/v1/historical?api_key=api_key&date=2019-10-09&currency=EURUSD,GBPUSD

Response Example:
{
  "endpoint": "minute_historical",
  "currency": "EURUSD",
  "date_time": "2019-10-10-13:24",
  "high": 1.10225,
  "low": 1.10203,
  "open": 1.1021,
  "close": 1.10215,
  "request_time": "Thu, 31 Oct 2019 15:45:43 GMT"
}

Params
currency EURUSD
start_date 2019-10-01
end_date 2019-10-10
format records (other choices are - index , columns, split)
Request Example 
https://tm-marketdata.com/api/v1/timeseries?api_key=api_key&currency=EURUSD&start_date=2019-10-01&end_date=2019-10-10&format=records

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

Params
currency EURUSD
start_date 2019-10-01
end_date 2019-10-10
format records (other choices are - index , columns, split)
fields ohlc (other choice is - close)
Request Example 
https://tm-marketdata.com/api/v1/pandasDF?api_key=api_key&currency=EURUSD&start_date=2019-10-01&end_date=2019-10-10&format=records&fields=ohlc

Response Example 
[
  {
    "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
  }
]

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

?php

$curl = curl_init();

curl_setopt_array( $curl, array(
  CURLOPT_PORT => "5000",
  CURLOPT_URL => "https://tm-marketdata.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;
}

Python

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

import requests

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

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

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

print(response.json())

JavaScript (fetch)

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

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

fetch( 'https://tm-marketdata.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);
});