---
canonical_url: "https://docs.composio.dev/toolkits/tiingo"
markdown_url: "https://docs.composio.dev/toolkits/tiingo.md"
product: "platform"
version: null
last_updated: null
---

# Tiingo

Tiingo provides financial market data APIs for equities, news, crypto, forex, fundamentals, corporate actions, and related datasets.

- **Category:** market data
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 36
- **Triggers:** 0
- **Slug:** `TIINGO`
- **Version:** 00000000_00

## Tools

### Get BOATS Prices

**Slug:** `TIINGO_GET_BOATS_PRICES`

Get historical BOATS overnight intraday JSON price bars for one equity ticker; requires the BOATS add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Equity ticker symbol. |
| `columns` | string | No | Comma-separated bar fields to return; omit for all fields. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `force_fill` | boolean | No | Fill missing intervals according to Tiingo's force-fill behavior when true. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `after_hours` | boolean | No | Compatibility flag; it does not widen the BOATS overnight session. |
| `resample_frequency` | string | No | Intraday bar interval, such as 5min or 30min. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get BOATS Top Of Book

**Slug:** `TIINGO_GET_BOATS_TOP_OF_BOOK`

Get BOATS overnight top-of-book and last-sale snapshots for selected or all available equities; requires the BOATS add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Equity ticker symbols to return; accepts an array or comma-separated string. Omit for the provider default set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bulk Distributions

**Slug:** `TIINGO_GET_BULK_DISTRIBUTIONS`

Get dividend and other distribution events across all covered tickers for an optional ex-date. This endpoint requires an eligible Tiingo plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ex_date` | string | No | Ex-date in YYYY-MM-DD format; omit for the provider default. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bulk Splits

**Slug:** `TIINGO_GET_BULK_SPLITS`

Get stock split events across all covered tickers for an optional ex-date. This endpoint requires a Tiingo plan with corporate-actions access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ex_date` | string | No | Ex-date in YYYY-MM-DD format; omit for the provider default. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Crypto Prices

**Slug:** `TIINGO_GET_CRYPTO_PRICES`

Get latest or historical JSON price bars for selected crypto pairs, or omit tickers to return the entire current market, with optional exchange and currency controls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Crypto pair tickers, such as BTCUSD; maximum 100 when supplied. Omit to return the entire current market. |
| `end_date` | string | No | Inclusive end timestamp in ISO 8601 format. |
| `exchanges` | array | No | Exchange codes used to filter or consolidate price data. |
| `start_date` | string | No | Inclusive start timestamp in ISO 8601 format. |
| `base_currency` | string | No | Base currency used to filter pairs. |
| `convert_currency` | string | No | Target currency code for converted values. |
| `resample_frequency` | string | No | Tiingo interval such as 15min, 1hour, or 1day. |
| `consolidate_base_currency` | boolean | No | Consolidate results by base currency when true. |
| `include_raw_exchange_data` | boolean | No | Include per-exchange raw observations when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Crypto Top Of Book

**Slug:** `TIINGO_GET_CRYPTO_TOP_OF_BOOK`

Deprecated: get current top-of-book and last-sale data for up to 100 crypto pairs. Use Get Crypto Prices for supported last-price data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | Yes | Crypto pair tickers; accepts an array or comma-separated string (maximum 100). |
| `exchanges` | array | No | Exchange codes used to filter quote data; accepts an array or comma-separated string. |
| `convert_currency` | string | No | Target currency code for converted values. |
| `include_raw_exchange_data` | boolean | No | Include the underlying per-exchange observations when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Crypto Yield Metrics

**Slug:** `TIINGO_GET_CRYPTO_YIELD_METRICS`

Get historical yield-rate, balance, and liquidity metric bars for one crypto-yield pool.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `pool_code` | string | Yes | Pool code returned by List Crypto Yield Pools. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `resample_frequency` | string | No | Tiingo interval used to aggregate historical metric bars. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Crypto Yield Ticks

