# Marketstack

Stock Data Real-Time, Intraday & Historical Market Data API providing access to 125,000+ tickers across 72+ stock exchanges worldwide

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `MARKETSTACK`
- **Version:** 00000000_00

## Tools

### Get Dividends

**Slug:** `MARKETSTACK_GET_DIVIDENDS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("ASC" | "DESC") | No | Sort order for dividend results. |
| `limit` | integer | No | Pagination limit - number of results per page. Default 100, maximum 1000. Use to control how many dividend records are returned. |
| `offset` | integer | No | Pagination offset - number of results to skip. Default 0. Use with limit to paginate through large result sets. |
| `date_to` | string | No | Filter results up to this date (inclusive). Format YYYY-MM-DD. Use to get dividends up to a specific date. |
| `symbols` | string | Yes | One or more comma-separated ticker symbols (e.g., 'AAPL' or 'AAPL,MSFT'). Required to specify which stocks to retrieve dividend data for. |
| `date_from` | string | No | Filter results from this date (inclusive). Format YYYY-MM-DD. Use to get dividends starting from a specific date. |

#### 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 End-of-Day Data

**Slug:** `MARKETSTACK_GET_EOD`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("ASC" | "DESC") | No | Sort order for EOD data results. |
| `limit` | integer | No | Maximum number of results to return per page. Default is 100, maximum is 1000. |
| `offset` | integer | No | Number of results to skip for pagination. Default is 0. Use with limit to paginate through large result sets. |
| `date_to` | string | No | End date for filtering results (inclusive). Use YYYY-MM-DD format (e.g., '2024-12-31'). |
| `symbols` | string | Yes | One or more comma-separated ticker symbols to retrieve data for (e.g., 'AAPL' or 'AAPL,MSFT,GOOGL'). |
| `exchange` | string | No | Filter results by stock exchange MIC code (e.g., 'XNAS' for NASDAQ). Only returns data from the specified exchange. |
| `date_from` | string | No | Start date for filtering results (inclusive). Use YYYY-MM-DD format (e.g., '2024-01-01'). |

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

**Slug:** `MARKETSTACK_GET_EXCHANGE`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mic` | string | Yes | Exchange MIC (Market Identifier Code) identifier, e.g., 'XNAS' for NASDAQ. |

#### 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:** `MARKETSTACK_GET_SPLITS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("ASC" | "DESC") | No | Sort order for splits data. |
| `limit` | integer | No | Pagination limit (results per page). Default 100, maximum 1000. |
| `offset` | integer | No | Pagination offset (number of results to skip). Default 0. |
| `date_to` | string | No | Filter results up to this date (inclusive). Format `YYYY-MM-DD`. |
| `symbols` | string | Yes | One or more comma-separated ticker symbols (e.g., `AAPL` or `AAPL,MSFT`). |
| `date_from` | string | No | Filter results from this date (inclusive). 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 Ticker EOD Data

**Slug:** `MARKETSTACK_GET_TICKER_EOD`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of results to return per page. Default is 100, maximum is 1000 |
| `offset` | integer | No | Number of results to skip for pagination. Default is 0 |
| `symbol` | string | Yes | Ticker symbol to look up (e.g., AAPL, MSFT, TSLA) |
| `exchange` | string | No | Filter results by a specific stock exchange using the MIC identification code (e.g., XNAS for NASDAQ) |

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

**Slug:** `MARKETSTACK_GET_TICKER_EOD_LATEST`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Pagination limit (results per page). Default 100, maximum 1000. |
| `offset` | integer | No | Pagination offset (number of results to skip). Default 0. |
| `symbol` | string | Yes | Ticker symbol to look up (e.g., `AAPL`). |
| `exchange` | string | No | Filter your results based on a specific stock exchange by specifying the MIC identification of a stock exchange. |

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

**Slug:** `MARKETSTACK_GET_TICKER_INFO`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticker` | string | Yes | One or more comma-separated ticker symbols (e.g., `AAPL` or `AAPL,MSFT`). |

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

**Slug:** `MARKETSTACK_LIST_CURRENCIES`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Pagination limit - number of results per page. Default is 100, maximum is 1000. |
| `offset` | integer | No | Pagination offset - number of results to skip. Default is 0. |

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

**Slug:** `MARKETSTACK_LIST_EXCHANGES`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Pagination limit (results per page). Default 100, maximum 1000. |
| `offset` | integer | No | Pagination offset (number of results to skip). Default 0. |
| `search` | string | No | Search term to filter exchanges by name or symbol. |

#### Output

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

### List Tickers

**Slug:** `MARKETSTACK_LIST_TICKERS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Pagination limit (results per page). Default 100, maximum 1000. |
| `offset` | integer | No | Pagination offset (number of results to skip). Default 0. |
| `search` | string | No | Search term to filter tickers by name or symbol. |
| `exchange` | string | No | Filter your results based on a specific stock exchange by specifying the MIC identification of a stock exchange. |

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