Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tiingo Fundamentals API

Income statement, balance sheet, cash flow, and corporate event data sourced from SEC filings.

Tiingo Fundamentals API is one of 6 APIs that Tiingo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Fundamentals, Financial Statements, and Equity Research. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 37 operations across 37 paths, organized into 13 resource areas, and defines 36 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://api.tiingo.com.

37 operations 37 paths 36 schemas 37 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.tiingo.com/tiingo/fundamentals
Authentication
API Key, API Key
Terms of Service
Resource Areas
13

Authentication & Security 2

Tiingo Fundamentals API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (apiTokenHeader). An API key is passed in the query as token (apiTokenQuery). By default, every request must be authenticated.

  • apiTokenHeader — Pass your API token in the Authorization header as: Authorization: Token .
  • apiTokenQuery — Pass your API token directly in the request URL via the token query parameter.

Paths & Operations 37

Across 37 paths, the API surfaces 37 operations — 37 GET. They span 13 resource areas, including End-of-Day, Corporate Actions, News, Crypto, Crypto Yield, IEX, BOATS, Equity Realtime, and 5 more. Each is listed below with its method, path, parameters, and response codes.

End-of-Day 2
GET
/tiingo/daily/{ticker}
Get end-of-day metadata for a ticker
getDailyMeta 1 param → 200401429
GET
/tiingo/daily/{ticker}/prices
Get end-of-day price history for a ticker
getDailyPrices 6 params → 200401429
Corporate Actions 5
GET
/tiingo/corporate-actions/{ticker}/distribution-yield
Get trailing distribution yield for a ticker
getDistributionYield 1 param → 200401429
GET
/tiingo/corporate-actions/{ticker}/distributions
Get dividend distributions for a ticker
getTickerDistributions 3 params → 200401429
GET
/tiingo/corporate-actions/distributions
Get dividend distributions across all tickers for an ex-date
getBulkDistributions 1 param → 200401429
GET
/tiingo/corporate-actions/{ticker}/splits
Get split corporate actions for a ticker
getTickerSplits 3 params → 200401429
GET
/tiingo/corporate-actions/splits
Get split corporate actions across all tickers for an ex-date
getBulkSplits 1 param → 200401429
News 3
GET
/tiingo/news
Get curated financial news articles
listNews 7 params → 200401429
GET
/tiingo/news/bulk_download
List available bulk news download files
listNewsBulkFiles → 200401429
GET
/tiingo/news/bulk_download/{id}
Download a bulk news batch file
downloadNewsBulkFile 1 param → 200401429
Crypto 3
GET
/tiingo/crypto
Get metadata for crypto tickers
listCryptoMeta 1 param → 200401429
GET
/tiingo/crypto/top
Get top-of-book quotes for crypto tickers
getCryptoTopOfBook 3 params → 200401429
GET
/tiingo/crypto/prices
Get historical crypto price data
getCryptoPrices 5 params → 200401429
Crypto Yield 4
GET
/tiingo/crypto-yield/platforms
List crypto yield platforms
listCryptoYieldPlatforms 1 param → 200401429
GET
/tiingo/crypto-yield/pools
List crypto yield pools
listCryptoYieldPools 2 params → 200401429
GET
/tiingo/crypto-yield/ticks
Get latest crypto yield metric ticks
getCryptoYieldTicks 2 params → 200401429
GET
/tiingo/crypto-yield/{poolCode}/metrics
Get historical yield metrics for a pool
getCryptoYieldMetrics 4 params → 200401429
IEX 2
GET
/iex
Get IEX top-of-book and last-sale quotes
getIexTopOfBook 1 param → 200401429
GET
/iex/{ticker}/prices
Get IEX historical intraday prices for a ticker
getIexHistoricalPrices 6 params → 200401429
BOATS 2
GET
/boats
Get BOATS overnight top-of-book and last-sale quotes (beta)
getBoatsTopOfBook 1 param → 200401429
GET
/boats/{ticker}/prices
Get BOATS overnight historical intraday prices for a ticker (beta)
getBoatsHistoricalPrices 6 params → 200401429
Equity Realtime 2
GET
/tiingo/equity/intraday
Get consolidated equity realtime top-of-book snapshot (beta)
getEquityRealtimeTopOfBook 1 param → 200401429
GET
/tiingo/equity/intraday/{ticker}/prices
Get consolidated equity realtime historical intraday prices (beta)
getEquityRealtimeHistoricalPrices 6 params → 200401429
Small Exchange 4
GET
/smallx/meta
Get Small Exchange contract metadata
getSmallXMeta 1 param → 200401429
GET
/smallx/tops
Get Small Exchange top-of-book quotes
getSmallXTopOfBook 1 param → 200401429
GET
/smallx/{ticker}/prices
Get Small Exchange intraday price history
getSmallXIntradayPrices 4 params → 200401429
GET
/smallx/{ticker}/eod
Get Small Exchange end-of-day price history
getSmallXEodPrices 4 params → 200401429
Forex 2
GET
/tiingo/fx/top
Get forex top-of-book quotes
getForexTopOfBook 1 param → 200401429
GET
/tiingo/fx/{ticker}/prices
Get historical forex rates for a currency pair
getForexPrices 4 params → 200401429
Fundamentals 4
GET
/tiingo/fundamentals/definitions
Get definitions of available fundamentals fields
getFundamentalsDefinitions → 200401429
GET
/tiingo/fundamentals/meta
Get fundamentals metadata for tickers
getFundamentalsMeta 1 param → 200401429
GET
/tiingo/fundamentals/{ticker}/statements
Get financial statement history for a ticker
getFundamentalsStatements 5 params → 200401429
GET
/tiingo/fundamentals/{ticker}/daily
Get daily fundamentals metrics for a ticker
getFundamentalsDaily 4 params → 200401429
Fund Fees 2
GET
/tiingo/funds/{ticker}
Get latest mutual fund / ETF fee data for a fund
getFundFees 2 params → 200401429
GET
/tiingo/funds/{ticker}/metrics
Get historical fee metrics for a fund
getFundFeeMetrics 4 params → 200401429
Utilities 2
GET
/tiingo/utilities/search
Search for assets by ticker or name
searchAssets 4 params → 200401429
GET
/api/test
Test API connectivity and authentication
testConnection → 200401429

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are YieldMetrics (34 properties), FundFeeMetrics (22 properties), SmallXTopOfBook (18 properties), BoatsTopOfBook (17 properties). Each schema is shown below with its type and property counts.