**Slug:** `TIINGO_GET_CRYPTO_YIELD_TICKS`

Get the latest crypto-yield rates, balances, and liquidity metrics, optionally filtered by pools or platforms.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pool_codes` | array | No | Pool codes used to filter the latest metrics. |
| `platform_codes` | array | No | Platform codes used to filter the latest metrics. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Distribution Yield

**Slug:** `TIINGO_GET_DISTRIBUTION_YIELD`

Get the complete historical trailing one-year distribution-yield series for one ticker. Tiingo provides no date filter or pagination, so the response can be very large.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Equity ticker symbol. |
| `columns` | string | No | Comma-separated metric names to return, such as trailingDiv1Y. Do not include date; Tiingo returns dates automatically and rejects date in this parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Equity EOD Metadata

**Slug:** `TIINGO_GET_EQUITY_EOD_METADATA`

Get end-of-day coverage metadata and company description for one equity ticker.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Equity ticker symbol, for example AAPL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Equity EOD Prices

**Slug:** `TIINGO_GET_EQUITY_EOD_PRICES`

Get JSON end-of-day price and adjustment history for one equity ticker, optionally bounded and resampled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Column name to sort by. Prefix the column with '-' for descending order; otherwise results are ascending, for example date or -date. |
| `ticker` | string | Yes | Equity ticker symbol. |
| `columns` | string | No | Comma-separated price fields to return; omit for all fields. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `resample_frequency` | string ("daily" | "weekly" | "monthly" | "annually") | No | Time interval for returned bars. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Equity Realtime Prices

**Slug:** `TIINGO_GET_EQUITY_REALTIME_PRICES`

Get historical intraday bars for one equity ticker from Tiingo's 24x5 consolidated realtime feed, the current recommended feed for new integrations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Equity ticker symbol. |
| `columns` | string | No | Comma-separated bar fields to return; omit for all fields. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `force_fill` | boolean | No | Fill missing intervals according to Tiingo's force-fill behavior when true. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `after_hours` | boolean | No | Include extended-hours data when supported. |
| `resample_frequency` | string | No | Intraday bar interval, such as 5min or 30min. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Equity Realtime Top Of Book

**Slug:** `TIINGO_GET_EQUITY_REALTIME_TOP_OF_BOOK`

Get 24x5 consolidated realtime equity top-of-book, reference-price, and liquidity snapshots from Tiingo's current recommended feed for new integrations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Equity ticker symbols to return; accepts an array or comma-separated string. Omit for the provider default set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Forex Prices

**Slug:** `TIINGO_GET_FOREX_PRICES`

Get latest or historical beta JSON rate bars for one forex pair.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Forex pair ticker such as EURUSD. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `resample_frequency` | string | No | Rate-bar interval, such as 5min or 1hour. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Forex Top Of Book

**Slug:** `TIINGO_GET_FOREX_TOP_OF_BOOK`

Get beta top-of-book quotes for selected or all available forex pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Forex pair tickers such as EURUSD; accepts an array or comma-separated string. Omit for the provider default set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fundamentals Daily

**Slug:** `TIINGO_GET_FUNDAMENTALS_DAILY`

Get JSON daily valuation and fundamental metrics for one ticker or PermaTicker; full universe coverage requires the fundamentals add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Column name to sort by. Prefix the column name with '-' for descending order; without the prefix, results are sorted in ascending order. |
| `ticker` | string | Yes | Ticker or PermaTicker; prefer PermaTicker for delisted or recycled symbols. |
| `columns` | string | No | Comma-separated daily metric fields to return in the requested order; omit for all fields. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fundamentals Statements

**Slug:** `TIINGO_GET_FUNDAMENTALS_STATEMENTS`

Get JSON financial statement history for one ticker or PermaTicker, optionally in as-reported form. Full universe coverage requires the Tiingo fundamentals add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("date" | "-date") | No | Sort statements by date: 'date' for ascending order or '-date' for descending order. |
| `ticker` | string | Yes | Ticker or PermaTicker; prefer PermaTicker for delisted or recycled symbols. |
| `end_date` | string | No | Inclusive statement end date in YYYY-MM-DD format. |
| `start_date` | string | No | Inclusive statement start date in YYYY-MM-DD format. |
| `as_reported` | boolean | No | Return values in the issuer's originally reported presentation when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fund Fee Metrics

**Slug:** `TIINGO_GET_FUND_FEE_METRICS`

Get historical JSON mutual-fund or ETF fee and expense metrics. This endpoint requires enterprise or institutional access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Mutual fund or ETF ticker symbol. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `resample_frequency` | string | No | Time interval used to aggregate historical metrics. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fund Fees

**Slug:** `TIINGO_GET_FUND_FEES`

Get a mutual fund or ETF description, share class, net expense ratio, and related share classes. This endpoint requires enterprise or institutional access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Mutual fund or ETF ticker symbol. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IEX Prices

**Slug:** `TIINGO_GET_IEX_PRICES`

Get historical IEX intraday JSON price bars for one equity ticker.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Equity ticker symbol. |
| `columns` | string | No | Comma-separated bar fields to return; omit for all fields. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `force_fill` | boolean | No | Fill missing intervals according to Tiingo's force-fill behavior when true. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `after_hours` | boolean | No | Include extended-hours data when supported. |
| `resample_frequency` | string | No | Intraday bar interval, such as 5min or 30min. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IEX Top Of Book

**Slug:** `TIINGO_GET_IEX_TOP_OF_BOOK`

Get IEX top-of-book, last-sale, reference-price, and daily market fields for selected or all available equities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Equity ticker symbols to return; accepts an array or comma-separated string. Omit for the provider default set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get News Bulk File

**Slug:** `TIINGO_GET_NEWS_BULK_FILE`

Get metadata and the token-bearing download URL for one institutional bulk-news batch; handle the URL as a secret.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | integer | Yes | Bulk-news batch file ID returned by List News Bulk Files. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Small Exchange EOD Prices

**Slug:** `TIINGO_GET_SMALL_EXCHANGE_EOD_PRICES`

Get official end-of-day JSON price bars for one Small Exchange contract.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Small Exchange contract ticker returned by List Small Exchange Metadata. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `resample_frequency` | string ("daily" | "weekly" | "monthly" | "annually") | No | Time interval for returned bars. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Small Exchange Intraday Prices

**Slug:** `TIINGO_GET_SMALL_EXCHANGE_INTRADAY_PRICES`

Get historical intraday JSON price bars for one Small Exchange contract.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Small Exchange contract ticker returned by List Small Exchange Metadata. |
| `columns` | string | No | Comma-separated bar fields to return; omit for all fields. |
| `end_date` | string | No | Inclusive end date in YYYY-MM-DD format. |
| `start_date` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `resample_frequency` | string | No | Intraday bar interval, such as 5min or 30min. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Small Exchange Top Of Book

**Slug:** `TIINGO_GET_SMALL_EXCHANGE_TOP_OF_BOOK`

Get Small Exchange top-of-book and last-sale snapshots, optionally filtered by ticker.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Small Exchange contract tickers to return; accepts an array or comma-separated string. Omit for the provider default set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Ticker Distributions

**Slug:** `TIINGO_GET_TICKER_DISTRIBUTIONS`

Get dividend and other distribution events for one ticker, optionally bounded by ex-date. This endpoint requires an eligible Tiingo plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Equity ticker symbol. |
| `end_ex_date` | string | No | Inclusive latest ex-date in YYYY-MM-DD format. |
| `start_ex_date` | string | No | Inclusive earliest ex-date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Ticker Splits

**Slug:** `TIINGO_GET_TICKER_SPLITS`

Get stock split events for one ticker, optionally bounded by ex-date. This endpoint requires an eligible Tiingo plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Equity ticker symbol. |
| `end_ex_date` | string | No | Inclusive latest ex-date in YYYY-MM-DD format. |
| `start_ex_date` | string | No | Inclusive earliest ex-date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Crypto Metadata

**Slug:** `TIINGO_LIST_CRYPTO_METADATA`

Return JSON metadata for all or selected Tiingo crypto pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Crypto pair tickers to return, such as BTCUSD; maximum 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Crypto Yield Platforms

**Slug:** `TIINGO_LIST_CRYPTO_YIELD_PLATFORMS`

List crypto-yield platforms, optionally restricted to platform codes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `platform_codes` | array | No | Platform codes to return, such as SOLEND. Accepts an array or a comma-separated string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Crypto Yield Pools

**Slug:** `TIINGO_LIST_CRYPTO_YIELD_POOLS`

List crypto-yield pools, optionally filtered by pool or platform codes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pool_codes` | array | No | Pool codes to return. Accepts an array or a comma-separated string. |
| `platform_codes` | array | No | Platform codes used to filter pools. Accepts an array or a comma-separated string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fundamentals Definitions

