List markets

Return every market we cover in one response: no pagination. A market is a country-level trading region, e.g. america or germany, and matches the market field on ticker resources. Each market lists its ISO 3166 country code, the exchanges trading in it, and the number of listed symbols we cover.

Trading hours belong to exchanges, not markets: within one market, venues keep different sessions (for example XETR and GETTEX inside germany). Look them up per exchange with the exchange trading-hours endpoint.

GET/v3.0.0/markets

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Parameters

Response

Response fields

dataarray of objects

Array of every market resource, ordered by code.

+ Show child attributes
idstring

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

objectstring

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

codestring

Code of the market, a country-level trading region, e.g. america or germany. Matches the market field on tickers; pass it to ticker search with search_by=market.

country_codestring

Two-letter ISO 3166 country code of the market, e.g. US. Matches the listing_country_code field on tickers.

exchangesarray of strings

Exchange codes trading in this market, largest listing count first. Values match the List exchanges endpoint. Use the exchange trading-hours endpoint for each venue, because hours can differ within one market.

symbol_countnumber

Number of listed symbols we cover in this market.

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

Market codes match the ticker market field and group exchanges by region.

Request
curl "https://api.roic.ai/v3.0.0/markets?apikey=YOUR_API_KEY"
Response
200 OK
{
  "data": [
    {
      "id": "mkt_9Ckpiwgk81gwhhiWeGlcYy",
      "object": "v3.reference.market",
      "code": "america",
      "country_code": "US",
      "exchanges": [
        "OTC",
        "NASDAQ",
        "NYSE",
        "AMEX",
        "CBOE"
      ],
      "symbol_count": 15271
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}