CryptoTopOfBookData
object
12 properties
CryptoPriceBar
object
8 properties
FundamentalsStatementData
object
2 properties
DailyMeta
object
6 properties
DailyPriceBar
object
13 properties
DistributionYield
object
2 properties
Distribution
object
8 properties
Split
object
7 properties
NewsArticle
object
9 properties
NewsBulkFile
object
7 properties
CryptoMeta
object
5 properties
CryptoTopOfBook
object
5 properties
CryptoPrices
object
5 properties
YieldPlatform
object
3 properties
YieldPool
object
7 properties
YieldTick
object
9 properties
YieldMetrics
object
34 properties
IexTopOfBook
object
17 properties
IexPriceBar
object
6 properties
BoatsTopOfBook
object
17 properties
BoatsPriceBar
object
6 properties
EquityRealtimeTopOfBook
object
14 properties
EquityRealtimePriceBar
object
6 properties
SmallXMeta
object
12 properties
SmallXTopOfBook
object
18 properties
SmallXPriceBar
object
6 properties
SmallXEodBar
object
8 properties
ForexTopOfBook
object
7 properties
ForexPriceBar
object
6 properties
FundamentalsDefinition
object
5 properties
FundamentalsMeta
object
16 properties
FundamentalsStatement
object
4 properties
FundamentalsDaily
object
6 properties
FundFees
object
6 properties
FundFeeMetrics
object
22 properties
SearchResult
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tiingo-openapi.yml Raw ↑

Other APIs Tiingo publishes across the network.

Tiingo End-of-Day API
Tiingo IEX Intraday API
Tiingo Crypto API
Tiingo Forex API
Tiingo News API