A wider view.
A sharper query.

Download a complete news bulk archive (GET /tiingo/news/bulk_download/{id}) into a
protected artifact and return its handle, size, container kind, member manifest,
expiry and an optional preview. Never inlines binary data or key-bearing URLs.

Historical BOATS overnight bars (GET /boats/{ticker}/prices) — BETA.

Rows: date, open, high, low, close, and volume only when 'volume' is listed in
columns. Entitlement: BOATS Real-time entitlement (beta). chunk_days splits long ranges into explicit
windows under max_upstream_calls and the server deadline.

BOATS (Blue Ocean ATS) overnight snapshots (GET /boats[/{ticker}]) — BETA.

Requires the separate BOATS Real-time entitlement. Overnight session 20:00-03:59 ET; tngoLast, open/high/low and mid are calculated by Tiingo, bid/ask/last/lastSize/volume are venue-native.
Pass exactly one of ticker, tickers, or all_tickers=True.

Crypto pair metadata (GET /tiingo/crypto): ticker, baseCurrency, quoteCurrency,
exchangeData. Entitlement: Crypto. Pass explicit tickers (max 100) or
all_tickers=True for the documented full universe.

Crypto price history and latest prices (GET /tiingo/crypto/prices). Entitlement: Crypto.

Returns one object per pair with a nested priceData array (date, open, high,
low, close, volume, volumeNotional, tradesDone). With no dates the latest
aggregated observation is returned. Chunked history merges priceData per pair.

LEGACY crypto top-of-book (GET /tiingo/crypto/top) — deprecated by Tiingo.

Registered only when TIINGO_ENABLE_LEGACY_CRYPTO_TOP=true. Fields:
quoteTimestamp, lastSaleTimestamp, lastPrice, lastSize, bid/ask price,
size and exchange. Use tiingo_get_crypto_prices for supported last-price data.

UNVERIFIED PRODUCT STATUS: this page exists in Tiingo's documentation but is absent from the navigation; availability and entitlement are unconfirmed.

Historical aggregated yield metrics for one pool (GET /tiingo/crypto-yield/{poolCode}/metrics).

UNVERIFIED PRODUCT STATUS: this page exists in Tiingo's documentation but is absent from the navigation; availability and entitlement are unconfirmed.

Crypto yield lending platforms (GET /tiingo/crypto-yield/platforms): platform codes, names, networks. Field names are passed through unchanged.

UNVERIFIED PRODUCT STATUS: this page exists in Tiingo's documentation but is absent from the navigation; availability and entitlement are unconfirmed.

Crypto yield pools (GET /tiingo/crypto-yield/pools): pool codes with platform, network and denomination relationships. Field names are passed through unchanged.

UNVERIFIED PRODUCT STATUS: this page exists in Tiingo's documentation but is absent from the navigation; availability and entitlement are unconfirmed.

Latest crypto yield observations (GET /tiingo/crypto-yield/ticks): latest rates per pool; rates are provider fractions (0.04 = 4%), the stable borrow rate is labelled totalStableBorrowAmount as received. Field names are passed through unchanged.

Daily fundamental metrics (GET /tiingo/fundamentals/{identifier}/daily): date,
marketCap, enterpriseVal, peRatio, pbRatio, trailingPEG1Y (and any additional
metrics Tiingo returns). Nulls are preserved, never zero-filled.
Entitlement: Fundamentals add-on.

Trailing 1-year distribution yield (GET /tiingo/corporate-actions/{ticker}/distribution-yield):
rows of date and trailingDiv1Y. Entitlement: beta; included with the End-of-Day
entitlement since 2023-08-28. No date filters are documented for this route.

Distributions (dividends) across all tickers for one ex-date (GET /tiingo/corporate-actions/distributions).

Rows: permaTicker, ticker, exDate, paymentDate, recordDate, declarationDate, distribution, distributionFrequency (dates may be null; exDate and distribution never are).
Entitlement: Beta-enabled and enterprise customers. Beta early-release product.

Get end-of-day instrument metadata for one ticker (GET /tiingo/daily/{ticker}).

