TraderMade Docs

Getting Started

Welcome to TraderMade. We provide clean forex and CFD data via easy-to-use delivery methods. We use HTTPS and RESTful structures that make it easier to request data. Authentication is over a secure HTTPS protocol, and responses are in JSON Format.

Following are a few simple steps to start getting data:

1. Sign up for API: Sign Up
2. Get your API Key: API Key
3. Start getting data: API Endpoints

Quick Start Guide

We have created a number of tutorials to help you get started with our REST API. Our tutorials cover topics such as Excel, Python, C#.

See our quick start tutorials: Visit Tutorials

Also check our interactive API Definition: Technical Documentation

Authentication

You need to include your API Key with each request to get data. You can find your API Key in your Dashboard once you sign in. We will prepopulate your API Key for you to run sample API queries once you Sign In.

You can also learn more on how to use our forex data API on the Tutorials Page.

Supported Currencies

We support over 8000+ currency pairs on our API endpoints. It includes 4000+ cryptocurrency pairs. A list of Forex and Crypto codes for live endpoints can be accessed by visiting our live currencies list page. We also have CFDs. Visit the CFD list page for codes.

Available SDKs

Python SDK

pip install tradermade

Python users can install our SDK to start using our API in seconds. We recommend going through our python SDK documentation. Alternatively, you can read our tutorial on how to use our Python-SDK for Forex Data.

import tradermade as tm

# set api key
tm.set_rest_api_key("api_key")

# get data
tm.live(currency='EURUSD,GBPUSD', fields=["bid", "mid", "ask"])  # returns live data
tm.historical(currency='EURUSD,GBPUSD', date="2021-04-22", interval="daily", fields=["open", "high", "low", "close"])  # returns historical data
tm.timeseries(currency='EURUSD', start="2025-04-10 00:00", end="2025-04-11 04:23", interval="hourly", fields=["open", "high", "low", "close"])  # returns time series data
tm.cfd_list()  # gets list of all CFDs available
tm.currency_list()  # gets list of all currency codes available

Kotlin client JVM

package io.tradermade.test_client_jvm

Java and Android users can set up our SDK in seconds. We recommend going through our Kotlin JVM Client.

// set api key
val api = TraderMadeAPI("YOUR_API_KEY")

// get data
val liveData = api.getLiveData("EURUSD,GBPUSD") // returns live data
val historicalData = api.getHistoricalData("EURUSD", "2023-08-01") // returns historical data
val timeSeriesData = api.getTimeSeriesData("EURUSD", "2023-08-01", "2023-08-10") // returns time series data
val convertedAmount = api.convertCurrency("EUR", "USD", 1000.0) // returns converted amount

Go SDK

package io.tradermade.test_client_jvm

You can learn about our Go SDK here. To use this SDK in your Go project, run:

This Go SDK provides easy access to TraderMade's forex data API. It allows you to fetch live rates, historical data, perform currency conversions, and retrieve time series data. We recommend going through our TraderMade Go Library Tutorial.

import (
    tradermade "github.com/tradermade/Go-SDK/rest"
)

client := tradermade.NewRESTClient("YOUR_API_KEY")

currencyPairs := []string{"EURUSD", "GBPUSD", "USDJPY"}
liveRates, err := client.GetLiveRates(currencyPairs)
if err != nil {
    log.Fatalf("Error fetching live rates: %v", err)
}

for _, quote := range liveRates.Quotes {
    fmt.Printf("Base: %s, Quote: %s, Bid: %f, Ask: %f, Mid: %f\n",
        quote.BaseCurrency, quote.QuoteCurrency, quote.Bid, quote.Ask, quote.Mid)
}

Data Endpoints

Live Currencies List

You can request the live_currencies_list endpoint to access a list of the available currencies for the live and the convert endpoints. Add the currency codes to form a currency pair and request currency data. For example, EURUSD can be requested by adding EUR and USD together. Reverse the quote to USDEUR to get the inverse of the same pair. To access the JSON object containing all available currency codes used, append your api_key to the TraderMade exchange rates API api/currencies endpoint.

Request URL

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

Live Crypto List

We offer data for 4000+ cryptocurrency pairs. A list of Forex and Crypto codes for live endpoint can be accessed by visiting our live currencies list page. A list of the available cryptocurrencies for the live endpoint can be accessed through the live_crypto_list endpoint. Add the currency codes to form a currency pair. For example DOGEUSD can be requested by adding DOGE and USD together. To access the JSON object containing all available crypto codes used, append your api_key to the TraderMade live crypto API endpoint.

Request URL

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

Historical Currencies List

We support over 1500 currency pairs on our historical data endpoints. Request the historical_currencies_list endpoint or visit the historical currencies list page for a complete list of codes. Historical Tick data is available for 50+ currency pairs and can be accessed using the tick_historical endpoint.

Request URL

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

Exchange Rates API

The TraderMade exchange rates API has nine endpoints serving different sets of data. Below is one example for each of the endpoints.

Request URL

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

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

// tick_historical
https://marketdata.tradermade.com/api/v1/tick_historical/GBPUSD/2025-04-10-08:30/2025-04-10-09:00?api_key=YOUR_API_KEY

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

