← Home

Tickers Endpoint

The Tickers endpoint provides detailed information about stock symbols available through the Marketstack API. It allows users to retrieve metadata about companies, exchanges, and asset types associated with specific ticker symbols.

This endpoint is useful when validating symbols before requesting market data or when building applications that display company and exchange details alongside stock prices.

Endpoint

GET/tickers

This endpoint returns a list of ticker symbols along with descriptive and classification information.

Query Parameters

The following query parameters can be used to filter ticker results.

access_key

Your unique API access key. This parameter is required for authentication with every request.

symbols

One or more ticker symbols to retrieve information for. Multiple symbols can be provided as a comma-separated list.

exchange

Filters tickers by a specific exchange code.

limit

Specifies the number of results to return per request. Used for pagination.

offset

Specifies the starting position of the results. Used together with limit to paginate through large result sets.

Example Request

Here you can describe the request in words before adding your code block:

This example retrieves ticker information for Apple (AAPL) and Microsoft (MSFT).


{
  "pagination": {
    "limit": 100,
    "offset": 0,
    "count": 1,
    "total": 1
  },
  "data": [
    {
      "name": "Microsoft Corporation",
      "symbol": "MSFT",
      "has_intraday": false,
      "has_eod": true,
      "stock_exchange": {
        "name": "NASDAQ - ALL MARKETS",
        "acronym": "NASDAQ",
        "mic": "XNAS",
        "country_code": "US",
        "city": "NEW YORK",
        "website": "www.nasdaq.com"
      }
    }
  ]
}

Response Overview

A successful request returns a JSON response containing pagination details and an array of ticker objects. Each object represents a single stock symbol and includes identification and classification information.

Response Fields

This section describes commonly used fields in the ticker response. Not all fields returned by the API are listed here.

symbol

The unique ticker symbol used to identify the stock in the market.

name

The full company name associated with the ticker symbol.

exchange

The full name of the exchange where the stock is listed.

exchange_code

A short code representing the exchange.

has_intraday

Indicates whether intraday (minute or hourly) market data is available for this ticker.

has_eod

Indicates whether end-of-day (EOD) historical price data is available for this ticker.

stock_exchange

Contains detailed information about the exchange where the ticker is listed.

  • stock_exchange.name - Full name of the exchange
  • stock_exchange.acronym - Short name of the exchange
  • stock_exchange.mic - Market Identifier Code
  • stock_exchange.country_code - Country code of the exchange
  • stock_exchange.city - City where the exchange is located
  • stock_exchange.website - Official exchange website

currency

The currency in which the stock is traded.

asset_type

Indicates the type of financial instrument, such as Stock or ETF.

Pagination

Ticker results may be paginated when large datasets are returned. The limit and offset parameters can be used to navigate through pages of results. Pagination details are included in the pagination object in the API response.

When to Use This Endpoint

You should use the Tickers endpoint when:

  • Verifying that a stock symbol exists before requesting price data
  • Displaying company or exchange information in an application
  • Filtering stocks by exchange or country
  • Building search or discovery features for financial data applications
Next →