Marketstack

Marketstack Exchanges API

The Exchanges API from Marketstack — 9 operation(s) for exchanges.

GitHub OpenAPI

Operations 9

GET /exchanges Exchanges #
GET /exchanges/{mic} Specific Stock Exchange Info #
GET /exchanges/{mic}/tickers Specific Stock Exchange Tickers #
GET /exchanges/{mic}/eod EOD Data for a Specific Stock Exchange #
GET /exchanges/{mic}/eod/latest EOD Data for the Latest Date Available for a Specific Stock Exchange #
GET /exchanges/{mic}/eod/{date} EOD Data for a Specific Stock Exchange on a Specific Date #
GET /exchanges/{mic}/intraday Intraday Data for a Specific Stock Exchange #
GET /exchanges/{mic}/intraday/latest Intraday Data for the Latest Date Available for a Specific Stock Exchange #
GET /exchanges/{mic}/intraday/{date} Intraday Data for a Specific Stock Exchange on a Specific Date #

Documentation

📖
Documentation
https://docs.apilayer.com/marketstack/docs/api-documentation
📖
APIReference
https://marketstack.com/documentation_v2

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/marketstack/refs/heads/main/openapi/marketstack-exchanges-api-openapi.yml

Other Resources

🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/marketstack/refs/heads/main/mcp/marketstack-tool-crosswalk.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/marketstack-exchanges-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

marketstack-exchanges-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Marketstack API v2 Exchanges API
  version: 2.0.0
  description: The official Marketstack API documentation will help you learn how to query the Marketstack JSON API for real-time, intraday, and historical stock market data, along with more advanced EDGAR data endpoints.
servers:
- url: https://api.marketstack.com/v2
security:
- ApiKeyQuery: []
tags:
- name: Exchanges
paths:
  /exchanges:
    get:
      tags:
      - Exchanges
      summary: Exchanges
      description: Using the Exchanges 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.
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Search'
      responses:
        '200':
          description: Exchanges list retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangesResponse'
      operationId: getExchanges
      x-operation-id-source: derived
  /exchanges/{mic}:
    get:
      tags:
      - Exchanges
      summary: Specific Stock Exchange Info
      description: Returns detailed information for a single exchange (by MIC).
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/MIC'
      responses:
        '200':
          description: Exchange retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangesResponse'
      operationId: getExchangesByMic
      x-operation-id-source: derived
  /exchanges/{mic}/tickers:
    get:
      tags:
      - Exchanges
      summary: Specific Stock Exchange Tickers
      description: Returns tickers listed on a specific exchange.
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/MIC'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      responses:
        '200':
          description: Exchange tickers retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangeMicTickersResponse'
      operationId: getExchangesByMicTickers
      x-operation-id-source: derived
  /exchanges/{mic}/eod:
    get:
      tags:
      - Exchanges
      summary: EOD Data for a Specific Stock Exchange
      description: Returns EOD data for all symbols on a specific exchange.
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/MIC'
      - $ref: '#/components/parameters/Symbols'
      - $ref: '#/components/parameters/Exchange'
      - $ref: '#/components/parameters/DateFrom'
      - $ref: '#/components/parameters/DateTo'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      responses:
        '200':
          description: Exchange EOD data retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangesMicEod'
      operationId: getExchangesByMicEod
      x-operation-id-source: derived
  /exchanges/{mic}/eod/latest:
    get:
      tags:
      - Exchanges
      summary: EOD Data for the Latest Date Available for a Specific Stock Exchange
      description: Returns EOD data for the latest date avialbale for all symbols on a specific exchange.
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/Symbols'
      - $ref: '#/components/parameters/MIC'
      responses:
        '200':
          description: Latest EOD data for the exchange retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangesMicEod'
      operationId: getExchangesByMicEodLatest
      x-operation-id-source: derived
  /exchanges/{mic}/eod/{date}:
    get:
      tags:
      - Exchanges
      summary: EOD Data for a Specific Stock Exchange on a Specific Date
      description: Returns EOD data for the given date for all symbols on a specific exchange.
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/Symbols'
      - $ref: '#/components/parameters/MIC'
      - $ref: '#/components/parameters/DatePath'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      responses:
        '200':
          description: EOD data for the exchange and date retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangesMicEod'
      operationId: getExchangesByMicEodByDate
      x-operation-id-source: derived
  /exchanges/{mic}/intraday:
    get:
      tags:
      - Exchanges
      summary: Intraday Data for a Specific Stock Exchange
      description: Returns intraday data for all symbols on a specific exchange.
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/Symbols'
      - $ref: '#/components/parameters/MIC'
      - $ref: '#/components/parameters/Interval'
      - $ref: '#/components/parameters/DateFrom'
      - $ref: '#/components/parameters/DateTo'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      responses:
        '200':
          description: Exchange intraday data retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntradayResponse'
      operationId: getExchangesByMicIntraday
      x-operation-id-source: derived
  /exchanges/{mic}/intraday/latest:
    get:
      tags:
      - Exchanges
      summary: Intraday Data for the Latest Date Available for a Specific Stock Exchange
      description: Returns intraday data for the latest date avialbale for all symbols on a specific exchange.
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/Symbols'
      - $ref: '#/components/parameters/MIC'
      - $ref: '#/components/parameters/Interval'
      responses:
        '200':
          description: Latest intraday data for the exchange retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntradayResponse'
      operationId: getExchangesByMicIntradayLatest
      x-operation-id-source: derived
  /exchanges/{mic}/intraday/{date}:
    get:
      tags:
      - Exchanges
      summary: Intraday Data for a Specific Stock Exchange on a Specific Date
      description: Returns intraday data for the given date for all symbols on a specific exchange.
      parameters:
      - $ref: '#/components/parameters/AccessKey'
      - $ref: '#/components/parameters/Symbols'
      - $ref: '#/components/parameters/MIC'
      - $ref: '#/components/parameters/DateTimePath'
      - $ref: '#/components/parameters/Interval'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      responses:
        '200':
          description: Exchange intraday data for the date retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntradayResponse'
      operationId: getExchangesByMicIntradayByDate
      x-operation-id-source: derived
