Note: All the new functionalities and new endpoints listed in the pricing plans are designed for use with the new API endpoints in Version V2. Please refer to the V2 API endpoints documentation page for proper usage of the service. Please be aware that Version V1 of the API endpoints will be deprecated for use after June 30th, 2025.

Welcome to the Marketstack API documentation! In the following series of articles, you will learn how to query the Marketstack JSON API for real-time, intraday, and historical stock market data, define multiple stock symbols, retrieve extensive data about 70+ stock exchanges, 170,000+ stock tickers from more than 50 countries, as well as 750+ market indices, information about time zones, currencies, and more.

Our API is built on a RESTful, easy-to-understand request-and-response structure. API requests are always sent using a simple API request URL with a series of required and optional HTTP GET parameters, and API responses are provided in lightweight JSON format. Continue below to get started, or click the button above to jump to our 3-Step Quickstart Guide.

Quickstart Guide

Supported Endpoint

End-of-Day Data

You can use the API's eod endpoint to obtain end-of-day data for one or multiple stock tickers. A single or multiple comma-separated ticker symbols are passed to the API using the symbols parameter.

Note: To request end-of-day data for single ticker symbols, you can also use the API's Tickers Endpoint.

Example API Request:

Sign Up to Run API Request

Endpoint Features:

Parameters:

Example API Response: If your API request was successful, the Marketstack API will return both pagination information as well as a data object, which contains a separate sub-object for each requested date/time and symbol. All response objects are explained below.

API Response Objects:

Adjusted Prices: "Adjusted" prices are stock price values that were amended to accurately reflect the given stock's value after accounting for any corporate actions, such as splits or dividends. Adjustments are made in accordance with the "CRSP Calculations" methodology set forth by the Center for Research in Security Prices (CRSP).

End-of-Day Data: You can use the API's eod endpoint in order to obtain end-of-day data for one or multiple stock tickers. A single or multiple comma-separated ticker symbols are passed to the API using the symbols parameter.

JavaScript Axios

Python Request 

Python HTTP.client

Market Indices

The API is also capable of delivering end-of-day for 750+ of the world's major indices, including the S&P 500 Index, the Dow Jones Industrial Average Index as well as the NASDAQ Composite Index. Index data is available both on a "latest" basis as well as historically.

To list or access index data, simply pass INDX as your stock exchange MIC identification, as seen in the examples below. The example API request below illustrates how to obtain end-of-day data for the DJI market index.

Example API Request:

Sign Up to Run API Request

Parameters: For more information about request parameters, please refer to the End-of-day Data section of this documentation.

API Response:

API Response Objects: For more information about response objects, please refer to the End-of-day Data section of this documentation.

Market Indices in Other API Endpoints:

Historical Data 

Historical stock prices are available both from the end-of-day (eod) and intraday (intraday) API endpoints. To obtain historical data, simply use the date_from and date_to parameters as shown in the example request below.

Example API Request:

Sign Up to Run API Request

Parameters: For details on request parameters on the eod data endpoint, please jump to the End-of-Day Data section.

Example API Response:

API Response Objects: For details on API response objects, please jump to the End-of-Day Data section.

Note: Historical end-of-day data (eod) is available for up to 30 years back, while intraday data (intraday) always only offers the last 10,000 entries for each of the intervals available. Example: For a 1-minute interval, historical intraday data is available for up to 10,000 minutes back.

Historial Data: Historical stock prices are available both from the end-of-day (eod) and intraday (intraday) API endpoints. To obtain historical data, simply use the date_from and date_to parameters as shown in the example request below.

Intraday Data 

In additional to daily end-of-day stock prices, the marketstack API also supports intraday data with data intervals as short as one minute. Intraday prices are available for all US stock tickers included in the IEX (Investors Exchange) stock exchange.

To obtain intraday data, you can use the API's intraday endpoint and specify your preferred stock ticker symbols.

Note: To request intraday data for single ticker symbols, you can also use the API's Tickers Endpoint.

Example API Request:

Sign Up to Run API Request

Endpoint Features:

