API Documentation

Error Codes

Our exchange rates API endpoints supports a number of error codes. Below is a summary of these error codes.

Error Codes:

API Endpoints

Live Rates

The FXMarketAPI API's live endpoint's provides a Real-Time exchange rates feed to the users.

Request Example:

https://fxmarketapi.com/apiliveSign Up
?api_key=api_key

Request Parameters:

Response Example:

{
  "timestamp": 1541521247,
  "price": {
    "AUDUSD": 0.7225,
    "EURUSD": 1.1412,
    "GBPUSD": 1.3079,
    "USDJPY": 113.3845
  }
}

Response Properties:

Historical Rates

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

Request Example:

https://fxmarketapi.com/apihistoricalSign Up
?api_key=api_key
&date=2018-05-02

Request Parameters:

Response Example:

{
  "date": "2018-05-02",
  "price": {
    "EURUSD": 1.19509,
    "GBPUSD": 1.35748,
    "USDJPY": 109.8405
  }
}

Response Properties:

Convert

The FXMarketAPI API's convert endpoint's provides a Real-Time conversion of exchange rates from one currrency to other.

Request Example:

https://fxmarketapi.com/apiconvertSign Up
?api_key=api_key
& from=EUR
& to=SEK
& amount=1000

Request Parameters:

Response Example:

{
  "price": 10.2477,
  "timestamp": 1544112937,
  "total": 10247.7
}

Response Properties:

Time-Series

Time series api provides OHLC data for the currencies requested. It is recommended that you do not request more than one year of data at a time, or more than three currencies at a time. To request just close price just use &format = close (optional parameter)

Request Example:

  
  https://fxmarketapi.com/apitimeseriesSign Up
  ?api_key=api_key
  & currency=EURUSD,GBPUSD
  & start_date=2018-07-02
  & end_date=2018-09-03
  & format=ohlc

  
  

Request Parameters:

Response Example:

{
  "start_date": "2018-07-02",
  "end_date": "2018-09-03",
  "price": {
      "2018-07-02": {
        "EURUSD": {
          "close": 1.1639,
          "high": 1.1692,
          "low": 1.1591,
          "open": 1.168
        },
        "GBPUSD": {
          "close": 1.3143,
          "high": 1.3212,
          "low": 1.3095,
          "open": 1.3194
        }
      },
      "2018-07-03": {
        "EURUSD": {
          "close": 1.1658,
          "high": 1.1673,
          "low": 1.162,
          "open": 1.1639
        },
        "GBPUSD": {
          "close": 1.3192,
          "high": 1.3208,
          "low": 1.3115,
          "open": 1.315
        }
      },
      ...
   }
}

Response Parameters:

Exchange Rates Change

The Apichange endpoint enables the user to request the difference and percentage change for a given currency between two dates. The user will also be returned a start rate and an end rate for the date specified.

Request Example:

https://fxmarketapi.com/apichangeSign Up
?api_key=api_key
& currency=EURUSD,GBPUSD
& start_date=2018-07-02
& end_date=2018-09-03

Request Parameters:

Response Example:

{
  "start_date": "2018-07-02",
  "end_date": "2018-09-03",
  "price": {
    "EURUSD": {
      "change": 0.0038,
      "end_rate": 1.1601,
      "pct_change": -0.3299,
      "start_rate": 1.16394
    },
    "GBPUSD": {
      "change": 0.0183,
      "end_rate": 1.296,
      "pct_change": -1.3909,
      "start_rate": 1.31428
  }
}
}

Response Parameters:

Pandas

Pandas api returns currency data in a format that is easy to use in Jupyter Notebook/Python. If one currency is requested a dataframe is returned with OHLC data which is datetime indexed. If multiple currencies are requested dataframe is returned with close data for multiple currencies which are datetime indexed

Request Example:

https://fxmarketapi.com/apipandasSign Up
?api_key=api_key
& currency=EURUSD,GBPUSD
& start_date=2018-07-02
& end_date=2018-09-03

  import pandas as pd

  df = pd.read_json("https://fxmarketapi.com/apipandas?api_key=api_key&currency=EURUSD,GBPUSD&start_date=2018-07-02&end_date=2018-09-03")

  

Request Parameters:

Response Example:

                

                  

                    

                      

                      
EURUSD
                      
GBPUSD
                    
                  
                  

                    

                      
2018-11-30
                      
1.13190
                      
1.27506
                    
                    

                      
2018-12-03
                      
1.13548
                      
1.27239
                    
                    

                      
2018-12-04 
                      
1.13432
                      
1.27183 
                    
                    

                    
.....
                    
                  
                

Examples

PHP (CURL)

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

?php

$curl = curl_init();

curl_setopt_array( $curl, array(
  CURLOPT_PORT => "5000",
  CURLOPT_URL => "https://fxmarketapi.com/apilive?currency=USDJPY,AUDUSD,GBPUSD,EURUSD&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://fxmarketapi.com/apilive"

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

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

print(response.json())

JavaScript (jQuery.ajax)

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

var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://fxmarketapi.com/apilive?currency=USDJPY,AUDUSD,GBPUSD,EURUSD&api_key=api_key",
  "method": "GET",
  "headers": {}
  }

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