Polygon.io provides real-time and historical market data APIs for stocks, options, forex, and cryptocurrencies.
Polygon.io provides real-time and historical market data APIs for stocks, options, forex, and cryptocurrencies. On Nagent, Polygon is exposed as a fully-configurable analytics integration that any agent can call — 90 actions, and API key authentication. No code is required to wire Polygon into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Polygon to automate the kinds of tasks analytics teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Polygon into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Polygon, with input parameters and output schema. Drop these into any step of an agent built in Helix.
POLYGON_GET10_K_SECTIONSTool 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
Central Index Key (CIK) number. Supports comparison operators: .any_of, .gt, .gte, .lt, .lte
Comma-separated columns with .asc or .desc direction
Maximum number of results. Default: 100, Max: 9999
Stock ticker symbol. Supports comparison operators: .any_of, .gt, .gte, .lt, .lte
Standardized section identifier from the filing (e.g., 'business', 'risk_factors')
Period end date filter in YYYY-MM-DD format. Supports comparison operators: .gte, .gt, .lte, .lt
Filing date filter in YYYY-MM-DD format. Supports comparison operators: .gte, .gt, .lte, .lt
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_AGGREGATESTool 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
End of window; YYYY-MM-DD or millisecond timestamp
Sort by timestamp; 'asc' oldest-first, 'desc' newest-first
Start of window; YYYY-MM-DD or millisecond timestamp
Number of aggregates to return; default 5000, max 50000
Case-sensitive stock ticker (e.g., 'AAPL')
Adjust for splits; default true
Size of the time window
Size of the timespan multiplier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_ALL_TICKERSTool 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
Field to sort by (e.g., ticker, name, market).
Number of results per page (1-1000).
Sort order of results.
If true, only active tickers are returned.
Pagination cursor from prior response to fetch next page.
Filter by market type (e.g., stocks, crypto, fx, otc).
Search substring in company or ticker names.
Exact ticker symbol to search for (e.g., AAPL).
Filter by exchange symbol (e.g., XNAS, XNYS).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CONDITION_CODESTool 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
Filter by specific condition code ID, e.g., 'P'.
Field used to sort results, e.g., 'name', 'asset_class', 'id'.
Maximum number of results to return (server default: 10).
Order of results: 'asc' (ascending) or 'desc' (descending).
Filter by data type: 'trade' or 'quote'.
Filter by asset class, e.g., 'stocks', 'crypto', 'fx'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_AGGREGATESTool 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
Order by timestamp: 'asc' (oldest first) or 'desc' (newest first).
Maximum number of base aggregates to fetch (default: 5000, max: 50000).
End of the aggregate window; 'YYYY-MM-DD' or millisecond timestamp.
Whether results are adjusted for splits (default: true).
Time window unit for aggregation.
Start of the aggregate window; 'YYYY-MM-DD' or millisecond timestamp.
Size of the timespan multiplier (integer >= 1).
Ticker symbol of the cryptocurrency pair, e.g., 'BTC-USD'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_ALL_TICKERSTool to retrieve snapshots for all cryptocurrency tickers. Use when you need a full-market crypto snapshot of the latest values.
Input parameters
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_EMATool 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
Limit the number of results returned. Defaults to 10. Maximum is 5000.
The order in which to return the results, ordered by timestamp. Defaults to 'desc'.
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.
Whether or not the aggregates used to calculate the EMA are adjusted for splits. Defaults to True.
The size of the aggregate time window. Defaults to 'day'.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the exponential moving average. Defaults to 'close'.
Filter for timestamps greater than the specified value.
Filter for timestamps less than the specified value.
The cryptocurrency ticker symbol in the format X:BTCUSD, X:ETHBTC, etc. Must include the 'X:' prefix for cryptocurrency pairs.
Filter for timestamps greater than or equal to the specified value.
Filter for timestamps less than or equal to the specified value.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_GROUPED_DAILYTool 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
Date for which to retrieve daily grouped crypto bars in YYYY-MM-DD format
Whether results are adjusted for splits; default is true
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_LAST_TRADETool 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
Quote ('to') asset symbol of the crypto pair, e.g., 'USD'
Base ('from') asset symbol of the crypto pair, e.g., 'BTC'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_MACDTool 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
Limit the number of results returned. Must be between 1 and 5000. Defaults to 10.
Order of results by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'.
Whether or not the aggregates used to calculate the MACD are adjusted for splits. Defaults to True.
The size of the aggregate time window. Options: minute, hour, day, week, month, quarter, year. Defaults to 'day'.
Query by timestamp. Either a date with format YYYY-MM-DD or a millisecond timestamp.
The long window size (number of periods) used to calculate MACD data. Traditional value: 26.
The price in the aggregate which will be used to calculate MACD. Options: open, high, low, close. Defaults to 'close'.
The short window size (number of periods) used to calculate MACD data. Traditional value: 12.
The crypto ticker symbol in format X:FROMTO (e.g., 'X:BTCUSD', 'X:ETHUSD'). Must include the 'X:' prefix for cryptocurrency pairs.
The window size (number of periods) used to calculate the MACD signal line. Traditional value: 9.
Whether to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_OPEN_CLOSETool 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
Ticker symbol of the base currency (e.g., 'BTC')
Date for which to retrieve open/close prices, in YYYY-MM-DD format
Ticker symbol of the quote currency (e.g., 'USD')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_PREV_CLOSETool 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
Whether to return adjusted data
Cryptocurrency ticker symbol to query, e.g., 'X:BTCUSD'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_RSITool 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
Limit the number of results returned. Default: 5000. Max: 5000.
The order in which to return the results, ordered by timestamp. Defaults to 'desc'.
The window size used to calculate the relative strength index (RSI). Defaults to 14.
Whether or not the aggregates used to calculate the RSI are adjusted for splits. Defaults to True.
The size of the aggregate time window. Defaults to 'day'.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the relative strength index. Defaults to 'close'.
Filter for timestamps greater than the specified value.
Filter for timestamps less than the specified value.
The cryptocurrency ticker symbol in the format X:BTCUSD, X:ETHBTC, etc.
Filter for timestamps greater than or equal to the specified value.
Filter for timestamps less than or equal to the specified value.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_SMATool 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
Limit the number of base aggregates queried to create the aggregate results. Min: 1, Max: 50000. Defaults to 5000.
The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'.
The window size (number of periods) used to calculate the SMA. For example, 50 for a 50-period moving average.
Whether or not the aggregates used to calculate the SMA are adjusted for splits. Defaults to True.
The size of the aggregate time window. Options: minute, hour, day, week, month, quarter, year.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the SMA. Options: open, high, low, close. Defaults to 'close'.
Filter for timestamps greater than the specified value.
Filter for timestamps less than the specified value.
The cryptocurrency ticker symbol in the format X:BTCUSD, X:ETHUSD, etc. Must include the 'X:' prefix for cryptocurrency pairs.
Filter for timestamps greater than or equal to the specified value.
Filter for timestamps less than or equal to the specified value.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_TICKER_BOOKTool 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
Cryptocurrency ticker symbol. REST format is 'X:BASEQUOTE' (e.g., 'X:BTCUSD'). Common user format 'BTC-USD' is accepted and normalized.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_CRYPTO_TRADESTool to fetch historical trade data for a cryptocurrency ticker. Use when you need tick-level trades within a time range.
Input parameters
Field to sort by; must be 'timestamp'
Maximum number of trades to return (default: 1000, max: 50000)
Sort order: 'asc' or 'desc'
Filter by trade timestamp (YYYY-MM-DD or nanosecond Unix timestamp)
Return trades with timestamp greater than this value
Return trades with timestamp less than this value
Case-sensitive cryptocurrency ticker (e.g., 'BTC-USD')
Return trades with timestamp greater than or equal to this value
Return trades with timestamp less than or equal to this value
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_DIVIDENDSTool to retrieve dividend data for stocks. Use when you need corporate dividend information for specific tickers.
Input parameters
Number of records to skip (pagination)
Field to sort by (e.g., ex_dividend_date)
Limit number of results (1-1000)
Sort order (ascending or descending)
Filter by ticker symbol
Filter by payment date (YYYY-MM-DD)
Filter by dividend frequency
Filter by cash amount
Filter by record date (YYYY-MM-DD)
Filter by dividend type code
Filter by declaration date (YYYY-MM-DD)
Filter by ex-dividend date (YYYY-MM-DD)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_ECONOMY_INFLATIONTool 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
Calendar date of the observation in YYYY-MM-DD format. If not provided, returns recent observations.
Sort order for results. Use 'date.asc' for ascending or 'date.desc' for descending. Defaults to 'date.asc'.
Limit the maximum number of results returned. Defaults to 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_EMATool 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
Maximum number of results to return (1-5000). Defaults to 100.
Sort order for results. Defaults to 'desc'.
Number of periods to calculate the EMA (must be ≥1).
Whether to adjust results for splits/dividends. Defaults to True.
The timespan for each period (e.g., 'day', 'minute', 'hour').
Price series to use. Defaults to 'close'.
The stock ticker symbol.
Include underlying price data. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FILINGTool to retrieve SEC filing details by filing ID. Use when you need detailed information about a specific SEC filing.
Input parameters
The filing ID to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FILING_FILETool 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
The specific file identifier within the filing (e.g., 'lvs-20210331_htm.xml'). This identifies which file within the filing to retrieve.
The SEC filing identifier (e.g., '0001300514-21-000058'). This is the unique identifier for the filing document.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_AGGREGATESTool 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
End of the aggregate window as YYYY-MM-DD or millisecond timestamp.
Sort order by timestamp: 'asc' or 'desc'.
Start of the aggregate window as YYYY-MM-DD or millisecond timestamp.
Max number of base aggregates to query; default is 5000.
Whether results are adjusted for splits; default is true.
Size of the time window for each aggregate bar.
Size of the timespan multiplier, must be >= 1.
Ticker symbol of the currency pair, e.g., 'EURUSD'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_EMATool 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
Limit the number of results returned. Defaults to 10. Maximum is 5000.
The order in which to return the results, ordered by timestamp. 'asc' for ascending/oldest first, 'desc' for descending/newest first. Defaults to 'desc'.
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.
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.
The size of the aggregate time window. Defaults to 'day'.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the exponential moving average. Defaults to 'close'.
The forex ticker symbol in format C:FROMTO (e.g., 'C:EURUSD', 'C:GBPJPY'). Must include the 'C:' prefix for forex currency pairs.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_GROUPED_DAILYTool 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
Date for which to retrieve daily aggregated forex bars in YYYY-MM-DD format
Whether to retrieve adjusted data (default: true).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_HISTORICAL_QUOTESTool 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
Field to sort by. Must be 'timestamp'.
Max number of results (default 1000, max 50000).
Order of results by the sort field (asc or desc).
The forex currency pair ticker to retrieve quotes for (e.g., 'EURUSD').
Filter by date (YYYY-MM-DD) or nanosecond timestamp.
Return quotes with timestamp greater than this value.
Return quotes with timestamp less than this value.
Return quotes with timestamp greater than or equal to this value.
Return quotes with timestamp less than or equal to this value.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_LOCALESTool 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
Optional asset class filter. Common values include 'fx', 'stocks', 'options', 'crypto'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_MACDTool 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
Maximum number of results to return. Must be between 1 and 5000. Defaults to 10.
The order in which to return results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'.
Whether the aggregates used to calculate MACD are adjusted for splits. Defaults to True.
The size of the aggregate time window (e.g., 'day', 'hour', 'minute').
Filter by timestamp. Can be a date in YYYY-MM-DD format or a millisecond timestamp.
The long window size (number of periods) used to calculate MACD data. Typically 26.
The price field in the aggregate which will be used to calculate MACD. Defaults to 'close'.
The forex ticker symbol in format C:FROMTO (e.g., 'C:EURUSD', 'C:GBPJPY'). Must include the 'C:' prefix for forex currency pairs.
The short window size (number of periods) used to calculate MACD data. Typically 12.
Range filter - only include results where timestamp is greater than this value. Format: YYYY-MM-DD or millisecond timestamp.
Range filter - only include results where timestamp is less than this value. Format: YYYY-MM-DD or millisecond timestamp.
The window size (number of periods) used to calculate the MACD signal line. Typically 9.
Range filter - only include results where timestamp is greater than or equal to this value. Format: YYYY-MM-DD or millisecond timestamp.
Range filter - only include results where timestamp is less than or equal to this value. Format: YYYY-MM-DD or millisecond timestamp.
Whether to include the underlying aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_PREV_CLOSETool 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
Whether to return adjusted data
Forex currency pair ticker symbol to query, e.g., 'EURUSD'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_REAL_TIME_CURRENCY_CONVERSIONTool 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
The amount to convert with decimal precision. If not provided, defaults to 1.
The decimal precision of the conversion result. Defaults to 2 decimal places.
The 'to' currency symbol to convert to (e.g., 'EUR', 'USD', 'JPY').
The 'from' currency symbol to convert from (e.g., 'USD', 'EUR', 'GBP').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_RSITool 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
Limit the number of results returned. Default: 5000. Max: 5000.
The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'.
The window size used to calculate the Relative Strength Index (RSI). Typically 14 for standard RSI calculation.
Whether or not the aggregates used to calculate the RSI are adjusted for splits. Defaults to True.
The size of the aggregate time window. Required parameter to define the period for RSI calculation.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the RSI. Defaults to 'close'.
The forex ticker symbol in format C:FROMTO (e.g., 'C:EURUSD', 'C:GBPJPY'). Must include the 'C:' prefix for forex currency pairs.
Filter for timestamps greater than the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps less than the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps greater than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps less than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_SMATool 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
Limit the number of results returned. Defaults to 10. Maximum is 5000.
The order in which to return the results, ordered by timestamp. 'asc' for ascending/oldest first, 'desc' for descending/newest first. Defaults to 'desc'.
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.
Whether or not the aggregates used to calculate the SMA are adjusted for splits. Defaults to True.
The size of the aggregate time window. Defaults to 'day'.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the SMA. Defaults to 'close'.
The forex ticker symbol in format C:FROMTO (e.g., 'C:EURUSD', 'C:GBPJPY'). Must include the 'C:' prefix for forex currency pairs.
Filter for timestamps greater than the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps less than the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps greater than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps less than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FOREX_SNAPSHOT_LOSERSTool 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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FUTURES_AGGREGATESTool 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
Field and direction for sorting, e.g., 'window_start.asc', 'ticker.desc'
Number of aggregates to return; default 1000, min 1, max 50000
Futures contract identifier, e.g., 'GCJ5'
Aggregate window size, e.g., '15min', '30sec', '12hour', '7day'
Start edge of windows (inclusive), e.g., '2024-01-01' or millisecond timestamp
End edge of windows (inclusive), e.g., '2024-01-31' or millisecond timestamp
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FUTURES_PRODUCTSTool 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
Exact product name match, case-sensitive search
Sort specifier in the form 'field.direction', e.g., 'ticker.asc'
Filter by product type: 'all', 'single', or 'combo'
Point-in-time date in YYYY-MM-DD format (default: today)
Number of results per page (1-1000)
Product sector classification
Product sub-sector classification
Top-level asset class
Case-sensitive partial match on product name; maps to `name.search`
Exchange MIC code to filter results
Asset sub-class classification
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FUTURES_PRODUCT_SCHEDULESTool to retrieve trading schedules for a futures product. Use when you need daily trading session schedules for a given product code.
Input parameters
Sort by field and direction, e.g., 'ticker.asc' or 'name.desc'.
Results per page (1-1000). Defaults to 100.
Futures product code (e.g., 'ES').
Trading day that the schedule ended (YYYY-MM-DD, Central Time).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FUTURES_QUOTESTool 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
Sort by field and direction using dotted notation (e.g., 'ticker.asc', 'name.desc')
Results per page; default is 1000; min 1; max 50000
Futures contract identifier including base symbol and expiration (e.g., 'GCJ5')
Filter by trade timestamp; either YYYY-MM-DD or a nanosecond timestamp
Trading session end date in YYYY-MM-DD format
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FUTURES_SCHEDULESTool to retrieve futures trading schedules. Use when you need trading schedules for all futures contracts on a specific date.
Input parameters
Sort by field.direction, e.g., 'product_code.asc' or 'product_name.desc'
Number of results per page (1-1000). Default is 100.
Exchange MIC to filter schedules, e.g., 'CME'
Trading date to query (YYYY-MM-DD, CT). Defaults to today in CT if omitted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_FUTURES_TRADESTool to retrieve tick-level trade data for a specified futures contract. Use when you need detailed trade data over a time range.
Input parameters
Sort field and direction in 'field.direction' format, e.g., 'timestamp.asc'.
Maximum number of trades to return; default 1000, max 50000.
Futures contract identifier including base symbol and expiration (e.g., 'GCJ5')
Filter by timestamp; YYYY-MM-DD or Unix nanosecond timestamp.
Return trades with timestamp greater than this value.
Return trades with timestamp less than this value.
Return trades with timestamp greater than or equal to this value.
Return trades with timestamp less than or equal to this value.
Trading date filter in YYYY-MM-DD; supports filter modifiers via alias fields.
Return trades with session_end_date greater than this value.
Return trades with session_end_date less than this value.
Return trades with session_end_date greater than or equal to this value.
Return trades with session_end_date less than or equal to this value.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_HISTORIC_FOREX_TICKSTool 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
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').
Controls response size; defaults to 100, maximum of 10,000 entries.
Pagination mechanism using timestamp offset to fetch the next set of results.
The 'to' currency symbol (quote currency) in the pair (e.g., 'JPY', 'USD', 'EUR').
The 'from' currency symbol (base currency) in the pair (e.g., 'USD', 'EUR', 'GBP').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_INFLATION_EXPECTATIONSTool 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
Calendar date in YYYY-MM-DD format for a specific observation
Sort order for results. Use 'date.asc' for ascending or 'date.desc' for descending
Maximum number of results to return. Defaults to 100, max 50,000
Date comparison filter - observations after this date (YYYY-MM-DD format)
Date comparison filter - observations before this date (YYYY-MM-DD format)
Date comparison filter - observations on or after this date (YYYY-MM-DD format)
Date comparison filter - observations on or before this date (YYYY-MM-DD format)
Date comparison filter - any of the specified dates (comma-separated)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_IPO_DATATool 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
Filter by ISIN (International Securities Identification Number).
Field to sort by (e.g., 'listing_date', 'ticker'). Default: 'listing_date'.
Limit the number of results returned (1-1000). Default: 10, Max: 1000.
Sort order direction: 'asc' for ascending or 'desc' for descending. Default: 'desc'.
Filter by ticker symbol.
Filter by US code (ISIN identifier).
Filter by exact listing date (format: YYYY-MM-DD).
Filter for IPOs listed on or after this date (format: YYYY-MM-DD).
Filter for IPOs listed on or before this date (format: YYYY-MM-DD).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_MACDTool 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
Maximum number of results to return (1-5000). Defaults to 10.
The order of results by timestamp. Defaults to 'desc'.
Whether to use split-adjusted aggregates. Defaults to True.
The size of the aggregate time window (e.g., 'day').
Filter by timestamp (YYYY-MM-DD or millisecond timestamp).
The number of periods for the long EMA window (e.g., 26).
The price field to use for calculations. Defaults to 'close'.
The number of periods for the short EMA window (e.g., 12).
The case-sensitive ticker symbol for which to get MACD data (e.g., 'AAPL').
The number of periods for the signal line EMA window (e.g., 9).
Whether to include the underlying aggregates data. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_MARKET_HOLIDAYSTool to retrieve upcoming market holidays and half-day closures. Use when you need to look up upcoming exchange holidays and early closures.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_MARKET_STATUSTool to retrieve current market status. Use when you need to know if U.S. exchanges are open, closed, or on holiday.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_META_CONDITIONS_BY_TICKTYPETool 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
The type of ticks to return mappings for. Must be either 'trades' or 'quotes'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_NEWSTool to retrieve recent news articles related to a ticker. Use when you need to fetch financial news after identifying a ticker symbol.
Input parameters
Field to sort by (only 'published_utc' supported)
Number of results to return (1–100)
Sort order of results
Pagination token for the next page of results
Ticker symbol to filter news (e.g., 'AAPL')
Return articles published on or after this ISO 8601 timestamp
Return articles published on or before this ISO 8601 timestamp
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPEN_CLOSETool 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
Date for which to retrieve open/close prices, in YYYY-MM-DD format
Whether results are adjusted for splits. Set to false for unadjusted.
Ticker symbol of the stock (e.g., 'AAPL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPTION_CHAIN_SNAPSHOTTool 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
Field to sort by
Maximum number of results (default=10, max=250)
Sort direction for results
Filter by strike price; supports filter modifiers (>, <, etc.)
Option contract type
Filter by expiration date in YYYY-MM-DD format; supports modifiers
Underlying ticker symbol for the option chain snapshot (e.g., 'AAPL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPTIONS_CONTRACT_OVERVIEWTool 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
Specify a point in time for the contract as of this date. Format: YYYY-MM-DD. Defaults to today's date.
The options contract identifier following standard options ticker format (e.g., O:SPY241220C00450000, O:AAPL251219C00010000).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPTIONS_CUSTOM_BARSTool 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
Sort results by timestamp. 'asc' for ascending (oldest first), 'desc' for descending (newest first).
Limits the number of base aggregates queried. Maximum: 50000, Default: 5000.
The end of the aggregate time window. Can be in YYYY-MM-DD format or Unix millisecond timestamp.
Whether results are adjusted for splits. Set to false to get results that are NOT adjusted for splits. Defaults to true.
The size of the time window for each aggregate bar.
The start of the aggregate time window. Can be in YYYY-MM-DD format or Unix millisecond timestamp.
The size of the timespan multiplier. Must be a positive integer. Used to customize the time window size.
The ticker symbol of the options contract (e.g., 'O:AAPL251219C00250000', 'O:SPY241220P00720000'). Must follow standard options ticker format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPTIONS_EMATool 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
Limit the number of results returned. Must be between 1 and 5000. Defaults to 10.
The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'.
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.
Whether or not the aggregates used to calculate the EMA are adjusted for splits. Defaults to True.
The size of the aggregate time window. Options: minute, hour, day, week, month, quarter, year. Required parameter.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the exponential moving average. Defaults to 'close'.
Filter for timestamps greater than the specified value.
Filter for timestamps less than the specified value.
Filter for timestamps greater than or equal to the specified value.
Filter for timestamps less than or equal to the specified value.
The options ticker symbol in format O:UNDERLYINGYYMMDDCOOOOOOOOO (e.g., 'O:AAPL250117C00250000'). Must include the 'O:' prefix for options contracts.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPTIONS_MACDTool 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
Limit the number of results returned. Must be between 1 and 5000. Defaults to 10.
Order of results by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'.
Whether or not the aggregates used to calculate the MACD are adjusted for splits. Defaults to True.
The size of the aggregate time window. Options: minute, hour, day, week, month, quarter, year. Required parameter.
Query by timestamp. Either a date with format YYYY-MM-DD or a millisecond timestamp. Required parameter.
The long window size (number of periods) used to calculate MACD data. Traditional value: 26. Required parameter.
The price in the aggregate which will be used to calculate MACD. Options: open, high, low, close. Defaults to 'close'.
The short window size (number of periods) used to calculate MACD data. Traditional value: 12. Required parameter.
The window size (number of periods) used to calculate the MACD signal line. Traditional value: 9. Required parameter.
The options ticker symbol in format O:UNDERLYINGYYMMDDCOOOOOOOOO (e.g., 'O:AAPL251219C00150000'). Must include the 'O:' prefix for options contracts.
Whether to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPTION_SNAPSHOTTool 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
Option contract identifier (e.g., 'AAPL210917C00145000')
Underlying ticker symbol of the option contract (e.g., 'AAPL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPTIONS_RSITool 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
Limit the number of base aggregates queried to create the aggregate results. Default: 5000. Max: 50000.
The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'.
The window size used to calculate the Relative Strength Index (RSI). Typically 14 for standard RSI calculation. Defaults to 14.
Whether or not the aggregates used to calculate the RSI are adjusted for splits. Defaults to True.
The size of the aggregate time window. Required parameter to define the period for RSI calculation.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the RSI. Defaults to 'close'.
Filter for timestamps greater than the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps less than the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps greater than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps less than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp.
The options ticker symbol in format O:UNDERLYINGYYMMDDCOOOOOOOOO (e.g., 'O:AAPL250117C00250000'). Must include the 'O:' prefix for options contracts.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_OPTIONS_SMATool 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
Limit the number of results returned. Must be between 1 and 5000. Defaults to 10.
The order in which to return the results, ordered by timestamp. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'asc'.
Cursor value for pagination to fetch the next page of data.
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.
Whether or not the aggregates used to calculate the SMA are adjusted for splits. Defaults to True.
The size of the aggregate time window. Required parameter to define the period for SMA calculation.
Query by timestamp. Either a date with the format YYYY-MM-DD or a millisecond timestamp.
The price in the aggregate which will be used to calculate the SMA. Defaults to 'close'.
Filter for timestamps greater than the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps less than the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps greater than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp.
Filter for timestamps less than or equal to the specified value. Format: YYYY-MM-DD or millisecond timestamp.
The options ticker symbol in format O:UNDERLYINGYYMMDDCOOOOOOOOO (e.g., 'O:SPY241220C00580000'). Must include the 'O:' prefix for options contracts.
Whether or not to include the aggregates used to calculate this indicator in the response. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_PREVIOUS_CLOSETool 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
Case-sensitive stock ticker symbol to query, e.g., 'AAPL'
Whether to return adjusted data for splits; default is True
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_REFERENCE_EXCHANGESTool to retrieve supported exchanges and their details. Use when you need a list of exchanges filtered by asset class or locale.
Input parameters
Filter by locale (e.g., 'us').
Filter by asset class. One of 'stocks', 'options', 'crypto', 'fx'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_REFERENCE_MARKETSTool to retrieve all supported markets from Polygon.io. Use when you need a list of available market types.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_REFERENCE_TYPESTool 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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_RELATED_COMPANIESTool 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
The ticker symbol to search for related companies (e.g., 'AAPL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_RISK_CATEGORIESTool 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
Comma-separated columns with .asc or .desc direction (e.g., 'taxonomy.asc,primary_category.desc')
Maximum number of results to return (default: 200, max: 999)
Version identifier for the taxonomy (e.g., 1.0, 1.1)
Filter taxonomy versions greater than this value
Filter taxonomy versions less than this value
Filter taxonomy versions greater than or equal to this value
Filter taxonomy versions less than or equal to this value
Filter by top-level risk category
Filter by most specific risk classification
Filter by mid-level risk category
Filter primary categories greater than this value
Filter primary categories less than this value
Filter primary categories greater than or equal to this value
Filter primary categories less than or equal to this value
Filter tertiary categories greater than this value
Filter tertiary categories less than this value
Filter secondary categories greater than this value
Filter secondary categories less than this value
Filter tertiary categories greater than or equal to this value
Filter tertiary categories less than or equal to this value
Filter secondary categories greater than or equal to this value
Filter secondary categories less than or equal to this value
Comma-separated list of primary categories to match any of
Comma-separated list of tertiary categories to match any of
Comma-separated list of secondary categories to match any of
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_RSITool 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
Maximum number of results to return (1-5000). Defaults to 5000.
Sort order of results. Defaults to 'desc'.
Lookback window for RSI calculation (must be 1). Defaults to 14.
Whether to use adjusted values (splits/dividends). Defaults to True.
The size of the time window (e.g., 'day', 'minute', 'hour').
Return results before this timestamp (ms since epoch).
Price field to use for calculation. Defaults to 'close'.
The stock ticker symbol (e.g., 'AAPL').
Return results after this timestamp (ms since epoch).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_SHORT_INTERESTTool 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
Comma-separated list of sort columns. Append '.asc' or '.desc' to each column for sort direction. Defaults to 'ticker' if not specified.
Maximum number of results to return. Defaults to 10, maximum is 50000.
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).
Filter by days to cover (short_interest / avg_daily_volume). Supports filter modifiers: .gt, .gte, .lt, .lte.
Filter by settlement date in YYYY-MM-DD format. Supports filter modifiers: .gt, .gte, .lt, .lte for date range queries.
Filter by average daily trading volume. Supports filter modifiers: .gt, .gte, .lt, .lte.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_SHORT_VOLUMETool to retrieve short volume data for stocks. Use when analyzing short selling activity, market sentiment, or detecting abnormal short-selling patterns.
Input parameters
Filter by date in YYYY-MM-DD format. Supports comparison operators (.gt, .gte, .lt, .lte) and .any_of for multiple values
Sort order for results. Comma-separated columns with .asc/.desc direction (e.g., 'ticker.asc', 'date.desc'). Default: ticker.asc
Limit the number of results (1-50000). Default: 10, Maximum: 50000
Filter by stock ticker symbol. Supports comparison operators (.gt, .gte, .lt, .lte) and .any_of for multiple values
Filter by total volume. Supports comparison operators (.gt, .gte, .lt, .lte) and .any_of
Filter by short volume ratio (percentage of total trading volume sold short). Supports comparison operators (.gt, .gte, .lt, .lte) and .any_of
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_SMATool 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
Maximum number of results to return (1-1000). Defaults to 250.
Sort order for results. Defaults to 'desc'.
Number of periods to calculate the SMA (must be ≥1).
Whether to adjust results for splits/dividends. Defaults to True.
The timespan for each period (e.g., 'minute', 'hour', 'day').
The ticker symbol. Use 'C:EURUSD' for forex, 'AAPL' for stocks, 'X:BTCUSD' for crypto.
Millisecond UNIX timestamp to anchor the indicator. Defaults to most recent.
Price series to use. Defaults to 'close'.
Include underlying aggregate data. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_SNAPSHOT_ALL_TICKERSTool 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
Case-sensitive list of stock ticker symbols (e.g., \['AAPL','TSLA','GOOG'\]). If omitted or empty, returns snapshots for all tickers.
Whether to include over-the-counter (OTC) securities in the snapshot.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_SNAPSHOT_LOSERSTool 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
Whether to include OTC securities; default false
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_SNAPSHOT_SINGLE_TICKERTool 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
Case-sensitive stock ticker symbol (e.g., 'AAPL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_SPLITSTool 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
Field to sort results by (default: 'execution_date')
Maximum number of results to return (1-1000)
Sort order: 'asc' or 'desc' (default: 'desc')
Stock ticker symbol to query splits for, e.g., 'AAPL'
Filter splits executed on or after this date (YYYY-MM-DD)
Filter splits executed on or before this date (YYYY-MM-DD)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_STOCK_FINANCIALSTool 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
Sort order for financial results.
Report type for financial data.
Limit the number of results returned (1-5000)
The stock ticker symbol to retrieve financials for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_STOCK_FLOATTool 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
Comma-separated sort columns with '.asc'/'.desc' directives (e.g., 'ticker.asc')
Maximum results returned (default: 100, max: 5000)
Primary ticker symbol for the stock
Filter for ticker greater than specified value
Filter for ticker less than specified value
Filter for ticker greater than or equal to specified value
Filter for ticker less than or equal to specified value
Filter equal to any of the values. Multiple values can be specified by using a comma separated list
Percentage of total shares outstanding that are available for public trading, rounded to two decimal places
Filter for free float percentage greater than specified value
Filter for free float percentage less than specified value
Filter for free float percentage greater than or equal to specified value
Filter for free float percentage less than or equal to specified value
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_STOCKS_BALANCE_SHEETSTool 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
The company's Central Index Key (CIK), a unique identifier assigned by the SEC
Query by Standard Industrial Classification (SIC) code
The sort field used for ordering. Default: 'filing_date'
Limit the number of results returned (1-100). Default: 10
Order results based on the sort field. Default: 'asc'
Query by company ticker symbol, e.g., 'AAPL'
The timeframe of the report. Annual financials originate from 10-K filings, quarterly from 10-Q filings
Query by the date when the filing was filed (YYYY-MM-DD format)
Query by exact company name
Filing date greater than (YYYY-MM-DD)
Filing date less than (YYYY-MM-DD)
Filing date greater than or equal (YYYY-MM-DD)
Filing date less than or equal (YYYY-MM-DD)
Whether to include the xpath and formula attributes for each financial data point for traceability
Search by partial company name
The period of report for the filing (YYYY-MM-DD format)
Period of report date greater than (YYYY-MM-DD)
Period of report date less than (YYYY-MM-DD)
Period of report date greater than or equal (YYYY-MM-DD)
Period of report date less than or equal (YYYY-MM-DD)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_STOCKS_CASH_FLOW_STATEMENTSTool 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
The company's Central Index Key (CIK), a unique identifier assigned by the SEC
Query by Standard Industrial Classification (SIC) code
The sort field used for ordering. Default: 'filing_date'
Limit the number of results returned (1-100). Default: 10
Order results based on the sort field. Default: 'asc'
Query by company ticker symbol, e.g., 'AAPL'
The timeframe of the report. Annual financials originate from 10-K filings, quarterly from 10-Q filings, TTM is trailing twelve months
Query by the date when the filing was filed (YYYY-MM-DD format)
Query by exact company name
Filing date greater than (YYYY-MM-DD)
Filing date less than (YYYY-MM-DD)
Filing date greater than or equal (YYYY-MM-DD)
Filing date less than or equal (YYYY-MM-DD)
Whether to include the xpath and formula attributes for each financial data point for traceability
Search by partial company name
The period of report for the filing (YYYY-MM-DD format)
Period of report date greater than (YYYY-MM-DD)
Period of report date less than (YYYY-MM-DD)
Period of report date greater than or equal (YYYY-MM-DD)
Period of report date less than or equal (YYYY-MM-DD)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_STOCKS_CUSTOM_BARSTool 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
Sort results by timestamp. 'asc' for ascending (oldest first), 'desc' for descending (newest first).
Limits the number of base aggregates queried. Maximum: 50000, Default: 5000.
The end of the aggregate time window. Can be in YYYY-MM-DD format or Unix millisecond timestamp.
Whether results are adjusted for splits. Set to false to get results that are NOT adjusted for splits. Defaults to true.
The size of the time window for each aggregate bar.
The start of the aggregate time window. Can be in YYYY-MM-DD format or Unix millisecond timestamp.
The size of the timespan multiplier. Must be a positive integer. Used to customize the time window size.
The ticker symbol of the stock/equity (e.g., 'AAPL', 'TSLA', 'MSFT'). Must be a valid stock ticker.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_STOCKS_DAILY_MARKET_SUMMARYTool 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
The date to get aggregate bars for in YYYY-MM-DD format (e.g., '2024-12-13')
Whether results are adjusted for splits. Set to false for unadjusted results. Defaults to true.
Include OTC (Over-The-Counter) securities in response. Defaults to false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_STOCK_SPLITS_BY_TICKERTool 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
The ticker symbol of the stock (e.g., 'AAPL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_TECHNICAL_INDICATOR_EMADEPRECATED: 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
Maximum number of results to return
Order of results
Stock ticker symbol to query, e.g., 'AAPL'
Number of periods to calculate the EMA over (window size)
Whether to use adjusted data for EMA calculation
Aggregate timespan for each data point, e.g., 'day' or 'minute'
Series type to use for the calculation
Whether to include underlying aggregates used to calculate EMA
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_TECHNICAL_INDICATOR_SMATool 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
Maximum number of results to return
Order of results
Stock ticker symbol to query, e.g., 'AAPL'
Number of periods to calculate the SMA over (window size)
Whether to use adjusted data
Aggregate timespan for each data point, e.g., 'day' or 'minute'
Series type to use for the calculation
Whether to include underlying aggregates
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_TICKER_COMPANY_DETAILSTool 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
The ticker symbol of the stock to retrieve company details for (e.g., 'AAPL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_TICKER_DETAILSTool 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
Point-in-time reference date in YYYY-MM-DD format. Defaults to most recent.
The ticker symbol to look up (e.g., 'AAPL')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_TICKER_DETAILS_VXTool 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
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.
The ticker symbol to retrieve details for (e.g., 'AAPL', 'TSLA'). Must be uppercase.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_TICKER_EVENTSTool to retrieve corporate events for a specific ticker. Use when you need the timeline of corporate actions for a given ticker.
Input parameters
Comma-separated list of event types to include. Currently only 'ticker_change' is supported. Leave unset to return all types.
Ticker symbol (or CUSIP/FIGI) of the asset, e.g. 'AAPL'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_TICKER_TYPESTool to retrieve all ticker types supported by Polygon.io. Use after authenticating to explore ticker categories.
Input parameters
Filter by the ticker type code (e.g., 'CS' for common stock).
Maximum number of results to return (1–1000).
Number of items to skip for pagination (0-indexed).
Filter by asset class. One of 'stocks', 'options', 'crypto', 'fx'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_TREASURY_YIELDSTool 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
Query by specific date in YYYY-MM-DD format. Returns yields for this exact date.
Field to sort by. Use 'date' for ascending or '-date' for descending order.
Maximum number of results to return. Default is 100, maximum is 50000.
Filter for dates greater than the specified date in YYYY-MM-DD format.
Filter for dates less than the specified date in YYYY-MM-DD format.
Filter for dates greater than or equal to the specified date in YYYY-MM-DD format.
Filter for dates less than or equal to the specified date in YYYY-MM-DD format.
Filter for any of the specified dates. Comma-separated list in YYYY-MM-DD format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_GET_V1_META_CRYPTO_EXCHANGESTool to retrieve a list of cryptocurrency exchanges using the legacy v1 API. Use when you need the complete list of crypto exchanges supported.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_LAST_QUOTE_FOR_A_SYMBOLTool 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
Symbol of the stock to get the last quote for (e.g., AAPL, MSFT). Must be uppercase.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_LAST_TRADE_FOR_A_CURRENCY_PAIRTool 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
The 'to' currency symbol (quote currency) in the pair (e.g., 'USD', 'JPY', 'EUR').
The 'from' currency symbol (base currency) in the pair (e.g., 'EUR', 'USD', 'GBP').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_LIST_FILING_FILESTool 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
Sort field for filing files
Limit the number of results returned (1-1000). Default is 10.
Order direction for results
Query by file name.
Query by file sequence number.
The filing ID to retrieve files for (e.g., '0001300514-21-000058').
Filter files with filename greater than this value (lexicographically).
Filter files with filename less than this value (lexicographically).
Filter files with sequence greater than this value.
Filter files with sequence less than this value.
Filter files with filename greater than or equal to this value (lexicographically).
Filter files with filename less than or equal to this value (lexicographically).
Filter files with sequence greater than or equal to this value.
Filter files with sequence less than or equal to this value.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_LIST_OPTIONS_CONTRACTSTool 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
Field name to sort by (e.g., 'expiration_date', 'strike_price', 'ticker').
Specify a point in time for contracts as of this date (YYYY-MM-DD). Defaults to today.
Maximum number of results to return per page (1-1000). Defaults to 10.
Sort order direction: 'asc' (ascending) or 'desc' (descending).
Query expired contracts. Set to true to include expired contracts.
Filter by exact strike price value.
Filter by contract type: 'call' or 'put'.
Filter by exact expiration date in YYYY-MM-DD format.
Filter for strike prices strictly greater than this value.
Filter for strike prices strictly less than this value.
Filter for strike prices greater than or equal to this value.
Filter for strike prices less than or equal to this value.
Query for contracts relating to an underlying stock ticker (e.g., 'AAPL', 'SPY').
Filter for expiration dates strictly greater than this date (YYYY-MM-DD).
Filter for expiration dates strictly less than this date (YYYY-MM-DD).
Filter for expiration dates greater than or equal to this date (YYYY-MM-DD).
Filter for expiration dates less than or equal to this date (YYYY-MM-DD).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
POLYGON_LIST_SEC_FILINGSTool 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
Sort field for ordering results.
SEC filing types.
Limit the number of results returned (default 10, max 1000)
Sort order for results.
If true, query only filings with XBRL. If false, query filings without XBRL. If omitted, query all.
Query by filing date (YYYYMMDD format)
Filing date greater than (YYYYMMDD format)
Filing date less than (YYYYMMDD format)
Filing date greater than or equal to (YYYYMMDD format)
Filing date less than or equal to (YYYYMMDD format)
Query by period of report (YYYYMMDD format)
Period of report date greater than (YYYYMMDD format)
Period of report date less than (YYYYMMDD format)
Query by entity company CIK
Query by entity company SIC code
Period of report date greater than or equal to (YYYYMMDD format)
Period of report date less than or equal to (YYYYMMDD format)
Query by entity company name
Query by entity company ticker symbol
Search by entities company name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 88 agents privately built on Nagent that already use Polygon.
Build on Nagent
Connect Polygon to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Polygon, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Polygon is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Polygon is connected, you configure its 90 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Polygon steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Polygon event fires, the agent kicks off automatically.
Every Polygon action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Polygon ships with 90 pre-built analytics actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Polygon together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Polygon-based workflows tailored to your business.