# Polygon

Polygon.io provides real-time and historical market data APIs for stocks, options, forex, and cryptocurrencies.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 91
- **Triggers:** 0
- **Slug:** `POLYGON`
- **Version:** 20260316_00

## Tools

### Get 10-K Filing Sections

**Slug:** `POLYGON_GET10_K_SECTIONS`

Tool to retrieve 10-K filing sections from the SEC. Use when you need to access specific sections of 10-K filings such as business descriptions, risk factors, or financial statements.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cik` | string | No | Central Index Key (CIK) number. Supports comparison operators: .any_of, .gt, .gte, .lt, .lte |
| `sort` | string | No | Comma-separated columns with .asc or .desc direction |
| `limit` | integer | No | Maximum number of results. Default: 100, Max: 9999 |
| `ticker` | string | No | Stock ticker symbol. Supports comparison operators: .any_of, .gt, .gte, .lt, .lte |
| `section` | string | No | Standardized section identifier from the filing (e.g., 'business', 'risk_factors') |
| `period_end` | string | No | Period end date filter in YYYY-MM-DD format. Supports comparison operators: .gte, .gt, .lte, .lt |
| `filing_date` | string | No | Filing date filter in YYYY-MM-DD format. Supports comparison operators: .gte, .gt, .lte, .lt |

#### 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 Aggregates

**Slug:** `POLYGON_GET_AGGREGATES`

Tool to fetch custom aggregate OHLCV bars for a stock. Use when you need historical price and volume data aggregated by custom intervals over a date range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | Yes | End of window; YYYY-MM-DD or millisecond timestamp |
| `sort` | string ("asc" | "desc") | No | Sort by timestamp; 'asc' oldest-first, 'desc' newest-first |
| `from_` | string | Yes | Start of window; YYYY-MM-DD or millisecond timestamp |
| `limit` | integer | No | Number of aggregates to return; default 5000, max 50000 |
| `ticker` | string | Yes | Case-sensitive stock ticker (e.g., 'AAPL') |
| `adjusted` | boolean | No | Adjust for splits; default true |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | Size of the time window |
| `multiplier` | integer | Yes | Size of the timespan multiplier |

#### 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 All Tickers

**Slug:** `POLYGON_GET_ALL_TICKERS`

Tool to retrieve all ticker symbols across asset classes. Use when you need to filter by market or exchange and paginate through results. Without filters, result sets can be extremely large — always narrow queries using `market`, `search`, `ticker`, or `exchange`.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field to sort by (e.g., ticker, name, market). |
| `limit` | integer | No | Number of results per page (1-1000). |
| `order` | string ("asc" | "desc") | No | Sort order of results. |
| `active` | boolean | No | If true, only active tickers are returned. |
| `cursor` | string | No | Pagination cursor from prior response to fetch next page. |
| `market` | string | No | Filter by market type (e.g., stocks, crypto, fx, otc). |
| `search` | string | No | Search substring in company or ticker names. |
| `ticker` | string | No | Exact ticker symbol to search for (e.g., AAPL). |
| `exchange` | string | No | Filter by exchange symbol (e.g., XNAS, XNYS). |

#### 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 Condition Codes

**Slug:** `POLYGON_GET_CONDITION_CODES`

Tool to retrieve a unified list of trade and quote condition codes and their definitions. Use when needing to decode condition identifiers after fetching market data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by specific condition code ID, e.g., 'P'. |
| `sort` | string | No | Field used to sort results, e.g., 'name', 'asset_class', 'id'. |
| `limit` | integer | No | Maximum number of results to return (server default: 10). |
| `order` | string ("asc" | "desc") | No | Order of results: 'asc' (ascending) or 'desc' (descending). |
| `data_type` | string ("trade" | "quote") | No | Filter by data type: 'trade' or 'quote'. |
| `asset_class` | string | No | Filter by asset class, e.g., 'stocks', 'crypto', 'fx'. |

#### 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 Aggregates

**Slug:** `POLYGON_GET_CRYPTO_AGGREGATES`

Tool to retrieve aggregate bars for a cryptocurrency over a time range. Use when you need to fetch historical bars aggregated by specific time intervals.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | Order by timestamp: 'asc' (oldest first) or 'desc' (newest first). |
| `limit` | integer | No | Maximum number of base aggregates to fetch (default: 5000, max: 50000). |
| `to_date` | string | Yes | End of the aggregate window; 'YYYY-MM-DD' or millisecond timestamp. |
| `adjusted` | boolean | No | Whether results are adjusted for splits (default: true). |
| `timespan` | string ("second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | Time window unit for aggregation. |
| `from_date` | string | Yes | Start of the aggregate window; 'YYYY-MM-DD' or millisecond timestamp. |
| `multiplier` | integer | Yes | Size of the timespan multiplier (integer >= 1). |
| `crypto_ticker` | string | Yes | Ticker symbol of the cryptocurrency pair, e.g., 'BTC-USD'. |

#### 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 All Tickers Snapshot

**Slug:** `POLYGON_GET_CRYPTO_ALL_TICKERS`

Tool to retrieve snapshots for all cryptocurrency tickers. Use when you need a full-market crypto snapshot of the latest values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Case-sensitive list of crypto tickers (e.g., ['X:BTCUSD','X:ETHBTC']). If omitted or empty, returns snapshots for all tickers. Omitting returns all tickers and may produce a very large response; filter with specific tickers when possible. |

#### 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 EMA

**Slug:** `POLYGON_GET_CRYPTO_EMA`

Tool to calculate Exponential Moving Average (EMA) technical indicator for a crypto ticker. Use when you need trend analysis or moving average calculations for cryptocurrency pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Defaults to 10. Maximum is 5000. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. Defaults to 'desc'. |
| `window` | integer | No | The window size used to calculate the exponential moving average (EMA). For example, a window size of 10 with daily aggregates would result in a 10 day moving average. Defaults to 50. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the EMA are adjusted for splits. Defaults to True. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | No | The size of the aggregate time window. Defaults to 'day'. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the exponential moving average. Defaults to 'close'. |
| `timestamp.gt` | string | No | Filter for timestamps greater than the specified value. |
| `timestamp.lt` | string | No | Filter for timestamps less than the specified value. |
| `crypto_ticker` | string | Yes | The cryptocurrency ticker symbol in the format X:BTCUSD, X:ETHBTC, etc. Must include the 'X:' prefix for cryptocurrency pairs. |
| `timestamp.gte` | string | No | Filter for timestamps greater than or equal to the specified value. |
| `timestamp.lte` | string | No | Filter for timestamps less than or equal to the specified value. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Grouped Daily

**Slug:** `POLYGON_GET_CRYPTO_GROUPED_DAILY`

Tool to retrieve daily grouped bars for all cryptocurrencies on a specified date. Use when you need a comprehensive end-of-day summary across all crypto tickers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date for which to retrieve daily grouped crypto bars in YYYY-MM-DD format |
| `adjusted` | boolean | No | Whether results are adjusted for splits; default is 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 Last Trade

**Slug:** `POLYGON_GET_CRYPTO_LAST_TRADE`

Tool to retrieve the last trade for a specified cryptocurrency pair. Use when you need the most recent trade details after specifying both symbols.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to_symbol` | string | Yes | Quote ('to') asset symbol of the crypto pair, e.g., 'USD' |
| `from_symbol` | string | Yes | Base ('from') asset symbol of the crypto pair, e.g., 'BTC' |

#### 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 MACD

**Slug:** `POLYGON_GET_CRYPTO_MACD`

Tool to calculate Moving Average Convergence/Divergence (MACD) technical indicator for a crypto ticker. Use when you need momentum analysis, trend identification, or trading signal generation for cryptocurrency pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Must be between 1 and 5000. Defaults to 10. |
| `order` | string ("asc" | "desc") | No | Order of results by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the MACD are adjusted for splits. Defaults to True. |
| `timespan` | string | No | The size of the aggregate time window. Options: minute, hour, day, week, month, quarter, year. Defaults to 'day'. |
| `timestamp` | string | No | Query by timestamp. Either a date with format YYYY-MM-DD or a millisecond timestamp. |
| `long_window` | integer | Yes | The long window size (number of periods) used to calculate MACD data. Traditional value: 26. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate MACD. Options: open, high, low, close. Defaults to 'close'. |
| `short_window` | integer | Yes | The short window size (number of periods) used to calculate MACD data. Traditional value: 12. |
| `crypto_ticker` | string | Yes | The crypto ticker symbol in format X:FROMTO (e.g., 'X:BTCUSD', 'X:ETHUSD'). Must include the 'X:' prefix for cryptocurrency pairs. |
| `signal_window` | integer | Yes | The window size (number of periods) used to calculate the MACD signal line. Traditional value: 9. |
| `expand_underlying` | boolean | No | Whether to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Open/Close

**Slug:** `POLYGON_GET_CRYPTO_OPEN_CLOSE`

