Securities

API Enterprise

Every security ORTEX covers, active and retired: one row per instrument across all its listings, with its ISIN, share-class FIGI and main listing.

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: ortexSid (the security) and ortexCid (the company).
  • Names: Company name, security name and security type.
  • ISIN and Share Class FIGI: Market identifiers, null where none is held.
  • Is Primary Security: True for the issuer's main share class.
  • Active: True while at least one covered listing trades.
  • Primary Exchange Symbol, Ticker and Country: The main listing an isin/ or sid/ path resolves to.

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]

Query Params
string
Defaults to US

Which instruments to return: a region name, a two-character ISO-2 country code, or "ALL" for the whole covered universe. Defaults to "US". An unrecognized value returns 400 invalidRegion.

string

Limit the result to one country, as an ISO 3166-1 alpha-2 code (case-insensitive). Omit it for every country covered. A code that is not covered returns 400 invalidCountry, whose message lists the codes that are valid.

boolean

Limit the list to entries that are currently active (true) or to those that have been delisted or retired (false). Omit it for both. Any other value returns 400 invalidActive.

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
*/*