components:
  parameters:
    Symbols:
      name: symbols
      in: query
      description: One or more comma-separated ticker symbols (e.g., `AAPL,MSFT`).
      required: true
      schema:
        type: string
    DateTo:
      name: date_to
      in: query
      description: Filter results up to this date (inclusive). Format `YYYY-MM-DD`.
      required: false
      schema:
        type: string
        format: date
    AccessKey:
      name: access_key
      in: query
      description: Your Marketstack API access key.
      required: true
      schema:
        type: string
    Sort:
      name: sort
      in: query
      description: Sort order. Use `ASC` for oldest first or `DESC` for newest first.
      required: false
      schema:
        type: string
        enum:
        - ASC
        - DESC
    Limit:
      name: limit
      in: query
      description: Pagination limit (results per page). Default 100, maximum 1000.
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 1000
    MIC:
      name: mic
      in: path
      required: true
      description: Exchange MIC identifier (e.g., `XNAS`).
      schema:
        type: string
    DateFrom:
      name: date_from
      in: query
      description: Filter results from this date (inclusive). Format `YYYY-MM-DD`.
      required: false
      schema:
        type: string
        format: date
    Interval:
      name: interval
      in: query
      description: Intraday aggregation interval.
      required: false
      schema:
        type: string
        enum:
        - 1min
        - 5min
        - 10min
        - 15min
        - 30min
        - 1hour
    Search:
      name: search
      in: query
      description: Search term to filter tickers by name or symbol.
      required: false
      schema:
        type: string
    Exchange:
      name: exchange
      in: query
      description: Filter your results based on a specific stock exchange by specifying the MIC identification of a stock exchange.
      required: false
      schema:
        type: string
    DatePath:
      name: date
      in: path
      required: true
      description: Specific date for EOD data. Format `YYYY-MM-DD`.
      schema:
        type: string
        format: date
    DateTimePath:
      name: date
      in: path
      required: true
      description: Specific date for intraday data. Example `2024-09-27 15:30`.
      schema:
        type: string
    Offset:
      name: offset
      in: query
      description: Pagination offset (number of results to skip). Default 0.
      required: false
      schema:
        type: integer
        minimum: 0
  schemas:
    IntradayBar:
      allOf:
      - $ref: '#/components/schemas/EODBar'
      description: Intraday bar data; fields identical to EOD with intraday timestamp.
    Pagination:
      type: object
      properties:
        limit:
          type: integer
          description: Returns your pagination limit value.
        offset:
          type: integer
          description: Returns your pagination offset value.
        count:
          type: integer
          description: Returns the results count on the current page.
        total:
          type: integer
          description: Returns the total count of results available.
    ExchangesResponse:
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/Pagination'
        data:
          type: array
          items:
            $ref: '#/components/schemas/Exchange'
    Exchange:
      type: object
      properties:
        name:
          type: string
          description: Name of the stock exchange.
        acronym:
          type: string
          description: Acronym of the stock exchange.
        mic:
          type: string
          description: MIC identification of the exchange.
        country:
          type:
          - string
          - 'null'
          description: Country of the stock exchange.
        country_code:
          type: string
          description: Three-letter country code of the exchange.
        city:
          type: string
          description: City where the exchange is located.
        website:
          type: string
          description: Website URL of the exchange.
        operating_mic:
          type: string
          description: Operating Market Identifier Code.
        oprt_sgmt:
          type: string
          description: Indicates operating MIC vs market segment MIC.
        legal_entity_name:
          type: string
          description: Legal entity name.
        exchange_lei:
          type: string
          description: Exchange Legal Entity Identifier (LEI).
        market_category_code:
          type: string
          description: Market category code.
        exchange_status:
          type: string
          description: Current status of the exchange.
        date_creation:
          type: string
          description: Creation date.
        date_last_update:
          type: string
          description: Last update date.
        date_last_validation:
          type: string
          description: Last validation date.
        date_expiry:
          type: string
          description: Expiry date.
        comments:
          type: string
          description: Additional comments.
    ExchangeMicTickersResponse:
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/Pagination'
        data:
          type: object
          properties:
            name:
              type: string
              description: Exchange name.
            acronym:
              type: string
              description: Exchange acronym.
            mic:
              type: string
              description: MIC identification of the exchange.
            country:
              type: string
              description: Country of the exchange.
            city:
              type: string
              description: Exchange city.
            website:
              type: string
              description: Exchange website URL.
            operating_mic:
              type: string
              description: Operating Market Identifier Code.
            oprt_sgmt:
              type: string
              description: Indicates operating MIC vs market segment MIC.
            legal_entity_name:
              type: string
              description: Legal entity name.
            exchange_lei:
              type: string
              description: Exchange Legal Entity Identifier (LEI).
            market_category_code:
              type: string
              description: Market category code.
            exchange_status:
              type: string
              description: Current status of the exchange.
            date_creation:
              type: string
              description: Creation date (YYYY-MM-DD).
            date_last_update:
              type: string
              description: Last update date (YYYY-MM-DD).
            date_last_validation:
              type: string
              description: Last validation date (nullable).
            date_expiry:
              type: string
              description: Expiry date (nullable).
            comments:
              type: string
              description: Additional comments.
            tickers:
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                    description: Company or instrument name.
                  symbol:
                    type: string
                    description: Ticker symbol.
                  has_intraday:
                    type: boolean
                    description: Indicates if intraday data is available.
                  has_eod:
                    type: boolean
                    description: Indicates if end-of-day data is available.
    EODBar:
      type: object
      description: End-of-day bar data for a single symbol and date.
      properties:
        open:
          type: number
          format: float
          description: Opening price for the trading session.
        high:
          type: number
          format: float
          description: Highest price of the session.
        low:
          type: number
          format: float
          description: Lowest price of the session.
        close:
          type: number
          format: float
          description: Closing price of the session.
        volume:
          type: number
          format: float
          description: Traded volume during the session.
        adj_high:
          type: number
          format: float
          description: High price adjusted for corporate actions.
        adj_low:
          type: number
          format: float
          description: Low price adjusted for corporate actions.
        adj_close:
          type: number
          format: float
          description: Close price adjusted for corporate actions.
        adj_open:
          type: number
          format: float
          description: Open price adjusted for corporate actions.
        adj_volume:
          type: number
          format: float
          description: Volume adjusted for corporate actions.
        split_factor:
          type: number
          format: float
          description: Cumulative stock split factor applied for the date.
        dividend:
          type: number
          format: float
          description: Dividend amount per share for the date.
        name:
          type: string
          description: Company name.
        exchange_code:
          type: string
          description: Human-friendly exchange code (for example NASDAQ).
        asset_type:
          type: string
          description: Asset class
        price_currency:
          type: string
          description: Price currency (ISO code in lower case).
        symbol:
          type: string
          description: Ticker symbol.
        exchange:
          type: string
          description: MIC of the exchange.
        date:
          type: string
          description: Timestamp of the bar in ISO8601 with timezone.
    IntradayResponse:
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/Pagination'
        data:
          type: array
          items:
            $ref: '#/components/schemas/IntradayBar'
    ExchangesMicEod:
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/Pagination'
        data:
          type: object
          properties:
            name:
              type: string
              description: Exchange name.
            acronym:
              type: string
              description: Exchange acronym.
            mic:
              type: string
              description: MIC identification of the exchange.
            country:
              type: string
              description: Country of the exchange.
            city:
              type: string
              description: Exchange city.
            website:
              type: string
              description: Exchange website URL.
            operating_mic:
              type: string
              description: Operating Market Identifier Code.
            oprt_sgmt:
              type: string
              description: Indicates operating MIC vs market segment MIC.
            legal_entity_name:
              type: string
              description: Legal entity name.
            exchange_lei:
              type: string
              description: Exchange Legal Entity Identifier (LEI).
            market_category_code:
              type: string
              description: Market category code.
            exchange_status:
              type: string
              description: Current status of the exchange.
            date_creation:
              type: string
              description: Creation date (YYYY-MM-DD).
            date_last_update:
              type: string
              description: Last update date (YYYY-MM-DD).
            date_last_validation:
              type: string
              description: Last validation date (nullable).
            date_expiry:
              type: string
              description: Expiry date (nullable).
            comments:
              type: string
              description: Additional comments.
            eod:
              type: array
              items:
                $ref: '#/components/schemas/EODBar'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: access_key
      description: Your Marketstack API access key.