Tiingo API Free Plan: Full Guide to Real-Time Financial Market Data | Sumiran Dahal

Tiingo API Documentation

Note: For all endpoints, you must supply token=<your_token> as a query parameter.

Example:
curl "https://api.tiingo.com/tiingo/daily/<ticker>?token=<token>"

End of Day (Stock) API
Crypto API
Forex API
IEX API
Fundamental Data API
WebSocket Endpoints
Utilities - Search

2.1 End of Day (Stock) API

REST Endpoints

Endpoint	Description
`https://api.tiingo.com/tiingo/daily/<ticker>`	Meta Data
`https://api.tiingo.com/tiingo/daily/<ticker>/prices`	Latest Price
`https://api.tiingo.com/tiingo/daily/<ticker>/prices?startDate=2012-1-1&endDate=2016-1-1`	Historical Prices

2.1.2 End-of-Day Endpoint

To request price data for a stock, use the following REST endpoints.

Latest Price Information

https://api.tiingo.com/tiingo/daily/<ticker>/prices

Historical Price Information

https://api.tiingo.com/tiingo/daily/<ticker>/prices?startDate=2012-1-1&endDate=2016-1-1&format=csv&resampleFreq=monthly

2.1.3 Meta Endpoint

Our meta information comes from a variety of sources, but is used to help communicate details about an asset in our database to our users.

For a daily list of all tickers accessible via Tiingo, please see the following file which is updated daily: supported_tickers.zip

Otherwise, to request meta data for a stock, use the following REST endpoint.

https://api.tiingo.com/tiingo/daily/<ticker>

2.2: Crypto

REST Endpoints

Endpoint	Description
`https://api.tiingo.com/tiingo/crypto/top?tickers=btcusd,fldcbtc`	Top-of-Book Data for specific tickers
`https://api.tiingo.com/tiingo/crypto/prices?tickers=btcusd,fldcbtc`	Real-time (Latest) Data for specific tickers
`https://api.tiingo.com/tiingo/crypto/prices?tickers=btcusd,fldcbtc&startDate=2019-01-02&resampleFreq=5min`	Historical Prices

2.3 REST - CRYPTO

2.3.1 Overview

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

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.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

2.3.3 Meta Endpoint

To request meta data for a cryptocurrency, use the following REST endpoints.

To request meta data for all tickers

https://api.tiingo.com/tiingo/crypto

To request meta data for specific tickers

https://api.tiingo.com/tiingo/crypto?tickers=<ticker>

2.3.4 Top-of-Book Endpoint

To request top-of-book data, use the following REST endpoints.

https://api.tiingo.com/tiingo/crypto/top?tickers=<ticker>

2.4 REST - FOREX

Note: The Forex API Endpoints are currently in beta.

REST Endpoints

Endpoint	Description
`https://api.tiingo.com/tiingo/fx/<ticker>/top`	Top-of-Book/Last for specific base and quote pairs
`https://api.tiingo.com/tiingo/fx/<ticker>/prices?startDate=2019-06-30&resampleFreq=5min`	Historical Intraday Prices

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

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.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 multiple base and quote pairs

https://api.tiingo.com/tiingo/fx/top?tickers=<ticker>,<ticker>,...<ticker>

To request top-of-book/last for specific tickers

https://api.tiingo.com/tiingo/fx/<ticker>/top

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

2.5 REST - IEX

REST Endpoints

Endpoint	Description
`https://api.tiingo.com/iex`	Top-of-Book/Last for all tickers
`https://api.tiingo.com/iex/<ticker>`	Top-of-Book/Last for specific tickers
`https://api.tiingo.com/iex/<ticker>/prices?startDate=2019-01-02&resampleFreq=5min`	Historical Intraday Prices

2.5.2 Current Top-of-Book & Last Price

To request top-of-book and last price data for a stock, use the following REST endpoints.

To request top-of-book/last for all tickers

https://api.tiingo.com/iex

To request top-of-book/last for specific tickers

https://api.tiingo.com/iex/<ticker>

2.5.3 Historical Intraday Prices Endpoint

To request historical intraday prices for a stock, use the following REST endpoint.

https://api.tiingo.com/iex/<ticker>/prices?startDate=2019-01-02&resampleFreq=5min

2.6 Fundamental Data API

REST Endpoints

Endpoint	Description
`https://api.tiingo.com/tiingo/fundamentals/definitions`	Available fundamental metrics
`https://api.tiingo.com/tiingo/fundamentals/<ticker>/statements`	Historical statement data (active symbols)
`https://api.tiingo.com/tiingo/fundamentals/<permaTicker>/statements`	Historical statement data (delisted/recycled symbols)
`https://api.tiingo.com/tiingo/fundamentals/<ticker>/daily`	Historical daily fundamental data (active symbols)
`https://api.tiingo.com/tiingo/fundamentals/<permaTicker>/daily`	Historical daily fundamental data (delisted/recycled symbols)
`https://api.tiingo.com/tiingo/fundamentals/meta`	Fundamental meta data

