Listings

API TraderAPI QuantAPI Developer

See every listing of the security behind a stock path: each exchange it trades on, with the ticker, MICs, currency and identifiers of that line. Call it with any form of stock path, for example stock/isin/GB00BH4HKS39/reference/listings to find every line of the security holding that ISIN, or stock/LSE/VOD/reference/listings to find the other venues of a ticker you already have.

A stock path that names a security rather than a listing (an ISIN, an ortexSid, an ortexCid or a share-class FIGI) answers every other stock endpoint for the security's main listing only. To get another listing's data, take its ortexTid, or its exchangeSymbol and ticker, from a row here and use it as the stock path: stock/tid/{ortexTid}/... or stock/{exchangeSymbol}/{ticker}/....

Rows are the active listings of one security that carry a ticker: the primary listing first, then by exchange importance, then by exchange symbol. On a company path (cid) the company's primary security is used; the company's other share classes have their own ISINs and their own listings. There is no date window: the listing set is as it stands today.

Available Data Points:

  • ORTEX Ids: ortexTid (the listing), ortexSid (the security) and ortexCid (the company).
  • Exchange Symbol and Ticker: The ORTEX exchange symbol and the listing's ticker on it.
  • MIC and Operating MIC: The exchange's segment (published) MIC and its operating MIC.
  • Exchange Name and Country: The exchange's name and its ISO 3166-1 alpha-2 country.
  • Currency: The listing's trading currency.
  • FIGI: The listing's exchange-level FIGI, null where none is held.
  • Is Primary: True for the security's primary listing.

Try it out! You can test the API with the trial key TEST. Simply include it in your request headers; either here, or add the header "Ortex-Api-Key": "TEST" to your http request.

Trial key restrictions: Trial keys may be limited to a specific date range and set of regions. Requests outside the allowed regions or entirely outside the allowed date range are rejected; a date window that partially overlaps the allowed range is trimmed to it, reported in meta.restriction.

Get full access! Get a key at app.ortex.com/apis

Path Params
string
required

Where to find the instrument: a venue (exchange symbol, MIC or ISO-2 country) or an identifier scheme (tid, sid, cid, isin, figi). See Identifying an instrument.

string
required

The ticker on that venue, or the value in that scheme. An ISIN, sid, cid or share-class FIGI answers for the main listing only; reference/listings lists the others. See Identifying an instrument.

Query Params
integer

Page number within the paginated result set. Must be >= 1. Defaults to 1.

integer

Number of rows per page. The default and the maximum allowed depend on the API tier; a value above the tier maximum is rejected with 400 invalidPageSize.

string
enum
Defaults to json

Response format. "json" (default) or "csv".

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/csv