Symbology: Tiingo writes share classes with a dash (BRK-A, not BRK.A).
Entitlement: End-of-Day (all plans).

Args:
    ticker (str): Stock/ETF/mutual fund ticker, e.g. 'AAPL'.

Returns:
    ticker, name, exchangeCode, description, startDate, endDate (bounds
    of the available price history; null when no price data exists).

End-of-day prices for one ticker (GET /tiingo/daily/{ticker}/prices).

With no dates Tiingo returns the latest bar; with startDate/endDate it
returns history. Rows carry raw (open/high/low/close/volume) and adjusted
(adjOpen…adjVolume) fields plus divCash and splitFactor, all preserved
unchanged. resample_freq accepts daily, weekly, monthly, annually (only
daily honours market holidays). chunk_days splits a long range into
explicit date windows fetched sequentially under max_upstream_calls and
the server deadline; an incomplete result reports next_start.
Entitlement: End-of-Day; history depth depends on the plan.

Historical consolidated intraday bars (GET /tiingo/equity/intraday/{ticker}/prices) — BETA.

Rows: date, open, high, low, close, and volume only when 'volume' is listed in
columns. Entitlement: Equity Realtime (beta), market hours 04:00-20:00 ET. chunk_days splits long ranges into explicit
windows under max_upstream_calls and the server deadline.

Equity Realtime consolidated snapshots (GET /tiingo/equity/intraday[/{ticker}]) — BETA.

Returns derived reference prices and liquidity estimates (tngoLast, lqRefPrice, lqSpread, lqBid*/lqAsk*), not an executable NBBO. Market hours 04:00-20:00 ET. Tiingo recommends IEX endpoints for production.
Pass exactly one of ticker, tickers, or all_tickers=True.

Financial statements (GET /tiingo/fundamentals/{identifier}/statements).

Each row: date (release date), quarter (0 = annual, 1-4 = fiscal quarters), year,
statementData with balanceSheet / incomeStatement / cashFlow / overview arrays of
{dataCode, value}. Nulls and unknown dataCodes are preserved. as_reported=true
returns values as first published, never restated; do not describe the two
dimensions interchangeably. Entitlement: Fundamentals add-on.

Historical and current fund fee data (GET /tiingo/funds/{ticker}/metrics):
prospectusDate, netExpense, grossExpense, managementFee, 12b1, non12b1,
otherExpenses, loads, account/redemption fees, portfolioTurnover, miscFees and
customFees objects (label, value, units, parentFee) preserved as provided.
Entitlement: enterprise/institutional.

Mutual fund / ETF overview (GET /tiingo/funds/{ticker}): ticker, name, description,
shareClass, netExpense and otherShareClasses (related classes with their fees).
Entitlement: enterprise/institutional. A 'tickers' query mentioned in Tiingo's
request table is unresolved and not exposed (D10).

Catalogue of fundamental metric definitions (GET /tiingo/fundamentals/definitions).

Rows: dataCode, name, description, statementType (balanceSheet, incomeStatement,
cashFlow, overview), units. The list is open-ended; never assume a fixed set of
codes. Entitlement: Fundamentals add-on (DOW 30 free for evaluation).

Company metadata for fundamentals coverage (GET /tiingo/fundamentals/meta).

Fields include permaTicker (stable identifier for recycled/delisted symbols),
ticker, name, isActive, isADR, sector/industry/SIC codes, reportingCurrency,
location, websites and statementLastUpdated/dailyLastUpdated.

Historical intraday FX bars (GET /tiingo/fx/{ticker}/prices): date, ticker,
open, high, low, close (quote-derived; no volume). Entitlement: Forex.

Forex top-of-book quotes (page: beta; changelog: out of beta). Entitlement: Forex.

Pairs are concatenated without a slash (EUR/USD -> eurusd). Fields: ticker,
quoteTimestamp, bidPrice, bidSize, askPrice, askSize, midPrice. FX quotes are
indicative and carry no trade volume. Pass exactly one selector.

Historical intraday IEX bars (GET /iex/{ticker}/prices).

Rows: date, open, high, low, close, and volume only when 'volume' is listed in
columns. Entitlement: IEX intraday history. chunk_days splits long ranges into explicit
windows under max_upstream_calls and the server deadline.