2.6.1 Overview

Tiingo offers a fundamental data API via a third-party provider. Data goes back over 20 years and covers US Equities and ADRs. We have used this provider extensively over the years and found them to be reputable, reliable, and accurate.

Benefits of Tiingo Fundamental Data API

5,500+ Equities Covered.
Data includes Cash Flow, Income Statement, Balance Sheet, and Metric Data.
Data is covered daily, quarterly, and for annual statements.
Data is structured and normalized across a pre-defined set of tickers for easy backtests and analysis.
Data is served via a REST API.
Data is updated usually within 12-24 hours of being made available by the SEC.
3 Years of the DOW 30 tickers are available for free/evaluation.

2.6.2 Definitions Data

This endpoint can be used to check which the various fields available in the fundamentals endpoint. As we add more indicators, the output of this endpoint will change to reflect the addition of indicators.

https://api.tiingo.com/tiingo/fundamentals/definitions

2.6.3 Statement Data Endpoint

This endpoint returns data that is extracted from quarterly and annual statements.

For Tiingo statement data, use the endpoints below. Provide either a ticker (active symbols) or a Tiingo permaTicker (stable identifier for delisted/recycled symbols).

Note: With this endpoint, the JSON (default) and CSV formats do share some differences in data structure. The JSON data is nested, whereas the CSV format, by necessity, is a 2-D, flat structure. The data is the same, so choose a format that is simplest for you to digest.

Additionally, please ensure your code can handle new indicators as we will be continually updating these endpoints as we obtain new information and add new metrics.

To request historical statement data (active symbols)

https://api.tiingo.com/tiingo/fundamentals/<ticker>/statements

For delisted or recycled symbols

https://api.tiingo.com/tiingo/fundamentals/<permaTicker>/statements

To request historical statement data limited by date range

https://api.tiingo.com/tiingo/fundamentals/<ticker>/statements?startDate=2019-06-30

2.6.4 Daily Data

While statement data covers quarterly and annual reporting, some metrics that rely on price update daily, for example Market Capitalization, P/E Ratios, P/B Ratios, etc. This endpoint covers daily metrics.

For Tiingo daily fundamentals, use the endpoints below. Provide either a ticker (active symbols) or a Tiingo permaTicker (stable identifier for delisted/recycled symbols).

Note: This endpoint is different than others in that the different daily metrics are "columns". Please note that we will continue to add new daily metrics, so the fields will change throughout time. We recommend you do not make parsing code that requires columns or fields to be in a particular order. If you do require this, please use the columns request parameter to ensure constant output, even if we add columns.

For example, columns=marketCap,peRatio will always ensure only those two fields are returned in that exact order.

To request daily metric data (active symbols)

https://api.tiingo.com/tiingo/fundamentals/<ticker>/daily

For delisted or recycled symbols

https://api.tiingo.com/tiingo/fundamentals/<permaTicker>/daily

2.6.5 Meta Data

This endpoint can be used to check which tickers have been updated with new fundamental data.

Like the endpoints above, as we add new meta data about companies and their fundamentals, this endpoint will change output. Please do not code with the assumption that column orders will always be maintained. If you must, please pass the columns parameter to ensure the output maintains its column order. For example, columns=ticker,name will always ensure those columns are returned in that exact order.

https://api.tiingo.com/tiingo/fundamentals/meta

3. WebSocket Endpoints

Postman Connection

Service	URL
Crypto	`wss://api.tiingo.com/crypto`
Forex	`wss://api.tiingo.com/fx`
IEX	`wss://api.tiingo.com/iex`

3.1 Crypto WebSocket

thresholdLevel: 2 — Top-of-Book AND Last Trade:

{
    "eventName": "subscribe",
    "authorization": "YOUR_TOKEN_HERE",
    "eventData": {
        "tickers": ["btcusd", "ethusd"],
        "thresholdLevel": 2
    }
}

thresholdLevel: 5 — Last Trade only (less data, easier to start with):

{
    "eventName": "subscribe",
    "authorization": "YOUR_TOKEN_HERE",
    "eventData": {
        "tickers": ["btcusd", "ethusd"],
        "thresholdLevel": 5
    }
}

Response Messages You'll Receive

Trade update ("T"):

{
    "service": "crypto_data",
    "messageType": "A",
    "data": ["T", "btcusd", "2024-01-01T12:00:00+00:00", "BINANCE", 0.001, 42000.50]
}

Index	Field	Example
0	Type	"T"
1	Ticker	"btcusd"
2	Date	"2024-01-01T..."
3	Exchange	"BINANCE"
4	Last Size	0.001
5	Last Price	42000.50

