Stock Reports

API Enterprise

Weekly per-company Stock Reports — long-form analytical write-ups generated from ORTEX data, delivered as Markdown. Returns the published feed, newest first, or the report for a single company when you supply a ticker.

Enterprise keys receive the full article body. There is no premium gate and no truncation on this surface.

Available Data Points:

  • Headline: The report's title.
  • Summary: A short executive summary, two or three sentences.
  • Body: The full article as Markdown.
  • Ticker: The ticker of the company's primary listing at the time the report was generated.
  • Exchange: The exchange symbol of that primary listing.
  • Company Name: The name of the company the report covers.
  • Identifiers: The primary listing rendered with exchange, ticker, MIC and ISIN. At most one entry.
  • Version: Bumped each time the report is regenerated for this company, so you can detect a revision.
  • Published At: When the report went live. The only customer-facing timestamp on this surface.
  • Provenance: How the report was produced — the generation audit, minus internal-only detail.

One report per company

Stock Reports are keyed on the company, not the listing: re-listings, dual listings and multiple share classes all share a single report. A report is regenerated in place rather than published as a new row each week, which is why there is no date range on this endpoint and why 'version' is how you tell revisions apart.

Checking whether a report exists

Supply a ticker. A company with no published report returns a 200 with an empty 'data' array and 'meta.emptyReason' of noDataAvailableForInstrument — an existence check needs no separate endpoint, and the same call gives you the report itself when there is one. A ticker matching no active instrument is a 404 instrumentNotFound, which is a different question: the identifier did not resolve, rather than resolving to a company we hold nothing for.

Visibility

Only published reports are returned. A report scheduled for a future date, or with no publication date set, is not visible until its publication moment arrives.

JSON only

A report row carries a Markdown body and nested objects, which CSV cannot represent, so this endpoint is JSON only — a CSV request returns 406 Not Acceptable.

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! Contact [email protected]

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; values above the tier maximum are clamped down to it.

string

Narrow the result to a single instrument, matched on ticker (case-insensitive). Surrounding whitespace is ignored. A ticker matching no active instrument returns 404 instrumentNotFound. Endpoints that take an instrument from the URL path do not accept this parameter — see each endpoint's own description for what it means there.

Responses

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