Tool to fetch daily open and close prices for a given crypto pair on a specified date. Use after specifying both currency symbols and the date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base` | string | Yes | Ticker symbol of the base currency (e.g., 'BTC') |
| `date` | string | Yes | Date for which to retrieve open/close prices, in YYYY-MM-DD format |
| `quote` | string | Yes | Ticker symbol of the quote currency (e.g., 'USD') |

#### 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 Previous Close

**Slug:** `POLYGON_GET_CRYPTO_PREV_CLOSE`

Tool to retrieve previous day’s close for a crypto ticker. Use when you need the last closing price of a cryptocurrency before analysis or trading.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `adjusted` | boolean | No | Whether to return adjusted data |
| `crypto_ticker` | string | Yes | Cryptocurrency ticker symbol to query, e.g., 'X:BTCUSD' |

#### 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 RSI

**Slug:** `POLYGON_GET_CRYPTO_RSI`

Tool to calculate the Relative Strength Index (RSI) for a cryptocurrency ticker. Use when you need to analyze momentum or identify overbought/oversold conditions for crypto assets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Default: 5000. Max: 5000. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. Defaults to 'desc'. |
| `window` | integer | No | The window size used to calculate the relative strength index (RSI). Defaults to 14. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the RSI are adjusted for splits. Defaults to True. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | No | The size of the aggregate time window. Defaults to 'day'. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the relative strength index. Defaults to 'close'. |
| `timestamp.gt` | string | No | Filter for timestamps greater than the specified value. |
| `timestamp.lt` | string | No | Filter for timestamps less than the specified value. |
| `crypto_ticker` | string | Yes | The cryptocurrency ticker symbol in the format X:BTCUSD, X:ETHBTC, etc. |
| `timestamp.gte` | string | No | Filter for timestamps greater than or equal to the specified value. |
| `timestamp.lte` | string | No | Filter for timestamps less than or equal to the specified value. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 SMA

**Slug:** `POLYGON_GET_CRYPTO_SMA`

Tool to calculate Simple Moving Average (SMA) technical indicator for a cryptocurrency ticker. Use when you need trend analysis, support/resistance levels, or trading signal generation for crypto pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of base aggregates queried to create the aggregate results. Min: 1, Max: 50000. Defaults to 5000. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'. |
| `window` | integer | Yes | The window size (number of periods) used to calculate the SMA. For example, 50 for a 50-period moving average. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the SMA are adjusted for splits. Defaults to True. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | The size of the aggregate time window. Options: minute, hour, day, week, month, quarter, year. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the SMA. Options: open, high, low, close. Defaults to 'close'. |
| `timestamp.gt` | string | No | Filter for timestamps greater than the specified value. |
| `timestamp.lt` | string | No | Filter for timestamps less than the specified value. |
| `crypto_ticker` | string | Yes | The cryptocurrency ticker symbol in the format X:BTCUSD, X:ETHUSD, etc. Must include the 'X:' prefix for cryptocurrency pairs. |
| `timestamp.gte` | string | No | Filter for timestamps greater than or equal to the specified value. |
| `timestamp.lte` | string | No | Filter for timestamps less than or equal to the specified value. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Ticker Book

**Slug:** `POLYGON_GET_CRYPTO_TICKER_BOOK`

Tool to retrieve the full L2 order book for a crypto ticker. Use when you need a snapshot of combined bids and asks for market depth analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Cryptocurrency ticker symbol. REST format is 'X:BASEQUOTE' (e.g., 'X:BTCUSD'). Common user format 'BTC-USD' is accepted and normalized. |

#### 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 Trades

**Slug:** `POLYGON_GET_CRYPTO_TRADES`

Tool to fetch historical trade data for a cryptocurrency ticker. Use when you need tick-level trades within a time range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field to sort by; must be 'timestamp' |
| `limit` | integer | No | Maximum number of trades to return (default: 1000, max: 50000) |
| `order` | string ("asc" | "desc") | No | Sort order: 'asc' or 'desc' |
| `timestamp` | string | No | Filter by trade timestamp (YYYY-MM-DD or nanosecond Unix timestamp) |
| `timestamp.gt` | string | No | Return trades with timestamp greater than this value |
| `timestamp.lt` | string | No | Return trades with timestamp less than this value |
| `crypto_ticker` | string | Yes | Case-sensitive cryptocurrency ticker (e.g., 'BTC-USD') |
| `timestamp.gte` | string | No | Return trades with timestamp greater than or equal to this value |
| `timestamp.lte` | string | No | Return trades with timestamp less than or equal to this value |

#### 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 Dividends

**Slug:** `POLYGON_GET_DIVIDENDS`

Tool to retrieve dividend data for stocks. Use when you need corporate dividend information for specific tickers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Number of records to skip (pagination) |
| `sort` | string | No | Field to sort by (e.g., ex_dividend_date) |
| `limit` | integer | No | Limit number of results (1-1000) |
| `order` | string ("asc" | "desc") | No | Sort order (ascending or descending) |
| `ticker` | string | No | Filter by ticker symbol |
| `pay_date` | string | No | Filter by payment date (YYYY-MM-DD) |
| `frequency` | string ("annual" | "quarterly" | "monthly" | "semiannual") | No | Filter by dividend frequency |
| `cash_amount` | number | No | Filter by cash amount |
| `record_date` | string | No | Filter by record date (YYYY-MM-DD) |
| `dividend_type` | string | No | Filter by dividend type code |
| `declaration_date` | string | No | Filter by declaration date (YYYY-MM-DD) |
| `ex_dividend_date` | string | No | Filter by ex-dividend date (YYYY-MM-DD) |

#### 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 Economy Inflation Indicators

**Slug:** `POLYGON_GET_ECONOMY_INFLATION`

Tool to retrieve key indicators of realized inflation including CPI and PCE price indexes. Use when analyzing inflation trends, economic conditions, or historical price changes in the U.S. economy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Calendar date of the observation in YYYY-MM-DD format. If not provided, returns recent observations. |
| `sort` | string | No | Sort order for results. Use 'date.asc' for ascending or 'date.desc' for descending. Defaults to 'date.asc'. |
| `limit` | integer | No | Limit the maximum number of results returned. Defaults to 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 |

### Get Exponential Moving Average

**Slug:** `POLYGON_GET_EMA`

Tool to retrieve the Exponential Moving Average for a stock ticker. Use when you need EMA values across a specific timespan with optional underlying data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-5000). Defaults to 100. |
| `order` | string ("asc" | "desc") | No | Sort order for results. Defaults to 'desc'. |
| `window` | integer | Yes | Number of periods to calculate the EMA (must be ≥1). |
| `adjusted` | boolean | No | Whether to adjust results for splits/dividends. Defaults to True. |
| `timespan` | string | Yes | The timespan for each period (e.g., 'day', 'minute', 'hour'). |
| `series_type` | string ("open" | "high" | "low" | "close") | No | Price series to use. Defaults to 'close'. |
| `stock_ticker` | string | Yes | The stock ticker symbol. |
| `expand_underlying` | boolean | No | Include underlying price data. Defaults to False. |

#### 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 SEC Filing

**Slug:** `POLYGON_GET_FILING`

Tool to retrieve SEC filing details by filing ID. Use when you need detailed information about a specific SEC filing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filing_id` | string | Yes | The filing ID to retrieve |

#### 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 SEC Filing File

**Slug:** `POLYGON_GET_FILING_FILE`

Tool to retrieve information about a specific SEC filing file. Use when you need to get metadata and download URL for a particular file within an SEC filing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The specific file identifier within the filing (e.g., 'lvs-20210331_htm.xml'). This identifies which file within the filing to retrieve. |
| `filing_id` | string | Yes | The SEC filing identifier (e.g., '0001300514-21-000058'). This is the unique identifier for the filing document. |

#### 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 Aggregates

**Slug:** `POLYGON_GET_FOREX_AGGREGATES`

