List exchanges

Return every exchange we cover in one response: no pagination. Each exchange carries its normalized English exchange_name, venue-specific exchange_local_name, ISO 10383 MIC codes, the markets it spans, and the number of symbols we cover on it. Pass a returned code to the exact exchange filter on ticker list or search requests.

Trading schedules and their IANA timezones, plus holiday calendars, live on dedicated paid endpoints: exchange trading hours and exchange holidays.

A few pan-European venues (for example EURONEXT) span several markets. The markets array shows every market such a venue spans, and the List markets catalog maps each market back to its exchanges.

Exchange names

exchange_name is the normalized English display name, while exchange_local_name identifies the local or venue-specific exchange name. They can be identical, as with Nasdaq, or differ, such as B3 and B3 - Brasil Bolsa Balcao.

When one exchange code covers multiple MIC venues, the catalog uses the name associated with the exchange's largest mapped listing segment. Both fields are null when an exchange is not yet in the reference map.

GET/v3.0.0/exchanges

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Parameters

Response

Response fields

dataarray of objects

Array of every exchange resource, ordered by code.

+ Show child attributes
idstring

Unique identifier for the exchange, beginning with exc_. Derived deterministically from code, so it never changes for a given exchange and is safe to store in your database.

objectstring

String representing the object's type, always v3.reference.exchange for this resource.

codestring

Short code of the exchange, e.g. NASDAQ. Pass it to the exchange filter of the ticker endpoints.

exchange_namestring

Normalized English display name of the exchange, e.g. Nasdaq Stock Market. null when the exchange is not yet in the reference map.

exchange_local_namestring

Local or venue-specific exchange name. It may equal exchange_name, as with Nasdaq, or differ, such as B3 - Brasil Bolsa Balcao for B3. For exchange codes spanning several MIC venues, this follows the largest mapped listing segment. null when unavailable.

micsarray of strings

The ISO 10383 Market Identifier Codes of the listing segments in use on this exchange, largest segment first, e.g. XNGS for the Nasdaq Global Select Market. Matches the mic field on tickers. Empty when no MIC is on record.

marketsarray of strings

Market codes this exchange spans, largest first. Most exchanges map to one market; pan-European venues such as EURONEXT span several (e.g. france, portugal), and their non-primary segments can keep different hours. Values match the market field on tickers and the List markets endpoint.

symbol_countnumber

Number of symbols we cover on this exchange, including delisted tickers.

next_page_urlnullable

Always null: the endpoint returns the complete catalog in one response.

previous_page_urlnullable

Always null: the endpoint returns the complete catalog in one response.

Related endpoints

Use exchange codes to narrow these ticker operations.

Request
curl "https://api.roic.ai/v3.0.0/exchanges?apikey=YOUR_API_KEY"
Response
200 OK
{
  "data": [
    {
      "id": "exc_WgSljoAs0SOYv0jiDtwZy_",
      "object": "v3.reference.exchange",
      "code": "NASDAQ",
      "exchange_name": "Nasdaq Stock Market",
      "exchange_local_name": "Nasdaq Stock Market",
      "mics": [
        "XNCM",
        "XNGS",
        "XNMS"
      ],
      "markets": [
        "america"
      ],
      "symbol_count": 8603
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}