API Enterprise
Every listing ORTEX covers, active and retired, with its ORTEX ids, ticker, exchange and market identifiers. This is the reference table for mapping ORTEX to your own instruments.
Only what ORTEX holds data for is listed: a listing is included when at least one enterprise dataset (prices, short interest, short score, short volume, free float, market cap, options, fails to deliver) carries data for it, a security when one of its listings is, a company when one of its securities is. Coverage is rebuilt daily. Active and retired entries are both listed; pass active=true or active=false to keep one. A listing is active while it trades: listed as active and priced by ORTEX within the last 90 days. A security or company is active while any of its listings is, in any country. The main-listing and primary-security flags prefer lines that still trade, so a company whose main line stopped trading moves to the line that did not.
The three lists nest: companies/list (one row per ortexCid), securities/list (one per ortexSid) and listings/list (one per ortexTid, carrying all three ids). Every id pastes into a stock path: stock/cid/{ortexCid}/, stock/sid/{ortexSid}/, stock/tid/{ortexTid}/.
region and country select by the country of the exchange a listing trades on; a security or company is included when it has a covered listing there. region defaults to US.
Built to seed and refresh your security master: pull it with region=ALL, page through it (page_size up to 10,000; CSV is paged the same way, with Ortex-Total-Rows in the headers), and join every other endpoint on the ORTEX ids. Rows are ordered by their ORTEX id, so the pages are stable between calls. The response is uncharged (no credits).
Available Data Points:
- ORTEX Ids: ortexTid (the listing), ortexSid (the security) and ortexCid (the company).
- Names: Company name, security name and security type.
- Exchange Symbol and Ticker: Paste into stock/{exchangeSymbol}/{ticker}/; null for a line with no ticker.
- MIC, Operating MIC, Exchange Name, Country: The exchange, with its country as ISO 3166-1 alpha-2.
- Currency: The listing's trading currency.
- ISIN, FIGI, Composite FIGI, Share Class FIGI: Market identifiers, null where none is held.
- Is Primary Listing: The security's main listing: the one an isin/, sid/ or cid/ path resolves to.
- Active: False once the listing is delisted, retired, or has had no price for more than 90 days.
- First and Last Price Date: The span of ORTEX price history; lastPriceDate is null while current.
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 date range and a set of regions. This catalog has no date dimension: a key whose allowed range ends before today is rejected. A region-limited key may only request its allowed regions; any other region, including ALL, is rejected with 403 restrictedRegion.
Get full access! Contact [email protected]
