Marketstack connects to a Nagent workspace with an API key. Once it is connected, agents can call 10 Marketstack actions, such as "Get Dividends", "Get End-of-Day Data" and "Get Exchange Info". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Marketstack, with input parameters and output schema.
MARKETSTACK_GET_DIVIDENDSTool to retrieve stock dividend data for one or more ticker symbols from Marketstack API. Use when you need historical dividend payment information for stocks, including dividend amounts and payment dates.
Input parameters
Sort order for dividend results.
Pagination limit - number of results per page. Default 100, maximum 1000. Use to control how many dividend records are returned.
Pagination offset - number of results to skip. Default 0. Use with limit to paginate through large result sets.
Filter results up to this date (inclusive). Format YYYY-MM-DD. Use to get dividends up to a specific date.
One or more comma-separated ticker symbols (e.g., 'AAPL' or 'AAPL,MSFT'). Required to specify which stocks to retrieve dividend data for.
Filter results from this date (inclusive). Format YYYY-MM-DD. Use to get dividends starting from a specific date.
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
MARKETSTACK_GET_EODTool to retrieve end-of-day (EOD) stock data for one or multiple ticker symbols. Returns OHLCV data (open, high, low, close, volume) along with adjusted prices, dividends, and split factors. Use when you need historical daily stock prices or market data analysis.
Input parameters
Sort order for EOD data results.
Maximum number of results to return per page. Default is 100, maximum is 1000.
Number of results to skip for pagination. Default is 0. Use with limit to paginate through large result sets.
End date for filtering results (inclusive). Use YYYY-MM-DD format (e.g., '2024-12-31').
One or more comma-separated ticker symbols to retrieve data for (e.g., 'AAPL' or 'AAPL,MSFT,GOOGL').
Filter results by stock exchange MIC code (e.g., 'XNAS' for NASDAQ). Only returns data from the specified exchange.
Start date for filtering results (inclusive). Use YYYY-MM-DD format (e.g., '2024-01-01').
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
MARKETSTACK_GET_EXCHANGETool to retrieve detailed information for a specific stock exchange by its MIC (Market Identifier Code). Use when you need comprehensive information about an exchange including its location, status, and operational details.
Input parameters
Exchange MIC (Market Identifier Code) identifier, e.g., 'XNAS' for NASDAQ.
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
MARKETSTACK_GET_SPLITSTool to retrieve stock split data for one or more stock symbols from Marketstack. Use when you need historical split information including split factors and dates.
Input parameters
Sort order for splits data.
Pagination limit (results per page). Default 100, maximum 1000.
Pagination offset (number of results to skip). Default 0.
Filter results up to this date (inclusive). Format `YYYY-MM-DD`.
One or more comma-separated ticker symbols (e.g., `AAPL` or `AAPL,MSFT`).
Filter results from this date (inclusive). 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
MARKETSTACK_GET_TICKER_EODTool to retrieve end-of-day stock price data for a specific ticker symbol. Use when you need historical daily price information including open, high, low, close, volume, and adjusted values.
Input parameters
Number of results to return per page. Default is 100, maximum is 1000
Number of results to skip for pagination. Default is 0
Ticker symbol to look up (e.g., AAPL, MSFT, TSLA)
Filter results by a specific stock exchange using the MIC identification code (e.g., XNAS for NASDAQ)
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
MARKETSTACK_GET_TICKER_EOD_LATESTTool to retrieve end-of-day (EOD) stock data for the latest available date for a specific ticker. Use when you need the most recent trading day data for a stock symbol.
Input parameters
Pagination limit (results per page). Default 100, maximum 1000.
Pagination offset (number of results to skip). Default 0.
Ticker symbol to look up (e.g., `AAPL`).
Filter your results based on a specific stock exchange by specifying the MIC identification of a stock exchange.
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
MARKETSTACK_GET_TICKER_INFOTool to retrieve detailed information about stock tickers including exchange, sector, and industry data. Use when you need comprehensive company information for a ticker symbol.
Input parameters
One or more comma-separated ticker symbols (e.g., `AAPL` or `AAPL,MSFT`).
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
MARKETSTACK_LIST_CURRENCIESTool to retrieve a list of all supported currencies from the Marketstack API. Use when you need to get information about available currencies for stock market data.
Input parameters
Pagination limit - number of results per page. Default is 100, maximum is 1000.
Pagination offset - number of results to skip. Default is 0.
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
MARKETSTACK_LIST_EXCHANGESTool to retrieve information about supported stock exchanges. Use when you need to list or search for stock exchanges from the 2700+ exchanges available in Marketstack.
Input parameters
Pagination limit (results per page). Default 100, maximum 1000.
Pagination offset (number of results to skip). Default 0.
Search term to filter exchanges by name or symbol.
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
MARKETSTACK_LIST_TICKERSTool to get a list of all supported stock tickers. Use when you need to obtain the full list of tickers supported by Marketstack or search for specific tickers.
Input parameters
Pagination limit (results per page). Default 100, maximum 1000.
Pagination offset (number of results to skip). Default 0.
Search term to filter tickers by name or symbol.
Filter your results based on a specific stock exchange by specifying the MIC identification of a stock exchange.
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
Agents can call 10 Marketstack actions on Nagent, including "Get Dividends", "Get End-of-Day Data" and "Get Exchange Info". Get Dividends: Retrieve stock dividend data for one or more ticker symbols from Marketstack API. Each action is listed on this page with its input parameters and its output.
Marketstack connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Dividends takes 1 required input: symbols. It also takes 5 optional inputs: sort, limit, offset, date_to and date_from. It returns data, error and successful.