// minute_historical
https://marketdata.tradermade.com/api/v1/minute_historical?currency=EURUSD&date_time=2025-04-10-12:30&api_key=YOUR_API_KEY

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

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

// timeseries
https://marketdata.tradermade.com/api/v1/timeseries?start_date=2025-04-10&end_date=2025-04-11&currency=EURUSD&api_key=YOUR_API_KEY

// pandasDF
https://marketdata.tradermade.com/api/v1/pandasDF?currency=EURUSD&api_key=YOUR_API_KEY

Live Rates

The live rates endpoint provides live sub-second data for over 4200+ currency pairs and 200+ CFDs. For the endpoint, visit the live currencies list page or request the live_currencies_list endpoint.

Request URL

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

Historical Rates

The historical endpoint provides daily exchange rate data for the available currency pairs. Daily bars are 22:22 as in the norm in financial markets.

Request URL

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

Tick Historical Rates

The tick_historical endpoint provides tick FX rate data for 50+ currency pairs.

Request URL

https://marketdata.tradermade.com/api/v1/tick_historical/GBPUSD/2025-04-10-08:30/2025-04-10-09:00?api_key=YOUR_API_KEY

Minute Historical Rates

The API lets you query historical data for any minute for the past 30 years.

Request URL

https://marketdata.tradermade.com/api/v1/minute_historical?currency=EURUSD&date_time=2025-04-10-12:30&api_key=YOUR_API_KEY

Hour Historical Rates

The API provides historical rates (OHLC) for the given hour over the past two years.

Request URL

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

Error Codes

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

Example Error Response

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

Examples

Below is an example showing the convert exchange rates data.

import requests

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

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

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

print(response.json())

$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=1D29DOHzGwcf5UaFSaq4",
    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;
}

library (httr)
library (jsonlite)

req <- "https://marketdata.tradermade.com/api/v1/live?currency=EURUSD,GBPUSD&api_key=1D29DOHzGwcf5UaFSaq4"

data_raw <- GET(url = req)


data_text = content(data_raw, "text", encoding = "UTF-8")

data_json = fromJSON(data_text, flatten=TRUE)

dataframe = as.data.frame(data_json)

dataframe

package main

import (

    "encoding/json"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"

)

type data struct {
    Endpoint       string                   `json:'endpoint'`
    Quotes         []map[string]interface{} `json:'quotes'`
    Requested_time string                   `json:'requested_time'`
    Timestamp      int32                    `json:'timestamp'`
}

func main(){
    currencies := "EURUSD,GBPUSD"
    api_key := "1D29DOHzGwcf5UaFSaq4"
    url := "https://marketdata.tradermade.com/api/v1/live?currency=" + currencies + "&api_key=" + api_key

    resp, getErr := http.Get(url)
    if getErr != nil {
        log.Fatal(getErr)
    }

    body, readErr := ioutil.ReadAll(resp.Body)
    if readErr != nil {
        log.Fatal(readErr)
    }

    fmt.Println(string(body)) 


    data_obj := data{}

    jsonErr := json.Unmarshal(body, &data_obj)
    if jsonErr != nil {
        log.Fatal(jsonErr)
    }

    fmt.Println("endpoint", data_obj.Endpoint, "requested time", data_obj.Requested_time, "timestamp", data_obj.Timestamp)

    for key, value := range data_obj.Quotes {

            fmt.Println(key)

            fmt.Println("symbol", value["base_currency"]+value["quote_currency"], "bid", value["bid"], "ask", value["ask"],
    "mid", value["mid"])

    }

} 

using System;
using System.Net.Http;
using Newtonsoft.Json;


namespace crest
{
    class Program
    {
        static async System.Threading.Tasks.Task Main(string[] args)
        {
            HttpClient client = new HttpClient();
            HttpResponseMessage response = await client.GetAsync("https://marketdata.tradermade.com/api/v1/live?currency=EURUSD,GBPUSD&api_key=1D29DOHzGwcf5UaFSaq4");
            response.EnsureSuccessStatusCode();
            var responseBody = await response.Content.ReadAsStringAsync();
            var result = JsonConvert.DeserializeObject(responseBody);
            foreach (var item in result.quotes)
            {
                            Console.WriteLine(" Result: " +  item.base_currency + "/" +  item.quote_currency + " " + item.mid);

            }
        }

        public class CurrencyDetails
        {
                public string endpoint { get; set; }
                public quotes[] quotes { get; set; }
                public string requested_time { get; set; }
                public long timestamp { get; set; }

        }

        public class quotes
        {
            public double ask { get; set; }
            public double bid { get; set; }
            public string base_currency { get; set; }
            public double mid { get; set; }
            public string quote_currency { get; set; }
        }



    }
}

const axios = require('axios');

axios.get('https://marketdata.tradermade.com/api/v1/live?currency=EURUSD,GBPUSD,UK100&api_key=1D29DOHzGwcf5UaFSaq4')
    .then(response => {

        console.log(response.data);

        console.log(response.data.quotes[1]);
    })
    .catch(error => {
        console.log(error);
    });

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

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

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

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