**Slug:** `TIINGO_LIST_FUNDAMENTALS_DEFINITIONS`

List JSON definitions, units, and statement categories for Tiingo fundamentals data codes. Full universe coverage requires the fundamentals add-on; Dow 30 data is available for evaluation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Equity tickers used to restrict applicable fundamentals definitions; accepts an array or comma-separated string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fundamentals Metadata

**Slug:** `TIINGO_LIST_FUNDAMENTALS_METADATA`

List company, security, industry, reporting, and stable identifier metadata for fundamentals tickers. Full coverage requires the fundamentals add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `columns` | string | No | Comma-separated metadata fields to return in the requested order; omit for all fields. |
| `tickers` | array | No | Ticker symbols to return; accepts an array or comma-separated string. Omit to return the entitled universe. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List News

**Slug:** `TIINGO_LIST_NEWS`

Return one page of curated financial news filtered by assets, tags, sources, or dates, plus a continuation cursor for the next offset page. This endpoint requires Tiingo News API access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | News tags used to filter articles. |
| `limit` | integer | No | Maximum articles in this page (1-1000). |
| `sort_by` | string ("publishedDate" | "crawlDate") | No | Article timestamp used for sorting. |
| `sources` | array | No | Publisher or source names used to filter articles. |
| `tickers` | array | No | Ticker symbols used to filter articles. |
| `end_date` | string | No | Inclusive latest article date in YYYY-MM-DD format. |
| `start_date` | string | No | Inclusive earliest article date in YYYY-MM-DD format. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it unchanged; it restores the original filters and page size. |
| `only_with_tickers` | boolean | No | Return only articles associated with at least one ticker when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List News Bulk Files

**Slug:** `TIINGO_LIST_NEWS_BULK_FILES`

List institutional bulk-news batch files and their metadata. Returned download URLs are sensitive and may contain access tokens.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Small Exchange Metadata

**Slug:** `TIINGO_LIST_SMALL_EXCHANGE_METADATA`

List Small Exchange contract metadata, optionally filtered by ticker.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Small Exchange contract tickers to return; accepts an array or comma-separated string. Omit to return all available contracts. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Assets

**Slug:** `TIINGO_SEARCH_ASSETS`

Search Tiingo assets by ticker or name and return identifiers and listing status. This endpoint is early beta; response objects may change, and Tiingo does not recommend it for production code while in beta.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum matching assets to return (1-100). |
| `query` | string | Yes | Ticker symbol or asset name to search for. |
| `include_delisted` | boolean | No | Include delisted or inactive assets when true. |
| `exact_ticker_match` | boolean | No | Return only exact ticker matches when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
