Skip to main content
GET
/
v1
/
peers
Peers
curl --request GET \
  --url https://api.chicago.global/v1/peers \
  --header 'Authorization: Bearer <token>'
[
  {
    "ric": "AAPL.O",
    "company_name": "Apple Inc",
    "market": "United States",
    "mtd": 0,
    "ytd": -6.35,
    "pe": 32.12,
    "ev_ebitda": 24.56,
    "roe": 170.68,
    "de": 1.35,
    "mktcap_b": 3731.4,
    "recommendation": "HOLD",
    "value": 2,
    "quality": 10,
    "momentum": 7.5,
    "defensive": 9.5,
    "tactical": 7,
    "total": 6
  }
]
Get a list of peer companies for a given stock, including valuation metrics, performance, and Parallax scores.

​
Query Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol (e.g., AAPL, MSFT)

​
Response

Returns an array of peer companies (including the target stock): 
[
  {
    "ric": "AAPL.O",
    "company_name": "Apple Inc",
    "market": "United States",
    "mtd": 0.0,
    "ytd": -6.35,
    "pe": 32.12,
    "ev_ebitda": 24.56,
    "roe": 170.68,
    "de": 1.35,
    "mktcap_b": 3731.4,
    "recommendation": "HOLD",
    "value": 2.0,
    "quality": 10.0,
    "momentum": 7.5,
    "defensive": 9.5,
    "tactical": 7.0,
    "total": 6.0
  },
  {
    "ric": "QCOM.O",
    "company_name": "Qualcomm Inc",
    "market": "United States",
    "mtd": 0.0,
    "ytd": -25.55,
    "pe": 26.26,
    "ev_ebitda": 10.2,
    "roe": 23.34,
    "de": 0.7,
    "mktcap_b": 137.41,
    "recommendation": "HOLD",
    "value": 4.5,
    "quality": 10.0,
    "momentum": 4.5,
    "defensive": 8.5,
    "tactical": 6.5,
    "total": 6.3
  }
]

​
Key Fields

FieldDescription
ricReuters Instrument Code
company_nameCompany name
marketCountry/market
mtd / ytdMonth-to-date and year-to-date returns (%)
pePrice-to-earnings ratio
ev_ebitdaEnterprise value to EBITDA
roeReturn on equity (%)
deDebt-to-equity ratio
mktcap_bMarket cap in billions (USD)
value / quality / momentum / defensive / tacticalParallax factor scores (0-10)
totalComposite Parallax score
recommendationSTRONG BUY, BUY, HOLD, SELL, STRONG SELL

​
Example

curl "https://api.chicago.global/v1/peers?symbol=AAPL" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Query Parameters

​
symbol
string
required

Stock symbol (e.g., AAPL, MSFT)

Response

Peer companies retrieved successfully

​
ric
string

Reuters Instrument Code

​
company_name
string

Company name

​
market
string

Country/market

​
mtd
number

Month-to-date return (%)

​
ytd
number

Year-to-date return (%)

​
pe
number

Price-to-earnings ratio

​
ev_ebitda
number

Enterprise value to EBITDA

​
roe
number

Return on equity (%)

​
de
number

Debt-to-equity ratio

​
mktcap_b
number

Market cap in billions (USD)

​
recommendation
string

STRONG BUY, BUY, HOLD, SELL, STRONG SELL

​
value
number

Parallax value score (0-10)

​
quality
number

Parallax quality score (0-10)

​
momentum
number

Parallax momentum score (0-10)

​
defensive
number

Parallax defensive score (0-10)

​
tactical
number

Parallax tactical score (0-10)

​
total
number

Composite Parallax score