Quote / Top-of-Book update ("Q") — (only with thresholdLevel: 2)

{
    "service": "crypto_data",
    "messageType": "A",
    "data": ["Q", "btcusd", "2024-01-01T12:00:00+00:00", "BINANCE", 0.5, 41999.00, 42000.00, 0.3, 42001.00]
}

Index	Field	Example
0	Type	"Q"
1	Ticker	"btcusd"
2	Date	"2024-01-01T..."
3	Exchange	"BINANCE"
4	Bid Size	0.5
5	Bid Price	41999.00
6	Mid Price	42000.00
7	Ask Size	0.3
8	Ask Price	42001.00

Recommendation for learning: Start with thresholdLevel: 5 (trades only) — the firehose at level 2 sends an extremely high volume of quote updates and can be overwhelming. Once you're comfortable parsing trade messages, drop it to 2 to also receive top-of-book updates.

3.2 Forex WebSocket Endpoint

Postman Connection

wss://api.tiingo.com/fx

{
    "eventName": "subscribe",
    "authorization": "YOUR_TOKEN_HERE",
    "eventData": {
        "tickers": ["eurusd", "gbpusd"],
        "thresholdLevel": 5
    }
}

Note: For FX, thresholdLevel: 5 is the only level — it gives you all top-of-book updates. Unlike crypto there's no trade-only mode.

Response Message

All FX messages are Quote ("Q") only — no trade messages like crypto:

{
    "service": "fx",
    "messageType": "A",
    "data": ["Q", "eurusd", "2024-01-01T12:00:00+00:00", 100000, 1.0850, 1.0851, 1.0852, 100000]
}

Index	Field	Example
0	Type	"Q"
1	Ticker	"eurusd"
2	Date	"2024-01-01T..."
3	Bid Size	100000
4	Bid Price	1.0850
5	Mid Price	1.0851
6	Ask Price	1.0852
7	Ask Size	100000

Crypto vs Forex WebSocket — Key Differences

Feature	Crypto `wss://.../crypto`	Forex `wss://.../fx`
Message types	"T" (trade) + "Q" (quote)	"Q" only
thresholdLevel	2 = both, 5 = trades only	5 = all updates
Exchange field	✅ included (index 3)	❌ not present
Resolution	nanosecond	microsecond
Data source	Crypto exchanges	Tier-1 banks + FX dark pools

"tickers": ["eurusd", "gbpusd", "usdjpy", "audusd", "usdchf", "usdcad"]

⚠️ FX firehose is very high volume (microsecond resolution). For learning, subscribe to just 1-2 pairs to start.

3.3 IEX WebSocket Endpoint

Postman Connection

wss://api.tiingo.com/iex

3 Modes — Pick One Based on Your Situation

Mode 1: Reference Price — No IEX Agreement Needed ✅ (Best for Learning)

{
    "eventName": "subscribe",
    "authorization": "YOUR_TOKEN_HERE",
    "eventData": {
        "tickers": ["aapl", "tsla", "msft"],
        "thresholdLevel": 6
    }
}

Response — Simple, just 3 fields:

{
    "service": "iex",
    "messageType": "A",
    "data": ["2024-01-01T14:00:00+00:00", "aapl", 192.50]
}

Index	Field	Example
0	Date	"2024-01-01T..."
1	Ticker	"aapl"
2	Reference Price	192.50

Mode 2: Major Trades + Quote Updates (Requires IEX Agreement)

{
    "eventName": "subscribe",
    "authorization": "YOUR_TOKEN_HERE",
    "eventData": {
        "tickers": ["aapl", "tsla"],
        "thresholdLevel": 5
    }
}

Mode 3: Full Firehose — ALL Updates (Requires IEX Agreement)

{
    "eventName": "subscribe",
    "authorization": "YOUR_TOKEN_HERE",
    "eventData": {
        "tickers": ["aapl"],
        "thresholdLevel": 0
    }
}

Response for Mode 2 & 3

Trade message ("T"):

{
    "service": "iex",
    "messageType": "A",
    "data": ["T", "2024-01-01T14:00:00+00:00", 1704110400000000000, "aapl",
             null, null, null, null, null, 192.50, 100, 0, 0, 0, 0, 0]
}

Quote message ("Q"):

{
    "service": "iex",
    "messageType": "A",
    "data": ["Q", "2024-01-01T14:00:00+00:00", 1704110400000000000, "aapl",
             500, 192.45, 192.50, 192.55, 300, null, null, 0, 0, 0, null, null]
}

Full Field Map:

Index	Field	Trade	Quote
0	Type	"T" / "B"	"Q"
1	Date	✅	✅
2	Nanoseconds	✅	✅
3	Ticker	✅	✅
4	Bid Size	null	✅
5	Bid Price	null	✅
6	Mid Price	null	✅
7	Ask Price	null

