REST Endpoints
# Top-of-Book Data for specific tickers
https://api.tiingo.com/tiingo/crypto/top?tickers=btcusd,fldcbtc

# Real-time (Latest) Data for specific tickers
https://api.tiingo.com/tiingo/crypto/prices?tickers=btcusd,fldcbtc

# Historical Prices
https://api.tiingo.com/tiingo/crypto/prices?tickers=btcusd,fldcbtc&startDate=2019-01-02&resampleFreq=5min

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

.

2.3 REST - Crypto

2.3.1 Overview

Tiingo connects to a variety of cryptocurrency exchanges to create a consolidated top-of-book feed.

The Benefits of Tiingo Crypto

  • Over 8,000 tickers covered, with more added frequently.
  • You can choose which exchanges to get data from, and Top-of-Book and aggregate OHLCV data are then compiled on-the-fly.
  • Data includes Top-of-Book (Bid/Ask) and Last Sale (trade) Data.
  • Data includes intraday OHLC bar historical data for all your needs.
  • Tiingo compiles the data to give you updates when the bid/ask and last price change.
  • Tiingo enriches the data, giving you more data for your convenience.
  • Download the entire market in one API call.

You can find out about the full product offering on the Product - Crypto page.

2.3 REST - Crypto

2.3.2 Real-time & Historical Prices Endpoint

To download real-time and historical prices, use the following REST endpoints.
# Intraday data for current day or last business day
https://api.tiingo.com/tiingo/crypto/prices

# Historical intraday data
https://api.tiingo.com/tiingo/crypto/prices?tickers=<ticker>&startDate=2019-01-02&resampleFreq=5min

The Crypto Prices endpoint returns meta information about the crypto pair along with the price data related to that pair. This is different tham the other APIs and helps with crypto currency ambiguity.

Check out the table below to see the top-level fields returned from the prices crypto API.

Field Name
JSON Field
Data Type
Description
Ticker
ticker
string
Ticker related to the asset.
Base Currency
baseCurrency
string
The base pair of the cryptocurrency, e.g. "btc" for "btcusd".
Quote Currency
quoteCurrency
string
The quote pair of the cryptocurrency, e.g. "usd" for "btcusd".
Price Data
priceData
object
Stores the top-of-book data being returned. See the table below for the fields in this object.
Exchange Data
exchangeData
object
The underlying data for each exchange. This will only be returned if the includeRawExchangeData flag is set to "true".

To see what fields are returned in the "priceData" field, please see the table below.

Field Name
JSON Field
Data Type
Description
Date
date
datetime
The datetime this data pertains to. It will be a timestamp dependent upon the resampleFreq parameter. For example, if resampleFreq=5min, it will be in 5 min increments.
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.
Trade Done
tradesDone
int32
The number of trades done on the given date.
Volume
volume
float
The volume done for the asset on the specific date in the base currency.
Volume Notional
volumeNotional
float
The last size done for the asset on the specific date in the quote currency. The volume done for the asset on the specific date in the quote currency.

In mathematical terms:
volumeNotional = close * volume
2.3 REST - Crypto

2.3.3 Meta Endpoint

To request meta data for a cryptocurrency, use the following REST endpoints.
# To request meta data for all tickers, use the following REST endpoint
https://api.tiingo.com/tiingo/crypto
    
# To request meta data for a specific tickers, use the following REST endpoint
https://api.tiingo.com/tiingo/crypto?tickers=<ticker>
Field Name
JSON Field
Data Type
Description
Ticker
ticker
string
Ticker related to the asset.
Base Currency
baseCurrency
string
The base pair of the cryptocurrency, e.g. "btc" for "btcusd".
Quote Currency
quoteCurrency
string
The quote pair of the cryptocurrency, e.g. "usd" for "btcusd".
Name
name
string
Full-length name of the asset.
Description
description
string
Long-form descripton of the asset.
2.3 REST - Crypto

2.3.4 Top-of-Book Endpoint

To request top-of-book data, use the following REST endpoints.
# Top-of-book data
https://api.tiingo.com/tiingo/crypto/top?tickers=<ticker>

The Crypto Top-of-Book endpoint returns meta information about the crypto pair along with the top-of-book data related to that pair. This is different tham the other APIs and helps with crypto currency ambiguity.

Check out the table below to see the top-level fields returned from the top-of-book crypto API.

Deprecation Warning: After much consideration, we have made the decision to deprecate the top-of-book endpoint. This is the first endpoint we've fully deprecated in our firm's eight year history, and we do not make this decision lightly. Right now the crypto exchange feeds have been found unreliable to properly construct the best bid/ask in a way that's consistent. Some feeds remain inconsistent, timestamps are sometimes incorrectly stated, and other times it appears as if the messages may not be consistently ordered where the best bid/ask can be constructed. While this task can be done, we believe it must be done with a subset of specific exchanges and encourage clients who need full order-book construction to build this in-house with exchanges that are relevant to you. If you need last price, that is available on the /prices endpoint described in the above section. Our philosophy is that no data is better than bad data, and we believe for now, the below task remains too onerous to be done with all 60+ exchanges we cover in a way that properly handles each exchange's potential quirks, let alone when the quirks are constantly changing. We believe Crypto exchanges will eventually converge to equity/futures level reliability, but right now the technology remains early. We will constantly be monitoring and deciding if we want to re-enable the top-of-book endpoint.

Field Name
JSON Field
Data Type
Description
Ticker
ticker
string
Ticker related to the asset.
Base Currency
baseCurrency
string
The base pair of the cryptocurrency, e.g. "btc" for "btcusd".
Quote Currency
quoteCurrency
string
The quote pair of the cryptocurrency, e.g. "usd" for "btcusd".
Top-of-Book Data
topOfBookData
object
Stores the top-of-book data being returned. See the table below for the fields in this object.
Exchange Data
exchangeData
object
The underlying data for each exchange. This will only be returned if the includeRawExchangeData flag is set to "true".

To see what fields are returned in the "topOfBookData" field, please see the table below.

Field Name
JSON Field
Data Type
Description
Quote Timestamp
quoteTimestamp
datetime
The timestamp the last time the quote (bid/ask) data was received from any crypto exchange.
Last Sale Timestamp
lastSaleTimestamp
datetime
The timestamp the last time the trade (last/lastSize) data was received from any crypto exchange.
Last Price
lastPrice
float
Last price is the last price that was executed on any crypto exchange.
Last Size
lastSize
float
The amount of crypto volume done at the last price in the base currency.
Last Size Notional
lastSizeNotional
float
The last size done for the asset on the specific date in the quote currency. The notional of the volume traded.

In mathematical terms:
lastSizeNotional = lastPrice * lastSize
Last Exchange
lastExchange
string
The full name of the exchange the "lastPrice" and "lastSize" were executed on.
Bid Size
bidSize
float
The amount of shares at the bid price.
Bid Price
bidPrice
float
The current bid price.
Bid Exchange
bidExchange
string
The full name of the exchange the "bidPrice" and "bidSize" are located on.
Ask Size
askSize
float
The amount of shares at the ask price.
Ask Price
askPrice
float
The current ask price.
Ask Exchange
askExchange
string
The full name of the exchange the "askPrice" and "askSize" are located on.