Tool to retrieve aggregate bars for a forex pair over a date range. Use when you need custom OHLC bars for forex currency pairs within specified time span.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | Yes | End of the aggregate window as YYYY-MM-DD or millisecond timestamp. |
| `sort` | string ("asc" | "desc") | No | Sort order by timestamp: 'asc' or 'desc'. |
| `from_` | string | Yes | Start of the aggregate window as YYYY-MM-DD or millisecond timestamp. |
| `limit` | integer | No | Max number of base aggregates to query; default is 5000. |
| `adjusted` | boolean | No | Whether results are adjusted for splits; default is true. |
| `timespan` | string ("second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | Size of the time window for each aggregate bar. |
| `multiplier` | integer | Yes | Size of the timespan multiplier, must be >= 1. |
| `forex_ticker` | string | Yes | Ticker symbol of the currency pair, e.g., 'EURUSD'. |

#### 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 EMA

**Slug:** `POLYGON_GET_FOREX_EMA`

Tool to calculate Exponential Moving Average (EMA) technical indicator for a forex pair. Use when you need trend analysis or moving average calculations for currency pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Defaults to 10. Maximum is 5000. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. 'asc' for ascending/oldest first, 'desc' for descending/newest first. Defaults to 'desc'. |
| `window` | integer | No | The window size used to calculate the exponential moving average (EMA). For example, a window size of 10 with daily aggregates would result in a 10 day moving average. Defaults to 50. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the exponential moving average are adjusted for splits. By default, aggregates are adjusted. Set this to false to get results that are NOT adjusted for splits. Defaults to True. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | No | The size of the aggregate time window. Defaults to 'day'. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the exponential moving average. Defaults to 'close'. |
| `forex_ticker` | string | Yes | The forex ticker symbol in format C:FROMTO (e.g., 'C:EURUSD', 'C:GBPJPY'). Must include the 'C:' prefix for forex currency pairs. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Grouped Daily Bars

**Slug:** `POLYGON_GET_FOREX_GROUPED_DAILY`

Tool to retrieve daily grouped OHLC bars for all forex currency pairs on a specified date. Use when you need aggregated forex data after confirming the date parameter.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date for which to retrieve daily aggregated forex bars in YYYY-MM-DD format |
| `adjusted` | boolean | No | Whether to retrieve adjusted data (default: 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 Forex Historical Quotes

**Slug:** `POLYGON_GET_FOREX_HISTORICAL_QUOTES`

Tool to retrieve historical forex quotes for a currency pair over a time range. Use when you need bid/ask quotes for an FX ticker between timestamps or dates. Use after confirming the forex ticker symbol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field to sort by. Must be 'timestamp'. |
| `limit` | integer | No | Max number of results (default 1000, max 50000). |
| `order` | string ("asc" | "desc") | No | Order of results by the sort field (asc or desc). |
| `fxTicker` | string | Yes | The forex currency pair ticker to retrieve quotes for (e.g., 'EURUSD'). |
| `timestamp` | string | No | Filter by date (YYYY-MM-DD) or nanosecond timestamp. |
| `timestamp.gt` | string | No | Return quotes with timestamp greater than this value. |
| `timestamp.lt` | string | No | Return quotes with timestamp less than this value. |
| `timestamp.gte` | string | No | Return quotes with timestamp greater than or equal to this value. |
| `timestamp.lte` | string | No | Return quotes with timestamp less than or equal to this value. |

#### 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 Locales

**Slug:** `POLYGON_GET_FOREX_LOCALES`

Tool to list locales supported by Polygon's forex asset class. Use when you need available locale codes for regional filtering in FX endpoints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `asset_class` | string | No | Optional asset class filter. Common values include 'fx', 'stocks', 'options', 'crypto'. |

#### 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 MACD

**Slug:** `POLYGON_GET_FOREX_MACD`

Tool to calculate Moving Average Convergence/Divergence (MACD) technical indicator for a forex pair. Use when you need momentum analysis, trend identification, or trading signal generation for currency pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. Must be between 1 and 5000. Defaults to 10. |
| `order` | string ("asc" | "desc") | No | The order in which to return results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'. |
| `adjusted` | boolean | No | Whether the aggregates used to calculate MACD are adjusted for splits. Defaults to True. |
| `timespan` | string | Yes | The size of the aggregate time window (e.g., 'day', 'hour', 'minute'). |
| `timestamp` | string | No | Filter by timestamp. Can be a date in YYYY-MM-DD format or a millisecond timestamp. |
| `long_window` | integer | Yes | The long window size (number of periods) used to calculate MACD data. Typically 26. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price field in the aggregate which will be used to calculate MACD. Defaults to 'close'. |
| `forex_ticker` | string | Yes | The forex ticker symbol in format C:FROMTO (e.g., 'C:EURUSD', 'C:GBPJPY'). Must include the 'C:' prefix for forex currency pairs. |
| `short_window` | integer | Yes | The short window size (number of periods) used to calculate MACD data. Typically 12. |
| `timestamp_gt` | string | No | Range filter - only include results where timestamp is greater than this value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_lt` | string | No | Range filter - only include results where timestamp is less than this value. Format: YYYY-MM-DD or millisecond timestamp. |
| `signal_window` | integer | Yes | The window size (number of periods) used to calculate the MACD signal line. Typically 9. |
| `timestamp_gte` | string | No | Range filter - only include results where timestamp is greater than or equal to this value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_lte` | string | No | Range filter - only include results where timestamp is less than or equal to this value. Format: YYYY-MM-DD or millisecond timestamp. |
| `expand_underlying` | boolean | No | Whether to include the underlying aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Previous Close

**Slug:** `POLYGON_GET_FOREX_PREV_CLOSE`

Tool to retrieve previous day's close for a forex ticker. Use when you need the last closing price of a forex currency pair before analysis or trading.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `adjusted` | boolean | No | Whether to return adjusted data |
| `forexTicker` | string | Yes | Forex currency pair ticker symbol to query, e.g., 'EURUSD' |

#### 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 Real-Time Currency Conversion

**Slug:** `POLYGON_GET_FOREX_REAL_TIME_CURRENCY_CONVERSION`

Tool to convert amounts between currency pairs using real-time forex rates. Use when you need to perform currency conversions with the latest market rates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | number | No | The amount to convert with decimal precision. If not provided, defaults to 1. |
| `precision` | integer | No | The decimal precision of the conversion result. Defaults to 2 decimal places. |
| `to_currency` | string | Yes | The 'to' currency symbol to convert to (e.g., 'EUR', 'USD', 'JPY'). |
| `from_currency` | string | Yes | The 'from' currency symbol to convert from (e.g., 'USD', 'EUR', 'GBP'). |

#### 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 RSI

**Slug:** `POLYGON_GET_FOREX_RSI`

Tool to calculate the Relative Strength Index (RSI) technical indicator for a forex pair. Use when you need momentum analysis or want to identify overbought/oversold conditions for currency pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Default: 5000. Max: 5000. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'. |
| `window` | integer | Yes | The window size used to calculate the Relative Strength Index (RSI). Typically 14 for standard RSI calculation. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the RSI are adjusted for splits. Defaults to True. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | The size of the aggregate time window. Required parameter to define the period for RSI calculation. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the RSI. Defaults to 'close'. |
| `forex_ticker` | string | Yes | The forex ticker symbol in format C:FROMTO (e.g., 'C:EURUSD', 'C:GBPJPY'). Must include the 'C:' prefix for forex currency pairs. |
| `timestamp_gt` | string | No | Filter for timestamps greater than the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_lt` | string | No | Filter for timestamps less than the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_gte` | string | No | Filter for timestamps greater than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_lte` | string | No | Filter for timestamps less than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 SMA

**Slug:** `POLYGON_GET_FOREX_SMA`

Tool to calculate Simple Moving Average (SMA) technical indicator for a forex pair. Use when you need trend analysis or moving average calculations for currency pairs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Defaults to 10. Maximum is 5000. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. 'asc' for ascending/oldest first, 'desc' for descending/newest first. Defaults to 'desc'. |
| `window` | integer | No | The window size used to calculate the SMA. For example, a window of 10 with daily aggregates equals a 10-day moving average. Defaults to 50. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the SMA are adjusted for splits. Defaults to True. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | No | The size of the aggregate time window. Defaults to 'day'. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the SMA. Defaults to 'close'. |
| `forex_ticker` | string | Yes | The forex ticker symbol in format C:FROMTO (e.g., 'C:EURUSD', 'C:GBPJPY'). Must include the 'C:' prefix for forex currency pairs. |
| `timestamp.gt` | string | No | Filter for timestamps greater than the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp.lt` | string | No | Filter for timestamps less than the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp.gte` | string | No | Filter for timestamps greater than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp.lte` | string | No | Filter for timestamps less than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Snapshot Losers

**Slug:** `POLYGON_GET_FOREX_SNAPSHOT_LOSERS`

Tool to retrieve the current snapshot of the top losers in the forex market. Use when you need up-to-date information on the worst-performing forex pairs.

#### 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 Futures Aggregates

**Slug:** `POLYGON_GET_FUTURES_AGGREGATES`

Tool to retrieve historical OHLCV aggregates for a futures contract. Use when you need aggregated price and volume data for a futures contract over specified time windows.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field and direction for sorting, e.g., 'window_start.asc', 'ticker.desc' |
| `limit` | integer | No | Number of aggregates to return; default 1000, min 1, max 50000 |
| `ticker` | string | Yes | Futures contract identifier, e.g., 'GCJ5' |
| `resolution` | string | No | Aggregate window size, e.g., '15min', '30sec', '12hour', '7day' |
| `window_start.gte` | string | No | Start edge of windows (inclusive), e.g., '2024-01-01' or millisecond timestamp |
| `window_start.lte` | string | No | End edge of windows (inclusive), e.g., '2024-01-31' or millisecond timestamp |

#### 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 Futures Products

**Slug:** `POLYGON_GET_FUTURES_PRODUCTS`

Tool to retrieve a comprehensive list of futures products with advanced filtering. Use when you need to filter futures listings by date, sector, exchange, or type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Exact product name match, case-sensitive search |
| `sort` | string | No | Sort specifier in the form 'field.direction', e.g., 'ticker.asc' |
| `type` | string ("all" | "single" | "combo") | No | Filter by product type: 'all', 'single', or 'combo' |
| `as_of` | string | No | Point-in-time date in YYYY-MM-DD format (default: today) |
| `limit` | integer | No | Number of results per page (1-1000) |
| `sector` | string | No | Product sector classification |
| `sub_sector` | string | No | Product sub-sector classification |
| `asset_class` | string | No | Top-level asset class |
| `name_search` | string | No | Case-sensitive partial match on product name; maps to `name.search` |
| `trading_venue` | string | No | Exchange MIC code to filter results |
| `asset_sub_class` | string | No | Asset sub-class classification |

#### 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 Futures Product Schedules

**Slug:** `POLYGON_GET_FUTURES_PRODUCT_SCHEDULES`

Tool to retrieve trading schedules for a futures product. Use when you need daily trading session schedules for a given product code.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort by field and direction, e.g., 'ticker.asc' or 'name.desc'. |
| `limit` | integer | No | Results per page (1-1000). Defaults to 100. |
| `product_code` | string | Yes | Futures product code (e.g., 'ES'). |
| `session_end_date` | string | No | Trading day that the schedule ended (YYYY-MM-DD, Central Time). |

#### 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 Futures Quotes

**Slug:** `POLYGON_GET_FUTURES_QUOTES`

Tool to retrieve real-time quote data for a specified futures contract ticker. Use after confirming the exact futures ticker identifier (e.g., 'GCJ5').

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort by field and direction using dotted notation (e.g., 'ticker.asc', 'name.desc') |
| `limit` | integer | No | Results per page; default is 1000; min 1; max 50000 |
| `ticker` | string | Yes | Futures contract identifier including base symbol and expiration (e.g., 'GCJ5') |
| `timestamp` | string | No | Filter by trade timestamp; either YYYY-MM-DD or a nanosecond timestamp |
| `session_end_date` | string | No | Trading session end 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 Futures Schedules

**Slug:** `POLYGON_GET_FUTURES_SCHEDULES`

Tool to retrieve futures trading schedules. Use when you need trading schedules for all futures contracts on a specific date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort by field.direction, e.g., 'product_code.asc' or 'product_name.desc' |
| `limit` | integer | No | Number of results per page (1-1000). Default is 100. |
| `trading_venue` | string | No | Exchange MIC to filter schedules, e.g., 'CME' |
| `session_end_date` | string | No | Trading date to query (YYYY-MM-DD, CT). Defaults to today in CT if omitted. |

#### 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 Futures Trades

**Slug:** `POLYGON_GET_FUTURES_TRADES`

Tool to retrieve tick-level trade data for a specified futures contract. Use when you need detailed trade data over a time range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort field and direction in 'field.direction' format, e.g., 'timestamp.asc'. |
| `limit` | integer | No | Maximum number of trades to return; default 1000, max 50000. |
| `ticker` | string | Yes | Futures contract identifier including base symbol and expiration (e.g., 'GCJ5') |
| `timestamp` | string | No | Filter by timestamp; YYYY-MM-DD or Unix nanosecond timestamp. |
| `timestamp.gt` | string | No | Return trades with timestamp greater than this value. |
| `timestamp.lt` | string | No | Return trades with timestamp less than this value. |
| `timestamp.gte` | string | No | Return trades with timestamp greater than or equal to this value. |
| `timestamp.lte` | string | No | Return trades with timestamp less than or equal to this value. |
| `session_end_date` | string | No | Trading date filter in YYYY-MM-DD; supports filter modifiers via alias fields. |
| `session_end_date.gt` | string | No | Return trades with session_end_date greater than this value. |
| `session_end_date.lt` | string | No | Return trades with session_end_date less than this value. |
| `session_end_date.gte` | string | No | Return trades with session_end_date greater than or equal to this value. |
| `session_end_date.lte` | string | No | Return trades with session_end_date less than or equal to this value. |

#### 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 Historic Forex Ticks

**Slug:** `POLYGON_GET_HISTORIC_FOREX_TICKS`

Tool to get historic ticks for a currency pair on a specific date. Use when you need historical forex tick-level data (ask/bid prices with timestamps) for a given day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | The specific day for which to retrieve historical tick data in YYYY-MM-DD or YYYY-M-D format (e.g., '2017-6-22', '2024-01-15'). |
| `limit` | integer | No | Controls response size; defaults to 100, maximum of 10,000 entries. |
| `offset` | integer | No | Pagination mechanism using timestamp offset to fetch the next set of results. |
| `to_currency` | string | Yes | The 'to' currency symbol (quote currency) in the pair (e.g., 'JPY', 'USD', 'EUR'). |
| `from_currency` | string | Yes | The 'from' currency symbol (base currency) in the pair (e.g., 'USD', 'EUR', 'GBP'). |

#### 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 Inflation Expectations

**Slug:** `POLYGON_GET_INFLATION_EXPECTATIONS`

Tool to retrieve inflation expectations data from the Federal Reserve based on Treasury yields and Cleveland Fed models. Use when analyzing expected future inflation rates across multiple time horizons (1-year, 5-year, 10-year, 30-year).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Calendar date in YYYY-MM-DD format for a specific observation |
| `sort` | string | No | Sort order for results. Use 'date.asc' for ascending or 'date.desc' for descending |
| `limit` | integer | No | Maximum number of results to return. Defaults to 100, max 50,000 |
| `date.gt` | string | No | Date comparison filter - observations after this date (YYYY-MM-DD format) |
| `date.lt` | string | No | Date comparison filter - observations before this date (YYYY-MM-DD format) |
| `date.gte` | string | No | Date comparison filter - observations on or after this date (YYYY-MM-DD format) |
| `date.lte` | string | No | Date comparison filter - observations on or before this date (YYYY-MM-DD format) |
| `date.any_of` | string | No | Date comparison filter - any of the specified dates (comma-separated) |

#### 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 IPO Data

**Slug:** `POLYGON_GET_IPO_DATA`

Tool to retrieve comprehensive information on Initial Public Offerings (IPOs), including upcoming and historical events. Use when analyzing IPO listing data by date range, ticker, or identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `isin` | string | No | Filter by ISIN (International Securities Identification Number). |
| `sort` | string | No | Field to sort by (e.g., 'listing_date', 'ticker'). Default: 'listing_date'. |
| `limit` | integer | No | Limit the number of results returned (1-1000). Default: 10, Max: 1000. |
| `order` | string ("asc" | "desc") | No | Sort order direction: 'asc' for ascending or 'desc' for descending. Default: 'desc'. |
| `ticker` | string | No | Filter by ticker symbol. |
| `us_code` | string | No | Filter by US code (ISIN identifier). |
| `listing_date` | string | No | Filter by exact listing date (format: YYYY-MM-DD). |
| `listing_date_gte` | string | No | Filter for IPOs listed on or after this date (format: YYYY-MM-DD). |
| `listing_date_lte` | string | No | Filter for IPOs listed on or before this date (format: YYYY-MM-DD). |

#### 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 MACD

**Slug:** `POLYGON_GET_MACD`

Tool to retrieve the Moving Average Convergence/Divergence (MACD) for a stock ticker. Use when you need momentum analysis or signal generation over a specified timeframe.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-5000). Defaults to 10. |
| `order` | string ("asc" | "desc") | No | The order of results by timestamp. Defaults to 'desc'. |
| `adjusted` | boolean | No | Whether to use split-adjusted aggregates. Defaults to True. |
| `timespan` | string | Yes | The size of the aggregate time window (e.g., 'day'). |
| `timestamp` | string | No | Filter by timestamp (YYYY-MM-DD or millisecond timestamp). |
| `long_window` | integer | Yes | The number of periods for the long EMA window (e.g., 26). |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price field to use for calculations. Defaults to 'close'. |
| `short_window` | integer | Yes | The number of periods for the short EMA window (e.g., 12). |
| `stock_ticker` | string | Yes | The case-sensitive ticker symbol for which to get MACD data (e.g., 'AAPL'). |
| `signal_window` | integer | Yes | The number of periods for the signal line EMA window (e.g., 9). |
| `expand_underlying` | boolean | No | Whether to include the underlying aggregates data. Defaults to False. |

#### 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 Upcoming Market Holidays

**Slug:** `POLYGON_GET_MARKET_HOLIDAYS`

Tool to retrieve upcoming market holidays and half-day closures. Use when you need to look up upcoming exchange holidays and early closures.

#### 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 Market Status

**Slug:** `POLYGON_GET_MARKET_STATUS`

Tool to retrieve current market status. Use when you need to know if U.S. exchanges are open, closed, or on holiday.

#### 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 Meta Conditions By Ticktype

**Slug:** `POLYGON_GET_META_CONDITIONS_BY_TICKTYPE`

Tool to retrieve condition code mappings for a specific tick type (trades or quotes). Use when you need to decode numeric condition codes into human-readable labels for market data interpretation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticktype` | string ("trades" | "quotes") | Yes | The type of ticks to return mappings for. Must be either 'trades' or 'quotes'. |

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

**Slug:** `POLYGON_GET_NEWS`

Tool to retrieve recent news articles related to a ticker. Use when you need to fetch financial news after identifying a ticker symbol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field to sort by (only 'published_utc' supported) |
| `limit` | integer | No | Number of results to return (1–100) |
| `order` | string ("asc" | "desc") | No | Sort order of results |
| `cursor` | string | No | Pagination token for the next page of results |
| `ticker` | string | No | Ticker symbol to filter news (e.g., 'AAPL') |
| `published_utc.gte` | string | No | Return articles published on or after this ISO 8601 timestamp |
| `published_utc.lte` | string | No | Return articles published on or before this ISO 8601 timestamp |

#### 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 Stock Open/Close

**Slug:** `POLYGON_GET_OPEN_CLOSE`

Tool to fetch daily open and close prices for a stock on a specific date. Use when you need daily OHLC with pre/post-market prices.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date for which to retrieve open/close prices, in YYYY-MM-DD format |
| `adjusted` | boolean | No | Whether results are adjusted for splits. Set to false for unadjusted. |
| `stocksTicker` | string | Yes | Ticker symbol of the stock (e.g., '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 Option Chain Snapshot

**Slug:** `POLYGON_GET_OPTION_CHAIN_SNAPSHOT`

Tool to fetch a real-time snapshot of all option contracts for an underlying asset. Use after selecting the underlying ticker to retrieve live option chain data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field to sort by |
| `limit` | integer | No | Maximum number of results (default=10, max=250) |
| `order` | string ("asc" | "desc") | No | Sort direction for results |
| `strike_price` | number | No | Filter by strike price; supports filter modifiers (>, <, etc.) |
| `contract_type` | string ("call" | "put") | No | Option contract type |
| `expiration_date` | string | No | Filter by expiration date in YYYY-MM-DD format; supports modifiers |
| `underlying_ticker` | string | Yes | Underlying ticker symbol for the option chain snapshot (e.g., '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 Options Contract Overview

**Slug:** `POLYGON_GET_OPTIONS_CONTRACT_OVERVIEW`

Tool to retrieve comprehensive details about a specific options contract including contract type, exercise style, expiration date, strike price, and underlying ticker. Use when you need specifications for options contract analysis or strategy development.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `as_of` | string | No | Specify a point in time for the contract as of this date. Format: YYYY-MM-DD. Defaults to today's date. |
| `options_ticker` | string | Yes | The options contract identifier following standard options ticker format (e.g., O:SPY241220C00450000, O:AAPL251219C00010000). |

#### 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 Options Custom Bars

**Slug:** `POLYGON_GET_OPTIONS_CUSTOM_BARS`

Tool to retrieve historical OHLC and volume data for options contracts over custom date ranges with configurable time windows. Use when you need aggregate bars for options price analysis or strategy development.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | Sort results by timestamp. 'asc' for ascending (oldest first), 'desc' for descending (newest first). |
| `limit` | integer | No | Limits the number of base aggregates queried. Maximum: 50000, Default: 5000. |
| `to_date` | string | Yes | The end of the aggregate time window. Can be in YYYY-MM-DD format or Unix millisecond timestamp. |
| `adjusted` | boolean | No | Whether results are adjusted for splits. Set to false to get results that are NOT adjusted for splits. Defaults to true. |
| `timespan` | string ("second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | The size of the time window for each aggregate bar. |
| `from_date` | string | Yes | The start of the aggregate time window. Can be in YYYY-MM-DD format or Unix millisecond timestamp. |
| `multiplier` | integer | Yes | The size of the timespan multiplier. Must be a positive integer. Used to customize the time window size. |
| `options_ticker` | string | Yes | The ticker symbol of the options contract (e.g., 'O:AAPL251219C00250000', 'O:SPY241220P00720000'). Must follow standard options ticker 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 Options EMA

**Slug:** `POLYGON_GET_OPTIONS_EMA`

Tool to calculate Exponential Moving Average (EMA) technical indicator for an options ticker. Use when you need trend analysis or moving average calculations for options contracts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Must be between 1 and 5000. Defaults to 10. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'. |
| `window` | integer | Yes | The window size used to calculate the exponential moving average (EMA). For example, a window size of 10 with daily aggregates would result in a 10 day moving average. Required parameter. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the EMA are adjusted for splits. Defaults to True. |
| `timespan` | string | Yes | The size of the aggregate time window. Options: minute, hour, day, week, month, quarter, year. Required parameter. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the exponential moving average. Defaults to 'close'. |
| `timestamp.gt` | string | No | Filter for timestamps greater than the specified value. |
| `timestamp.lt` | string | No | Filter for timestamps less than the specified value. |
| `timestamp.gte` | string | No | Filter for timestamps greater than or equal to the specified value. |
| `timestamp.lte` | string | No | Filter for timestamps less than or equal to the specified value. |
| `options_ticker` | string | Yes | The options ticker symbol in format O:UNDERLYINGYYMMDDCOOOOOOOOO (e.g., 'O:AAPL250117C00250000'). Must include the 'O:' prefix for options contracts. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Options MACD

**Slug:** `POLYGON_GET_OPTIONS_MACD`

Tool to calculate Moving Average Convergence/Divergence (MACD) technical indicator for an options ticker. Use when you need momentum analysis, trend identification, or trading signal generation for options contracts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Must be between 1 and 5000. Defaults to 10. |
| `order` | string ("asc" | "desc") | No | Order of results by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the MACD are adjusted for splits. Defaults to True. |
| `timespan` | string | Yes | The size of the aggregate time window. Options: minute, hour, day, week, month, quarter, year. Required parameter. |
| `timestamp` | string | Yes | Query by timestamp. Either a date with format YYYY-MM-DD or a millisecond timestamp. Required parameter. |
| `long_window` | integer | Yes | The long window size (number of periods) used to calculate MACD data. Traditional value: 26. Required parameter. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate MACD. Options: open, high, low, close. Defaults to 'close'. |
| `short_window` | integer | Yes | The short window size (number of periods) used to calculate MACD data. Traditional value: 12. Required parameter. |
| `signal_window` | integer | Yes | The window size (number of periods) used to calculate the MACD signal line. Traditional value: 9. Required parameter. |
| `options_ticker` | string | Yes | The options ticker symbol in format O:UNDERLYINGYYMMDDCOOOOOOOOO (e.g., 'O:AAPL251219C00150000'). Must include the 'O:' prefix for options contracts. |
| `expand_underlying` | boolean | No | Whether to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Option Snapshot

**Slug:** `POLYGON_GET_OPTION_SNAPSHOT`

Tool to retrieve a real-time snapshot for a single option contract. Use when you need up-to-the-minute quotes, trades, greeks, and metrics for a specified option contract.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `option_contract` | string | Yes | Option contract identifier (e.g., 'AAPL210917C00145000') |
| `underlying_asset` | string | Yes | Underlying ticker symbol of the option contract (e.g., '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 Options RSI

**Slug:** `POLYGON_GET_OPTIONS_RSI`

Tool to calculate Relative Strength Index (RSI) technical indicator for an options ticker. Use when you need momentum analysis or want to identify overbought/oversold conditions for options contracts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of base aggregates queried to create the aggregate results. Default: 5000. Max: 50000. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'. |
| `window` | integer | No | The window size used to calculate the Relative Strength Index (RSI). Typically 14 for standard RSI calculation. Defaults to 14. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the RSI are adjusted for splits. Defaults to True. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | The size of the aggregate time window. Required parameter to define the period for RSI calculation. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the RSI. Defaults to 'close'. |
| `timestamp_gt` | string | No | Filter for timestamps greater than the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_lt` | string | No | Filter for timestamps less than the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_gte` | string | No | Filter for timestamps greater than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_lte` | string | No | Filter for timestamps less than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `options_ticker` | string | Yes | The options ticker symbol in format O:UNDERLYINGYYMMDDCOOOOOOOOO (e.g., 'O:AAPL250117C00250000'). Must include the 'O:' prefix for options contracts. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Options SMA

**Slug:** `POLYGON_GET_OPTIONS_SMA`

Tool to calculate Simple Moving Average (SMA) technical indicator for an options ticker. Use when you need trend analysis or smoothed price data for options contracts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results returned. Must be between 1 and 5000. Defaults to 10. |
| `order` | string ("asc" | "desc") | No | The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'asc'. |
| `cursor` | string | No | Cursor value for pagination to fetch the next page of data. |
| `window` | integer | Yes | The window size used to calculate the simple moving average (SMA). For example, a window of 10 with daily aggregates results in a 10-day moving average. Required parameter. |
| `adjusted` | boolean | No | Whether or not the aggregates used to calculate the SMA are adjusted for splits. Defaults to True. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | The size of the aggregate time window. Required parameter to define the period for SMA calculation. |
| `timestamp` | string | No | Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | The price in the aggregate which will be used to calculate the SMA. Defaults to 'close'. |
| `timestamp_gt` | string | No | Filter for timestamps greater than the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_lt` | string | No | Filter for timestamps less than the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_gte` | string | No | Filter for timestamps greater than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `timestamp_lte` | string | No | Filter for timestamps less than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp. |
| `options_ticker` | string | Yes | The options ticker symbol in format O:UNDERLYINGYYMMDDCOOOOOOOOO (e.g., 'O:SPY241220C00580000'). Must include the 'O:' prefix for options contracts. |
| `expand_underlying` | boolean | No | Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False. |

#### 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 Previous Close

**Slug:** `POLYGON_GET_PREVIOUS_CLOSE`

Tool to get previous trading day’s OHLC and volume for a stock. Use when you need the last day’s open, high, low, close, and volume for a given ticker.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Case-sensitive stock ticker symbol to query, e.g., 'AAPL' |
| `adjusted` | boolean | No | Whether to return adjusted data for splits; default is 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 reference exchanges

**Slug:** `POLYGON_GET_REFERENCE_EXCHANGES`

Tool to retrieve supported exchanges and their details. Use when you need a list of exchanges filtered by asset class or locale.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `locale` | string | No | Filter by locale (e.g., 'us'). |
| `asset_class` | string ("stocks" | "options" | "crypto" | "fx") | No | Filter by asset class. One of 'stocks', 'options', 'crypto', 'fx'. |

#### 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 reference markets

**Slug:** `POLYGON_GET_REFERENCE_MARKETS`

Tool to retrieve all supported markets from Polygon.io. Use when you need a list of available market types.

#### 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 Reference Ticker Types

**Slug:** `POLYGON_GET_REFERENCE_TYPES`

Tool to retrieve all ticker types supported by Polygon. Use when you need to understand the different ticker classifications available across asset classes and markets.

#### 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 Related Companies

**Slug:** `POLYGON_GET_RELATED_COMPANIES`

Tool to get a list of related companies for a ticker symbol based on various similarity metrics. Use when you need to find companies related to a specific ticker.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | The ticker symbol to search for related companies (e.g., '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 Risk Categories

**Slug:** `POLYGON_GET_RISK_CATEGORIES`

Tool to retrieve risk factor taxonomy categories from SEC 10-K filings. Use when you need to explore or filter risk classifications by taxonomy version or category level.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Comma-separated columns with .asc or .desc direction (e.g., 'taxonomy.asc,primary_category.desc') |
| `limit` | integer | No | Maximum number of results to return (default: 200, max: 999) |
| `taxonomy` | number | No | Version identifier for the taxonomy (e.g., 1.0, 1.1) |
| `taxonomy.gt` | number | No | Filter taxonomy versions greater than this value |
| `taxonomy.lt` | number | No | Filter taxonomy versions less than this value |
| `taxonomy.gte` | number | No | Filter taxonomy versions greater than or equal to this value |
| `taxonomy.lte` | number | No | Filter taxonomy versions less than or equal to this value |
| `primary_category` | string | No | Filter by top-level risk category |
| `tertiary_category` | string | No | Filter by most specific risk classification |
| `secondary_category` | string | No | Filter by mid-level risk category |
| `primary_category.gt` | string | No | Filter primary categories greater than this value |
| `primary_category.lt` | string | No | Filter primary categories less than this value |
| `primary_category.gte` | string | No | Filter primary categories greater than or equal to this value |
| `primary_category.lte` | string | No | Filter primary categories less than or equal to this value |
| `tertiary_category.gt` | string | No | Filter tertiary categories greater than this value |
| `tertiary_category.lt` | string | No | Filter tertiary categories less than this value |
| `secondary_category.gt` | string | No | Filter secondary categories greater than this value |
| `secondary_category.lt` | string | No | Filter secondary categories less than this value |
| `tertiary_category.gte` | string | No | Filter tertiary categories greater than or equal to this value |
| `tertiary_category.lte` | string | No | Filter tertiary categories less than or equal to this value |
| `secondary_category.gte` | string | No | Filter secondary categories greater than or equal to this value |
| `secondary_category.lte` | string | No | Filter secondary categories less than or equal to this value |
| `primary_category.any_of` | string | No | Comma-separated list of primary categories to match any of |
| `tertiary_category.any_of` | string | No | Comma-separated list of tertiary categories to match any of |
| `secondary_category.any_of` | string | No | Comma-separated list of secondary categories to match any of |

#### 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 RSI

**Slug:** `POLYGON_GET_RSI`

Tool to retrieve the Relative Strength Index (RSI) for a stock ticker. Use after confirming ticker symbol and timespan to analyze momentum over a period.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-5000). Defaults to 5000. |
| `order` | string ("asc" | "desc") | No | Sort order of results. Defaults to 'desc'. |
| `window` | integer | No | Lookback window for RSI calculation (must be 1). Defaults to 14. |
| `adjusted` | boolean | No | Whether to use adjusted values (splits/dividends). Defaults to True. |
| `timespan` | string | Yes | The size of the time window (e.g., 'day', 'minute', 'hour'). |
| `timestamp` | integer | No | Return results before this timestamp (ms since epoch). |
| `series_type` | string ("open" | "high" | "low" | "close") | No | Price field to use for calculation. Defaults to 'close'. |
| `stock_ticker` | string | Yes | The stock ticker symbol (e.g., 'AAPL'). |
| `timestampLimit` | integer | No | Return results after this timestamp (ms since epoch). |

#### 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 Short Interest

**Slug:** `POLYGON_GET_SHORT_INTEREST`

Tool to retrieve bi-monthly aggregated short interest data for stocks reported to FINRA. Use when analyzing sentiment, identifying potential short squeezes, or researching short positions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Comma-separated list of sort columns. Append '.asc' or '.desc' to each column for sort direction. Defaults to 'ticker' if not specified. |
| `limit` | integer | No | Maximum number of results to return. Defaults to 10, maximum is 50000. |
| `ticker` | string | No | Filter by primary ticker symbol. Supports filter modifiers: .gt (greater than), .gte (greater than or equal), .lt (less than), .lte (less than or equal), .any_of (match any in comma-separated list). |
| `days_to_cover` | number | No | Filter by days to cover (short_interest / avg_daily_volume). Supports filter modifiers: .gt, .gte, .lt, .lte. |
| `settlement_date` | string | No | Filter by settlement date in YYYY-MM-DD format. Supports filter modifiers: .gt, .gte, .lt, .lte for date range queries. |
| `avg_daily_volume` | integer | No | Filter by average daily trading volume. Supports filter modifiers: .gt, .gte, .lt, .lte. |

#### 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 Short Volume

**Slug:** `POLYGON_GET_SHORT_VOLUME`

Tool to retrieve short volume data for stocks. Use when analyzing short selling activity, market sentiment, or detecting abnormal short-selling patterns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Filter by date in YYYY-MM-DD format. Supports comparison operators (.gt, .gte, .lt, .lte) and .any_of for multiple values |
| `sort` | string | No | Sort order for results. Comma-separated columns with .asc/.desc direction (e.g., 'ticker.asc', 'date.desc'). Default: ticker.asc |
| `limit` | integer | No | Limit the number of results (1-50000). Default: 10, Maximum: 50000 |
| `ticker` | string | No | Filter by stock ticker symbol. Supports comparison operators (.gt, .gte, .lt, .lte) and .any_of for multiple values |
| `total_volume` | integer | No | Filter by total volume. Supports comparison operators (.gt, .gte, .lt, .lte) and .any_of |
| `short_volume_ratio` | number | No | Filter by short volume ratio (percentage of total trading volume sold short). Supports comparison operators (.gt, .gte, .lt, .lte) and .any_of |

#### 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 Simple Moving Average

**Slug:** `POLYGON_GET_SMA`

Tool to retrieve the Simple Moving Average (SMA) for any ticker (stocks, forex, crypto). Use when you need SMA values over a specified timespan with optional underlying data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-1000). Defaults to 250. |
| `order` | string ("asc" | "desc") | No | Sort order for results. Defaults to 'desc'. |
| `window` | integer | Yes | Number of periods to calculate the SMA (must be ≥1). |
| `adjusted` | boolean | No | Whether to adjust results for splits/dividends. Defaults to True. |
| `timespan` | string | Yes | The timespan for each period (e.g., 'minute', 'hour', 'day'). |
| `fx_ticker` | string | Yes | The ticker symbol. Use 'C:EURUSD' for forex, 'AAPL' for stocks, 'X:BTCUSD' for crypto. |
| `timestamp` | integer | No | Millisecond UNIX timestamp to anchor the indicator. Defaults to most recent. |
| `series_type` | string ("open" | "high" | "low" | "close") | No | Price series to use. Defaults to 'close'. |
| `expand_underlying` | boolean | No | Include underlying aggregate data. Defaults to False. |

