Peers — ortex-apis

v1

latestOpenAPI 3.0.32026-07-246185298.2 KB

Peers

Identify correlated peer companies — businesses in the same sector whose share prices have historically moved in relation to a given company. Use the Peers API to surface the most significant correlated moves, understand cross-stock relationships, and enrich your models with sector-level price dynamics.

The Peer Rating reflects the strength of the historical price correlation between two companies. A higher value indicates a stronger relationship. The Effect Score combines the strength of that correlation with the peer's 1-week price movement, making it easier to identify the most impactful correlated moves over the last week — whether positively or negatively related.

Available Data Points:

Peer Ticker: The ticker symbol of the correlated peer company.
Peer Exchange: The exchange on which the peer is traded.
Peer Rating: Strength of the historical price correlation, expressed as a percentage.
Peer Weighting: The peer's correlation expressed as a percentage of the total correlation across all peers, indicating its relative significance within the peer group.
Effect Score: Combines correlation strength with the peer's 1-week price movement to highlight the most significant correlated moves, whether positive or negative.
Last Close: The queried stock's most recent closing price.
One Day Change: Percentage change in the queried stock's share price from the previous close to the last close.
One Week Change: Percentage change in the queried stock's share price over the last week.
Peer Last Close: The peer's most recent closing price.
Peer One Day Change: Percentage change in the peer's share price from the previous close to the last close.
Peer One Week Change: Percentage change in the peer's share price over the last week.
Peer Currency: The currency in which the peer's price is quoted.

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: Only the top 2 peers by effect score will be returned

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

get/api/v1/stock/{exchange_symbol}/{ticker}/peer/list

Path parameters

exchange_symbolstring required

Exchange symbol (e.g. "nyse", "nasdaq"), MIC code (e.g. "xnys", "xnas") or two character ISO country code (e.g "us", "ca" for ALL country exchanges)

tickerstring required

Ticker symbol

Query parameters

countrystring

A 2 character country ISO code (e.g. CA, JP). Omit this parameter to return peers from all countries.

model'linear' | 'power' | 'softmax'

Weighting model used to distribute correlation weight across peers. Negative correlations are always clamped to zero before weighting is applied.<ul><li>linear (default) — w = c / ∑c. Weight is directly proportional to raw correlation. Most intuitive; best when correlations are already meaningful and you do not want to amplify noise.</li><li>power — w = cp / ∑cp (p = 1.25). Raises each correlation to an exponent before normalizing. Preserves ordering while increasing separation between strong and weak peers without collapsing lower-ranked ones.</li><li>softmax — w = ec/T / ∑ecj/T (T = 0.1). Softmax over temperature-scaled correlations. Lower T concentrates weight on the strongest peers; higher T flattens the distribution. More controllable than power weighting but less transparent.</li></ul>

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

weightinteger

Number of peer companies to return (top N by correlation). Must be a positive integer. Default: 100.

Response

paginationLinksobject

lengthinteger required

creditsUsedinteger

creditsLeftinteger

Example response

{
  "paginationLinks": {
    "next": "http://api.example.org/accounts/?page=4",
    "previous": "http://api.example.org/accounts/?page=2"
  },
  "length": 123,
  "creditsUsed": 3,
  "creditsLeft": 999
}