IEX top-of-book / last (GET /iex and /iex/{ticker}).

Fields tngoLast, mid, open/high/low, volume and prevClose are calculated by Tiingo; last, lastSize, bid*/ask*, quoteTimestamp and lastSaleTimestamp come from the raw IEX TOPS feed and are null without an IEX market-data agreement (required since 2025-02-01). tngoLast is never a substitute for last.
Pass exactly one of ticker, tickers, or all_tickers=True.

Financial news articles (GET /tiingo/news). Entitlement: News add-on.

Pagination is performed by Tiingo (limit/offset); Tiingo reports no total,
so none is invented — use next_offset to continue. Articles: id, title,
url, description, publishedDate, crawlDate, source, tickers, tags.
'tags' is a returned field; Tiingo's request table does not document it
as a filter, so it is not an argument here.

UNVERIFIED PRODUCT STATUS: this page exists in Tiingo's documentation but is absent from the navigation; availability and entitlement are unconfirmed.

Small Exchange official end-of-day (GET /smallx/{ticker}/eod): date, open, high, low, close, volume, settlementPrice, openInterest (official settlement values; daily/weekly/monthly/annually resampling). Derived intraday bars and official settlement values are
never merged.

UNVERIFIED PRODUCT STATUS: this page exists in Tiingo's documentation but is absent from the navigation; availability and entitlement are unconfirmed.

