Alt Data signals

API TraderAPI QuantAPI Developer

Derived alternative-data signals for one instrument and one series — the comparable form of the underlying data.

Raw values are frequently not comparable. Receivables of $10.9bn against $4.9bn say nothing without each book's size; a 5.3% charge-off rate means something different on a subprime book than a prime one. A signal states what the value was compared against, which is the part that makes it usable in a screen.

Available Data Points:

  • Signal Slug: Signal identifier.
  • Series Slug: The series the signal is derived from.
  • Transform: zscore, percentile, drift, trend or level.
  • Cross Section: What the value was compared against — see below.
  • As Of Date: When the value became computable. This is the knowledge clock.
  • Period Date: The period the underlying observation describes.
  • Entity Ref: The publisher's identifier for the entity the signal is about, as on the observations route. A listing with several entities in one series (a utility's reactor units, a retailer's states) has a row per entity; empty where the series has one entity per listing.
  • Value: The signal value.
  • Zscore: Standard deviations from the comparison set.
  • Percentile: Rank within the comparison set, 0-100.
  • Sample Size: How many observations the comparison was made against.
  • Higher Is Better: Whether a higher value is the bullish reading. A rising charge-off rate is not.

crossSection is the question the signal answers

The two are not interchangeable:

  • own_history: Is this high for this company? The right comparison where entities are not comparable to each other.
  • all: Is this high for this series right now? Ranks every entity reporting the same period, and is only meaningful where the series genuinely is comparable across companies.

asOfDate is the knowledge clock

It is the day the value became computable, derived from the underlying observation's publication rather than its period. Use it, not periodDate, when joining against returns.

Coverage

Signals are available for every series, including those whose raw values are restricted. The one exception is a level transform, which republishes the publisher's own number and so inherits the source's restriction.

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
date
required

Inclusive start of the returned date window. Format: YYYY-MM-DD.

Also selects the instrument: the ticker resolves to the listing that held it on the exchange in the URL path on this date. To retrieve a delisted or renamed company, use its former exchange and ticker with a from_date from when it was listed. An identifier path (/stock/isin|figi|sid|cid/<value>/…) resolves at this date too. The instrument block in the response names the company the data belongs to.

date

Inclusive end of the returned date window (defaults to today). Format: YYYY-MM-DD.

string
required

The series to return. List every available slug with the Alt Data catalog endpoint. Passing an unknown slug returns 400 invalidSeries.

string

The publisher of the requested series. Only needed when a series slug is published by more than one source, which returns 400 invalidSeries naming the alternatives. Every series' source is reported by the Alt Data catalog endpoint.

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