All 3 WebSockets Compared

Feature	IEX `wss://.../iex`	Crypto `wss://.../crypto`	Forex `wss://.../fx`
Asset type	US stocks	Crypto pairs	FX pairs
Message types	T, Q, B (break)	T, Q	Q only
Free level	6 (reference price)	5 (trades only)	5 (all quotes)
Nanosecond field	✅ index 2	❌	❌
Exchange field	❌ (IEX only)	✅ index 3	❌
IEX agreement needed	for level 0 & 5	❌	❌

For learning: Stick to thresholdLevel: 6 on IEX — no agreement needed, clean simple response, and Tiingo says it covers 95% of use cases.

4.1 Utilities - Search

Overview

Tiingo's search feature lets you find specific assets in our database by the ticker or the name of the asset. This endpoint lets you segment by active, delisted, tickers across asset classes. The endpoint first searches for ticker matches and then expands to matches in the name of the asset.

Note: Search Endpoint has just been launched and is in early beta. Responses objects are subject to change. We do not recommend building production code using this endpoint while in beta.

Search Endpoint

To request search query data, use the following REST endpoints.

https://api.tiingo.com/tiingo/utilities/search/<query>

https://api.tiingo.com/tiingo/utilities/search?query=<query>

Example

https://api.tiingo.com/tiingo/utilities/search?query=microsoft&token=<token>

Response Field Reference

Field Name	JSON Field	Data Type	Description
Ticker	ticker	string	Ticker of the given asset.
Name	name	string	The name of the asset.
Asset Type	assetType	string	The asset type of the asset (Stock, ETF, & Mutual Fund).
Is Active	isActive	boolean	True if the ticker is still actively quoted, and false if the ticker is no longer actively quoted (delisted).
Tiingo PermaTicker	permaTicker	string	Placeholder for an upcoming change to the Tiingo API that allows querying by permaticker.
OpenFIGI Ticker	openFIGI	string	Placeholder for an upcoming change to the Tiingo API that allows querying by the openFIGI ticker.

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

Comments (0)

Tiingo API Documentation

Table of Contents

2.1 End of Day (Stock) API

REST Endpoints

2.1.2 End-of-Day Endpoint

Latest Price Information

Historical Price Information

2.1.3 Meta Endpoint

2.2: Crypto

REST Endpoints

2.3 REST - CRYPTO

2.3.1 Overview

Benefits of Tiingo Crypto

2.3.2 Real-time & Historical Prices Endpoint

Intraday data for current day or last business day

Historical intraday data

2.3.3 Meta Endpoint

To request meta data for all tickers

To request meta data for specific tickers

2.3.4 Top-of-Book Endpoint

2.4 REST - FOREX

REST Endpoints

2.4.1 Overview of the Tiingo Forex API

Benefits of the Tiingo Forex API

2.4.2 Current Top-of-Book

To request top-of-book/last for multiple base and quote pairs

To request top-of-book/last for specific tickers

2.4.3 Intraday Prices Endpoint

Current OHLC for the day

Historical Intraday Prices

2.5 REST - IEX

REST Endpoints

2.5.2 Current Top-of-Book & Last Price

To request top-of-book/last for all tickers

To request top-of-book/last for specific tickers

2.5.3 Historical Intraday Prices Endpoint

2.6 Fundamental Data API

REST Endpoints

2.6.1 Overview

Benefits of Tiingo Fundamental Data API

2.6.2 Definitions Data

2.6.3 Statement Data Endpoint

To request historical statement data (active symbols)

For delisted or recycled symbols

To request historical statement data limited by date range

2.6.4 Daily Data

To request daily metric data (active symbols)

For delisted or recycled symbols

2.6.5 Meta Data

3. WebSocket Endpoints

Postman Connection

3.1 Crypto WebSocket

Subscribe Message

Response Messages You'll Receive

Trade update ("T"):

Quote / Top-of-Book update ("Q") — (only with thresholdLevel: 2)

3.2 Forex WebSocket Endpoint

Postman Connection

Subscribe Message

Response Message

Crypto vs Forex WebSocket — Key Differences

Common FX Tickers to Subscribe To

3.3 IEX WebSocket Endpoint

Postman Connection

3 Modes — Pick One Based on Your Situation

Mode 1: Reference Price — No IEX Agreement Needed ✅ (Best for Learning)

Mode 2: Major Trades + Quote Updates (Requires IEX Agreement)

Mode 3: Full Firehose — ALL Updates (Requires IEX Agreement)

Response for Mode 2 & 3

Trade message ("T"):

Quote message ("Q"):

Full Field Map:

All 3 WebSockets Compared

4.1 Utilities - Search

Overview

Search Endpoint

Example

Response Field Reference