Small Exchange contract metadata (GET /smallx/meta): permaTicker, ticker, name,
baseTicker, baseCurrency, cfiCode, first/last trading dates, expiration and
maturity dates, tickSize and tickMulitplier (Tiingo's spelling, preserved).
Market hours 8pm EST Sunday through 5pm EST Friday.

UNVERIFIED PRODUCT STATUS: this page exists in Tiingo's documentation but is absent from the navigation; availability and entitlement are unconfirmed.

Small Exchange derived intraday bars (GET /smallx/{ticker}/prices): date, open, high, low, close, volume (derived intraday bars; min/hour resampling). Derived intraday bars and official settlement values are
never merged.

UNVERIFIED PRODUCT STATUS: this page exists in Tiingo's documentation but is absent from the navigation; availability and entitlement are unconfirmed.

Small Exchange top-of-book / last (GET /smallx/tops and /smallx/{ticker}/tops):
ticker, timestamp, quoteTimestamp, lastSaleTimestamp, last, lastSize, tngoLast,
prevClose, open, high, low, mid, volume, bid/ask size and price, openInterest.

Splits across all tickers for one ex-date (GET /tiingo/corporate-actions/splits).

Rows: permaTicker, ticker, exDate, splitFrom, splitTo, splitFactor (splitTo/splitFrom), splitStatus ('a' active, 'c' cancelled — cancelled rows are preserved).
Entitlement: Beta; included with the End-of-Day entitlement. Beta early-release product.

Distribution history for one ticker (GET /tiingo/corporate-actions/{ticker}/distributions).

Rows: permaTicker, ticker, exDate, paymentDate, recordDate, declarationDate, distribution, distributionFrequency (dates may be null; exDate and distribution never are). Includes historical and upcoming events.
Entitlement: Beta; included with the End-of-Day entitlement (stocks, ETFs, mutual funds).

Split history for one ticker (GET /tiingo/corporate-actions/{ticker}/splits).

Rows: permaTicker, ticker, exDate, splitFrom, splitTo, splitFactor (splitTo/splitFrom), splitStatus ('a' active, 'c' cancelled — cancelled rows are preserved). Includes historical and upcoming events.
Entitlement: Beta; included with the End-of-Day entitlement.

List available news bulk-download archives (GET /tiingo/news/bulk_download).

Entitlement: institutional clients only. Metadata: id, filename, batchType,
startDate/endDate (Tiingo labels the end date 'startDate' in its docs — values are
passed through), fileSizeCompressed, fileSizeUncompressed. The convenience URL that
embeds your token is removed.

Tiingo's public supported-tickers catalog (supported_tickers.zip, updated daily).

No API token is used: the file is public. Columns: ticker, exchange, assetType,
priceCurrency, startDate, endDate (plus any additional columns Tiingo adds). The
catalog is cached in this process for TIINGO_ASSET_CACHE_TTL_SECONDS.

Collect a bounded sample from the BOATS overnight WebSocket feed (wss://api.tiingo.com/boats) - BETA.

thresholdLevel 3 is the only public channel and requires the BOATS Real-time entitlement; overnight session 20:00-03:59 ET; B rows are trade breaks and MEMOIR sale conditions are preserved.
The sample ends at duration_seconds, max_messages, the configured byte/frame
budgets, or a provider close/error, then unsubscribes and closes. A validated
acknowledgement is required before data is trusted. An empty sample outside
market hours is normal, not an authentication failure. Later errors keep the
data collected so far with partial=true.

Collect a bounded sample from the crypto WebSocket feed (wss://api.tiingo.com/crypto, service crypto_data).

thresholdLevel 2 delivers quotes and trades, 5 (default) trades only; pairs are written as {base}{quote} (btcusd) and each row carries its exchange.
The sample ends at duration_seconds, max_messages, the configured byte/frame
budgets, or a provider close/error, then unsubscribes and closes. A validated
acknowledgement is required before data is trusted. An empty sample outside
market hours is normal, not an authentication failure. Later errors keep the
data collected so far with partial=true.

Collect a bounded sample from the Equity Realtime WebSocket feed (wss://api.tiingo.com/equity/intraday, service cons) - BETA.

thresholdLevel 6 (default) publishes reference-price rows [date, ticker, referencePrice]; level 4 publishes liquidity metrics [date, ticker, lqSpread (0.04 = 4%), lqBidSize, lqBidPrice, referencePrice, lqAskPrice, lqAskSize]. The URL has no /tiingo prefix.
The sample ends at duration_seconds, max_messages, the configured byte/frame
budgets, or a provider close/error, then unsubscribes and closes. A validated
acknowledgement is required before data is trusted. An empty sample outside
market hours is normal, not an authentication failure. Later errors keep the
data collected so far with partial=true.

Collect a bounded sample from the FX WebSocket feed (wss://api.tiingo.com/fx).

thresholdLevel 5 delivers quote (Q) rows for pairs such as eurusd; FX quotes carry no trade volume.
The sample ends at duration_seconds, max_messages, the configured byte/frame
budgets, or a provider close/error, then unsubscribes and closes. A validated
acknowledgement is required before data is trusted. An empty sample outside
market hours is normal, not an authentication failure. Later errors keep the
data collected so far with partial=true.

Collect a bounded sample from the IEX WebSocket feed (wss://api.tiingo.com/iex).

thresholdLevel 0 (all TOPS quotes and trades) and 5 (trades plus selected quote updates) return raw 16-field TOPS rows and require an IEX market-data agreement; level 6 (default) returns Tiingo's derived reference price as 3-element rows [date, ticker, referencePrice].
The sample ends at duration_seconds, max_messages, the configured byte/frame
budgets, or a provider close/error, then unsubscribes and closes. A validated
acknowledgement is required before data is trusted. An empty sample outside
market hours is normal, not an authentication failure. Later errors keep the
data collected so far with partial=true.

Search Tiingo's asset database by ticker or name (beta).

Ticker matches come first, then name matches. Returns ticker, name,
assetType (Stock, ETF, Mutual Fund), isActive, permaTicker, openFIGI
(the last two are placeholders per Tiingo). Additive fields are kept.
Tiingo does not recommend production dependence on this beta endpoint.

Verify that the current Tiingo API token is accepted (GET /api/test/).

Works for every Tiingo account regardless of product entitlements.
Tiingo can answer HTTP 200 even for a bad token; this tool inspects the
message body and fails with an 'auth' error when the token is rejected.

Returns:
    {"message": "You successfully sent a request"} on success.

Verify WebSocket connectivity and authentication against wss://api.tiingo.com/test.

Sends the documented test subscription (eventData.authToken + service "test") and
succeeds only on a validated acknowledgement (code 200). No market data is read;
the socket is closed right after the acknowledgement.