Parameters:

Real-Time Updates: Please note that data frequency intervals below 15 minutes (15min) are only supported if you are subscribed to the Professional Plan or higher. If you are the Free or Basic Plan, please upgrade your account.

Example API Response: If your API request was successful, the marketstack API will return both pagination information as well as a data object, which contains a separate sub-object for each requested date/time and symbol. All response objects are explained below.

API Response Objects:

Intraday Data: 

JavaScript Axios

Python Requests

Python HTTP.client       

Real-Time Updates

For customers with an active subscription to the Professional Plan, the marketstack API's intraday endpoint is also capable of providing real-time market data, updated every minute, every 5 minutes or every 10 minutes.

To obtain real-time data using this endpoint, simply append the API's interval parameter and set it to 1min, 5min or 10min.

Example API Request:

Sign Up to Run API Request

Endpoint Features, Parameters & API Response: To learn about endpoint features, request parameters and API response objects, please navigate to the Intraday Data section.

Real-Time-Updates: Specify the interval parameter and set it to 1min, 5min or 10min to obtain real-time data using this endpoint.

JavaScript Axios

Python Requests

Python HTTP.client       

Splits Data 

Using the APIs splitsendpoint you will be able to look up information about the stock splits factor for different symbols. You will be able to find and try out an example API request below.

To obtain splits data, you can use the API's splits endpoint and specify your preferred stock ticker symbols.

Note: To request splits data for single ticker symbols, you can also use the API's Tickers Endpoint.

Example API Request:

Sign Up to Run API Request

Parameters:

Example API Response: If your API request was successful, the marketstack API will return both pagination information as well as a data object, which contains a separate sub-object for each requested date/time and symbol. All response objects are explained below.

API Response Objects:

       Splits Data:

JavaScript Axios

Python Requests

Python HTTP.client             

Dividends Data 

Using the APIs dividendsendpoint you will be able to look up information about the stock dividend for different symbols. You will be able to find and try out an example API request below.

To obtain dividends data, you can use the API's dividends endpoint and specify your preferred stock ticker symbols.

Note: To request dividends data for single ticker symbols, you can also use the API's Tickers Endpoint.

Example API Request:

Sign Up to Run API Request

Parameters:

Example API Response: If your API request was successful, the marketstack API will return both pagination information as well as a data object, which contains a separate sub-object for each requested date/time and symbol. All response objects are explained below.

API Response Objects:

Dividends Data:

JavaScript Axios

Python Requests

Python HTTP.client        

Tickers 

Using the API's tickers endpoint you will be able to look up information about one or multiple stock ticker symbols as well as obtain end-of-day, real-time and intraday market data for single tickers. You will be able to find and try out an example API request below.

Example API Request:

Sign Up to Run API Request

Endpoint Features:

Parameters:

API Response:

API Response Objects:

Tickers:

JavaScript Axios

Python Requests

Python HTTP.client     

Exchanges 

Using the exchanges API endpoint you will be able to look up information any of the 2700+ stock exchanges supported by this endpoint. This endpoint provides general information about several stock exchanges. Not all stock exchanges found here are supported by other Marketstack endpoints. For the supported stock exchanges supported by each endpoint, please verify each endpoint documentation. You will be able to find and try out an example API request below.

Example API Request:

Sign Up to Run API Request

Endpoint Features:

Parameters:

API Response:

API Response Objects:

Exchanges:

JavaScript Axios

Python Requests

Python HTTP.client

Currencies 

Using the currencies API endpoint you will be able to look up all currencies supported by the marketstack API. You will be able to find and try out an example API request below.

Example API Request:

Sign Up to Run API Request

Parameters:

API Response:

API Response Objects:

Currencies:

JavaScript Axios

Python Requests

Python HTTP.client   

Timezones 

Using the timezones API endpoint you will be able to look up information about all supported timezones. You will be able to find and try out an example API request below.

Example API Request:

Sign Up to Run API Request

Parameters:

API Response:

API Response Objects:

Timezones:

JavaScript Axios

Python Requests

Python HTTP.client