Forex API Documentation - Real-time & Historical

REST Endpoints

The Forex API Endpoints are currently in beta.

# To request top-of-book/last for specific base and quote pairs, use the following REST endpoint
https://api.tiingo.com/tiingo/fx/<ticker>/top

# Historical Intraday Prices for base and quote pairs
https://api.tiingo.com/tiingo/fx/<ticker>/prices?startDate=2019-06-30&resampleFreq=5min

Just remember, you will need your token in order to connect. Keep it safe.

.

2.4 REST - Forex

2.4.1 Overview of the Tiingo Forex API

Tiingo connects directly to tier-1 banks and FX dark pools to provide institutional-grade quality Forex quotes.

Benefits of the Tiingo Forex API

  • 140+ Forex Tickers Quoted
  • Data includes Top-of-Book (Bid/Ask) data
  • Data now includes intraday OHLC bar historical data for all your needs.
  • Quotes updated to the latest microsecond.
  • Data is served via a REST API & Websocket API.
  • Market hours are from 8pm EST Sunday through 5pm EST Friday.

For more details please visit the Forex API product page.

2.4 REST - Forex

2.4.2 Current Top-of-Book

To request top-of-book and last price data for a forex pair, use the following REST endpoints.
# To request top-of-book/last for mulitple base and quote pairs, use the following REST endpoint
https://api.tiingo.com/tiingo/fx/top?tickers=<ticker>,<ticker>,...<ticker>

# To request top-of-book/last for specific tickers, use the following REST endpoint
https://api.tiingo.com/tiingo/fx/<ticker>/top
Field Name
JSON Field
Data Type
Description
Ticker
ticker
string
Ticker related to the asset.
Timestamp
quoteTimestamp
datetime
The timestamp the data was last refresh on.
Mid Price
midPrice
float
The mid price of the current timestamp when both "bidPrice" and "askPrice" are not-null. In mathematical terms:
midPrice = (bidPrice + askPrice)/2.0
Bid Size
bidSize
float
The amount of units at the bid price.
Bid Price
bidPrice
float
The current bid price.
Ask Size
askSize
float
The amount of units at the ask price.
Ask Price
askPrice
float
The current ask price.
2.4 REST - Forex

2.4.3 Intraday Prices Endpoint

To request historical intraday prices for a forex pair, use the following REST endpoint.
# Current OHLC for the day
https://api.tiingo.com/tiingo/fx/<ticker>/prices?resampleFreq=1day

# Historical Intraday Prices
https://api.tiingo.com/tiingo/fx/<ticker>/prices?startDate=2019-06-30&resampleFreq=5min
Field Name
JSON Field
Data Type
Description
Date
date
datetime
The date this data pertains to.
Ticker
ticker
string
Ticker related to the asset.
Open
open
float
The opening price for the asset on the given date.
High
high
float
The high price for the asset on the given date.
Low
low
float
The low price for the asset on the given date.
Close
close
float
The closing price for the asset on the given date.