---
title: "The markets listings are covered on: the US directory and each exchange outside the US, with the exchange codes its listings are named under (MIC:TICKER), its currency, session hours and listing count."
method: GET
path: "/v1/markets"
tags: ["Listings"]
---

# The markets listings are covered on: the US directory and each exchange outside the US, with the exchange codes its listings are named under (MIC:TICKER), its currency, session hours and listing count.

`GET /v1/markets`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/markets`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/markets/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

OK

- ListingMarketDtoListResponse
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `data` ListingMarketDto[], nullable
    - `code` string, nullable: Stable market code (us, xetra, euronext-lisbon, lse …).
    - `name` string, nullable
    - `country` string, nullable: ISO country code; pass it as market on /v1/listings.
    - `marketIdentifierCodes` string[], nullable: The exchange codes its listings are named under, as MIC:TICKER; empty for the US, whose listings keep their bare ticker. Pass one as exchange on /v1/listings.
    - `currency` string, nullable: The market's main trading currency; each listing states its own.
    - `timeZone` string, nullable: IANA time zone of the session times.
    - `sessionOpen` string, nullable: Regular session open, local time (HH:mm).
    - `sessionClose` string, nullable: Regular session close, local time (HH:mm).
    - `listingCount` integer: Listings /v1/listings returns for this market, refreshed hourly.

## Other responses

- `400`: Invalid request — a malformed parameter value or a query parameter this endpoint does not support.

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)