#### 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 All Stock Tickers Snapshot

**Slug:** `POLYGON_GET_SNAPSHOT_ALL_TICKERS`

Tool to retrieve the current market snapshot for all stock tickers. Use when you need real-time OHLCV, trades, and quotes across the entire US stock market in one call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tickers` | array | No | Case-sensitive list of stock ticker symbols (e.g., ['AAPL','TSLA','GOOG']). If omitted or empty, returns snapshots for all tickers. |
| `include_otc` | boolean | No | Whether to include over-the-counter (OTC) securities in the snapshot. |

#### 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 Stock Snapshot Losers

**Slug:** `POLYGON_GET_SNAPSHOT_LOSERS`

Tool to retrieve the current snapshot of the top losers in the U.S. stock market. Use when you need up-to-date information on the worst-performing stocks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include_otc` | boolean | No | Whether to include OTC securities; default false |

#### 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 Stock Snapshot Ticker

**Slug:** `POLYGON_GET_SNAPSHOT_SINGLE_TICKER`

Tool to retrieve the current snapshot of a specific stock ticker. Use when you need the most recent market snapshot after specifying the ticker symbol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | Case-sensitive stock ticker symbol (e.g., '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 Stock Splits

**Slug:** `POLYGON_GET_SPLITS`

Tool to retrieve stock split events. Use when you need corporate stock split data filtered by ticker or date range. Example: "Get splits for AAPL between 2021-01-01 and 2021-12-31".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field to sort results by (default: 'execution_date') |
| `limit` | integer | No | Maximum number of results to return (1-1000) |
| `order` | string ("asc" | "desc") | No | Sort order: 'asc' or 'desc' (default: 'desc') |
| `ticker` | string | No | Stock ticker symbol to query splits for, e.g., 'AAPL' |
| `execution_date.gte` | string | No | Filter splits executed on or after this date (YYYY-MM-DD) |
| `execution_date.lte` | string | No | Filter splits executed on or before this date (YYYY-MM-DD) |

#### 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 Stock Financials

**Slug:** `POLYGON_GET_STOCK_FINANCIALS`

Tool to retrieve historical financial data for a stock ticker from SEC filings. Use when analyzing company financials, comparing quarters, or examining financial trends.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("reportPeriod" | "-reportPeriod" | "calendarDate" | "-calendarDate") | No | Sort order for financial results. |
| `type` | string ("Y" | "YA" | "Q" | "QA" | "T" | "TA") | No | Report type for financial data. |
| `limit` | integer | No | Limit the number of results returned (1-5000) |
| `stocks_ticker` | string | Yes | The stock ticker symbol to retrieve financials for |

#### 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 Stock Float

**Slug:** `POLYGON_GET_STOCK_FLOAT`

Tool to retrieve stock float data showing the number and percentage of publicly tradable shares. Use when you need information about the free float of stocks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Comma-separated sort columns with '.asc'/'.desc' directives (e.g., 'ticker.asc') |
| `limit` | integer | No | Maximum results returned (default: 100, max: 5000) |
| `ticker` | string | No | Primary ticker symbol for the stock |
| `ticker_gt` | string | No | Filter for ticker greater than specified value |
| `ticker_lt` | string | No | Filter for ticker less than specified value |
| `ticker_gte` | string | No | Filter for ticker greater than or equal to specified value |
| `ticker_lte` | string | No | Filter for ticker less than or equal to specified value |
| `ticker_any_of` | string | No | Filter equal to any of the values. Multiple values can be specified by using a comma separated list |
| `free_float_percent` | number | No | Percentage of total shares outstanding that are available for public trading, rounded to two decimal places |
| `free_float_percent_gt` | number | No | Filter for free float percentage greater than specified value |
| `free_float_percent_lt` | number | No | Filter for free float percentage less than specified value |
| `free_float_percent_gte` | number | No | Filter for free float percentage greater than or equal to specified value |
| `free_float_percent_lte` | number | No | Filter for free float percentage less than or equal to specified value |

#### 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 Stocks Balance Sheets

**Slug:** `POLYGON_GET_STOCKS_BALANCE_SHEETS`

Tool to retrieve point-in-time balance sheet data including assets, liabilities, and equity from company SEC filings. Use when analyzing financial position with quarterly and annual history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cik` | string | No | The company's Central Index Key (CIK), a unique identifier assigned by the SEC |
| `sic` | string | No | Query by Standard Industrial Classification (SIC) code |
| `sort` | string | No | The sort field used for ordering. Default: 'filing_date' |
| `limit` | integer | No | Limit the number of results returned (1-100). Default: 10 |
| `order` | string ("asc" | "desc") | No | Order results based on the sort field. Default: 'asc' |
| `ticker` | string | No | Query by company ticker symbol, e.g., 'AAPL' |
| `timeframe` | string ("quarterly" | "annual" | "ttm") | No | The timeframe of the report. Annual financials originate from 10-K filings, quarterly from 10-Q filings |
| `filing_date` | string | No | Query by the date when the filing was filed (YYYY-MM-DD format) |
| `company_name` | string | No | Query by exact company name |
| `filing_date_gt` | string | No | Filing date greater than (YYYY-MM-DD) |
| `filing_date_lt` | string | No | Filing date less than (YYYY-MM-DD) |
| `filing_date_gte` | string | No | Filing date greater than or equal (YYYY-MM-DD) |
| `filing_date_lte` | string | No | Filing date less than or equal (YYYY-MM-DD) |
| `include_sources` | boolean | No | Whether to include the xpath and formula attributes for each financial data point for traceability |
| `company_name_search` | string | No | Search by partial company name |
| `period_of_report_date` | string | No | The period of report for the filing (YYYY-MM-DD format) |
| `period_of_report_date_gt` | string | No | Period of report date greater than (YYYY-MM-DD) |
| `period_of_report_date_lt` | string | No | Period of report date less than (YYYY-MM-DD) |
| `period_of_report_date_gte` | string | No | Period of report date greater than or equal (YYYY-MM-DD) |
| `period_of_report_date_lte` | string | No | Period of report date less than or equal (YYYY-MM-DD) |

#### 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 Stocks Cash Flow Statements

**Slug:** `POLYGON_GET_STOCKS_CASH_FLOW_STATEMENTS`

Tool to retrieve historical cash flow statement data from company SEC filings across quarterly, annual, and TTM frequencies. Use when analyzing cash generation, operating activities, investing activities, or financing activities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cik` | string | No | The company's Central Index Key (CIK), a unique identifier assigned by the SEC |
| `sic` | string | No | Query by Standard Industrial Classification (SIC) code |
| `sort` | string | No | The sort field used for ordering. Default: 'filing_date' |
| `limit` | integer | No | Limit the number of results returned (1-100). Default: 10 |
| `order` | string ("asc" | "desc") | No | Order results based on the sort field. Default: 'asc' |
| `ticker` | string | No | Query by company ticker symbol, e.g., 'AAPL' |
| `timeframe` | string ("quarterly" | "annual" | "ttm") | No | The timeframe of the report. Annual financials originate from 10-K filings, quarterly from 10-Q filings, TTM is trailing twelve months |
| `filing_date` | string | No | Query by the date when the filing was filed (YYYY-MM-DD format) |
| `company_name` | string | No | Query by exact company name |
| `filing_date_gt` | string | No | Filing date greater than (YYYY-MM-DD) |
| `filing_date_lt` | string | No | Filing date less than (YYYY-MM-DD) |
| `filing_date_gte` | string | No | Filing date greater than or equal (YYYY-MM-DD) |
| `filing_date_lte` | string | No | Filing date less than or equal (YYYY-MM-DD) |
| `include_sources` | boolean | No | Whether to include the xpath and formula attributes for each financial data point for traceability |
| `company_name_search` | string | No | Search by partial company name |
| `period_of_report_date` | string | No | The period of report for the filing (YYYY-MM-DD format) |
| `period_of_report_date_gt` | string | No | Period of report date greater than (YYYY-MM-DD) |
| `period_of_report_date_lt` | string | No | Period of report date less than (YYYY-MM-DD) |
| `period_of_report_date_gte` | string | No | Period of report date greater than or equal (YYYY-MM-DD) |
| `period_of_report_date_lte` | string | No | Period of report date less than or equal (YYYY-MM-DD) |

#### 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 Stocks Custom Bars

**Slug:** `POLYGON_GET_STOCKS_CUSTOM_BARS`

Tool to retrieve aggregated historical OHLC and volume data for a stock over custom date ranges with configurable time windows. Use when you need aggregate bars for stock price analysis, backtesting, or charting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | Sort results by timestamp. 'asc' for ascending (oldest first), 'desc' for descending (newest first). |
| `limit` | integer | No | Limits the number of base aggregates queried. Maximum: 50000, Default: 5000. |
| `to_date` | string | Yes | The end of the aggregate time window. Can be in YYYY-MM-DD format or Unix millisecond timestamp. |
| `adjusted` | boolean | No | Whether results are adjusted for splits. Set to false to get results that are NOT adjusted for splits. Defaults to true. |
| `timespan` | string ("minute" | "hour" | "day" | "week" | "month" | "quarter" | "year") | Yes | The size of the time window for each aggregate bar. |
| `from_date` | string | Yes | The start of the aggregate time window. Can be in YYYY-MM-DD format or Unix millisecond timestamp. |
| `multiplier` | integer | Yes | The size of the timespan multiplier. Must be a positive integer. Used to customize the time window size. |
| `stocks_ticker` | string | Yes | The ticker symbol of the stock/equity (e.g., 'AAPL', 'TSLA', 'MSFT'). Must be a valid stock ticker. |

#### 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 Stocks Daily Market Summary

**Slug:** `POLYGON_GET_STOCKS_DAILY_MARKET_SUMMARY`

Tool to retrieve daily OHLC, volume, and VWAP data for all U.S. stocks on a specified trading date. Use when you need to get grouped daily aggregate bars for all US stocks for a specific date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | The date to get aggregate bars for in YYYY-MM-DD format (e.g., '2024-12-13') |
| `adjusted` | boolean | No | Whether results are adjusted for splits. Set to false for unadjusted results. Defaults to true. |
| `include_otc` | boolean | No | Include OTC (Over-The-Counter) securities in response. Defaults to false. |

#### 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 Stock Splits by Ticker

**Slug:** `POLYGON_GET_STOCK_SPLITS_BY_TICKER`

Tool to retrieve historical stock splits for a specific ticker symbol. Use when you need split history including ex-dates, payment dates, and split ratios for a particular stock.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stocks_ticker` | string | Yes | The ticker symbol of the stock (e.g., '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 Exponential Moving Average (EMA) (Deprecated)

**Slug:** `POLYGON_GET_TECHNICAL_INDICATOR_EMA`

DEPRECATED: Use POLYGON_GET_EMA instead. Tool to fetch Exponential Moving Average (EMA) for a given stock ticker. Use when you need historical EMA data after confirming ticker, timespan, and window size.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return |
| `order` | string ("asc" | "desc") | No | Order of results |
| `ticker` | string | Yes | Stock ticker symbol to query, e.g., 'AAPL' |
| `window` | integer | Yes | Number of periods to calculate the EMA over (window size) |
| `adjusted` | boolean | No | Whether to use adjusted data for EMA calculation |
| `timespan` | string | Yes | Aggregate timespan for each data point, e.g., 'day' or 'minute' |
| `series_type` | string ("open" | "high" | "low" | "close") | No | Series type to use for the calculation |
| `expand_underlying` | boolean | No | Whether to include underlying aggregates used to calculate EMA |

#### 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 Simple Moving Average (SMA)

**Slug:** `POLYGON_GET_TECHNICAL_INDICATOR_SMA`

Tool to fetch Simple Moving Average (SMA) for a given stock ticker. Use when you need historical SMA data after confirming ticker, timespan, and window size.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return |
| `order` | string ("asc" | "desc") | No | Order of results |
| `ticker` | string | Yes | Stock ticker symbol to query, e.g., 'AAPL' |
| `window` | integer | Yes | Number of periods to calculate the SMA over (window size) |
| `adjusted` | boolean | No | Whether to use adjusted data |
| `timespan` | string | Yes | Aggregate timespan for each data point, e.g., 'day' or 'minute' |
| `series_type` | string ("open" | "high" | "low" | "close") | No | Series type to use for the calculation |
| `expand_underlying` | boolean | No | Whether to include underlying aggregates |

#### 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 Company Details

**Slug:** `POLYGON_GET_TICKER_COMPANY_DETAILS`

Tool to retrieve detailed company information for a stock ticker. Use when you need company fundamentals like CEO, industry, sector, market cap, and headquarters information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stocks_ticker` | string | Yes | The ticker symbol of the stock to retrieve company details for (e.g., '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 Ticker Details

**Slug:** `POLYGON_GET_TICKER_DETAILS`

Tool to retrieve detailed information for a ticker. Use when you need an overview of a ticker including company info, market data, and identifiers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Point-in-time reference date in YYYY-MM-DD format. Defaults to most recent. |
| `ticker` | string | Yes | The ticker symbol to look up (e.g., '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 Ticker Details (vX)

**Slug:** `POLYGON_GET_TICKER_DETAILS_VX`

Tool to retrieve comprehensive details for a specific ticker symbol using Polygon's vX API. Use when you need detailed information about a company including identifiers, market data, and corporate details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Specify a point in time to get information about the ticker available on that date in YYYY-MM-DD format. When retrieving information from SEC filings, this date is compared with the period of report date on the SEC filing. Defaults to the most recent available date. |
| `ticker` | string | Yes | The ticker symbol to retrieve details for (e.g., 'AAPL', 'TSLA'). Must be uppercase. |

#### 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 Events

**Slug:** `POLYGON_GET_TICKER_EVENTS`

Tool to retrieve corporate events for a specific ticker. Use when you need the timeline of corporate actions for a given ticker.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `types` | string | No | Comma-separated list of event types to include. Currently only 'ticker_change' is supported. Leave unset to return all types. |
| `ticker` | string | Yes | Ticker symbol (or CUSIP/FIGI) of the asset, e.g. '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 Ticker Types

**Slug:** `POLYGON_GET_TICKER_TYPES`

Tool to retrieve all ticker types supported by Polygon.io. Use after authenticating to explore ticker categories.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Filter by the ticker type code (e.g., 'CS' for common stock). |
| `limit` | integer | No | Maximum number of results to return (1–1000). |
| `offset` | integer | No | Number of items to skip for pagination (0-indexed). |
| `asset_class` | string ("stocks" | "options" | "crypto" | "fx") | No | Filter by asset class. One of 'stocks', 'options', 'crypto', 'fx'. |

#### 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 Treasury Yields

**Slug:** `POLYGON_GET_TREASURY_YIELDS`

Tool to retrieve historical U.S. Treasury yield data for standard timeframes from 1-month to 30-year maturities. Use when analyzing interest rates, yield curves, or economic indicators. Data available daily back to 1962.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Query by specific date in YYYY-MM-DD format. Returns yields for this exact date. |
| `sort` | string | No | Field to sort by. Use 'date' for ascending or '-date' for descending order. |
| `limit` | integer | No | Maximum number of results to return. Default is 100, maximum is 50000. |
| `date_gt` | string | No | Filter for dates greater than the specified date in YYYY-MM-DD format. |
| `date_lt` | string | No | Filter for dates less than the specified date in YYYY-MM-DD format. |
| `date_gte` | string | No | Filter for dates greater than or equal to the specified date in YYYY-MM-DD format. |
| `date_lte` | string | No | Filter for dates less than or equal to the specified date in YYYY-MM-DD format. |
| `date_any_of` | string | No | Filter for any of the specified dates. Comma-separated list 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 V1 Meta Crypto Exchanges

**Slug:** `POLYGON_GET_V1_META_CRYPTO_EXCHANGES`

Tool to retrieve a list of cryptocurrency exchanges using the legacy v1 API. Use when you need the complete list of crypto exchanges supported.

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

### Last Quote for a Symbol

**Slug:** `POLYGON_LAST_QUOTE_FOR_A_SYMBOL`

Tool to retrieve the last quote tick for a given stock symbol. Use when you need the most recent bid/ask prices, sizes, and exchange information for a stock.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Yes | Symbol of the stock to get the last quote for (e.g., AAPL, MSFT). Must be uppercase. |

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

### Last Trade for a Currency Pair

**Slug:** `POLYGON_LAST_TRADE_FOR_A_CURRENCY_PAIR`

Tool to retrieve the last trade tick for a currency pair in the forex market. Use when you need the most recent trade price, exchange, and timestamp for a specific currency pair.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to_currency` | string | Yes | The 'to' currency symbol (quote currency) in the pair (e.g., 'USD', 'JPY', 'EUR'). |
| `from_currency` | string | Yes | The 'from' currency symbol (base currency) in the pair (e.g., 'EUR', 'USD', 'GBP'). |

#### 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 SEC Filing Files

**Slug:** `POLYGON_LIST_FILING_FILES`

Tool to retrieve files associated with an SEC filing. Use when you need to list all files (documents, exhibits, etc.) attached to a specific SEC filing by its filing ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("sequence" | "filename") | No | Sort field for filing files |
| `limit` | integer | No | Limit the number of results returned (1-1000). Default is 10. |
| `order` | string ("asc" | "desc") | No | Order direction for results |
| `filename` | string | No | Query by file name. |
| `sequence` | integer | No | Query by file sequence number. |
| `filing_id` | string | Yes | The filing ID to retrieve files for (e.g., '0001300514-21-000058'). |
| `filename.gt` | string | No | Filter files with filename greater than this value (lexicographically). |
| `filename.lt` | string | No | Filter files with filename less than this value (lexicographically). |
| `sequence.gt` | integer | No | Filter files with sequence greater than this value. |
| `sequence.lt` | integer | No | Filter files with sequence less than this value. |
| `filename.gte` | string | No | Filter files with filename greater than or equal to this value (lexicographically). |
| `filename.lte` | string | No | Filter files with filename less than or equal to this value (lexicographically). |
| `sequence.gte` | integer | No | Filter files with sequence greater than or equal to this value. |
| `sequence.lte` | integer | No | Filter files with sequence less than or equal to this value. |

#### 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 Options Contracts

**Slug:** `POLYGON_LIST_OPTIONS_CONTRACTS`

Tool to list and filter options contracts by underlying ticker, type, expiration, strike, and more. Use when you need to enumerate an options chain or find specific contracts matching criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field name to sort by (e.g., 'expiration_date', 'strike_price', 'ticker'). |
| `as_of` | string | No | Specify a point in time for contracts as of this date (YYYY-MM-DD). Defaults to today. |
| `limit` | integer | No | Maximum number of results to return per page (1-1000). Defaults to 10. |
| `order` | string ("asc" | "desc") | No | Sort order direction: 'asc' (ascending) or 'desc' (descending). |
| `expired` | boolean | No | Query expired contracts. Set to true to include expired contracts. |
| `strike_price` | number | No | Filter by exact strike price value. |
| `contract_type` | string ("call" | "put") | No | Filter by contract type: 'call' or 'put'. |
| `expiration_date` | string | No | Filter by exact expiration date in YYYY-MM-DD format. |
| `strike_price_gt` | number | No | Filter for strike prices strictly greater than this value. |
| `strike_price_lt` | number | No | Filter for strike prices strictly less than this value. |
| `strike_price_gte` | number | No | Filter for strike prices greater than or equal to this value. |
| `strike_price_lte` | number | No | Filter for strike prices less than or equal to this value. |
| `underlying_ticker` | string | No | Query for contracts relating to an underlying stock ticker (e.g., 'AAPL', 'SPY'). |
| `expiration_date_gt` | string | No | Filter for expiration dates strictly greater than this date (YYYY-MM-DD). |
| `expiration_date_lt` | string | No | Filter for expiration dates strictly less than this date (YYYY-MM-DD). |
| `expiration_date_gte` | string | No | Filter for expiration dates greater than or equal to this date (YYYY-MM-DD). |
| `expiration_date_lte` | string | No | Filter for expiration dates less than or equal to this date (YYYY-MM-DD). |

#### 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 SEC Filings

**Slug:** `POLYGON_LIST_SEC_FILINGS`

Tool to retrieve SEC filings from Polygon. Use when you need to query 10-K or 10-Q filings by company, date range, or other criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("filing_date" | "period_of_report_date") | No | Sort field for ordering results. |
| `type` | string ("10-K" | "10-Q") | No | SEC filing types. |
| `limit` | integer | No | Limit the number of results returned (default 10, max 1000) |
| `order` | string ("asc" | "desc") | No | Sort order for results. |
| `has_xbrl` | boolean | No | If true, query only filings with XBRL. If false, query filings without XBRL. If omitted, query all. |
| `filing_date` | string | No | Query by filing date (YYYYMMDD format) |
| `filing_date.gt` | string | No | Filing date greater than (YYYYMMDD format) |
| `filing_date.lt` | string | No | Filing date less than (YYYYMMDD format) |
| `filing_date.gte` | string | No | Filing date greater than or equal to (YYYYMMDD format) |
| `filing_date.lte` | string | No | Filing date less than or equal to (YYYYMMDD format) |
| `period_of_report_date` | string | No | Query by period of report (YYYYMMDD format) |
| `period_of_report_date.gt` | string | No | Period of report date greater than (YYYYMMDD format) |
| `period_of_report_date.lt` | string | No | Period of report date less than (YYYYMMDD format) |
| `entities.company_data.cik` | string | No | Query by entity company CIK |
| `entities.company_data.sic` | string | No | Query by entity company SIC code |
| `period_of_report_date.gte` | string | No | Period of report date greater than or equal to (YYYYMMDD format) |
| `period_of_report_date.lte` | string | No | Period of report date less than or equal to (YYYYMMDD format) |
| `entities.company_data.name` | string | No | Query by entity company name |
| `entities.company_data.ticker` | string | No | Query by entity company ticker symbol |
| `entities.company_data.name.search` | string | No | Search by entities company name |

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