Skip to main content
GET
/
v1
/
etf
/
scores
ETF Scores
curl --request GET \
  --url https://api.chicago.global/v1/etf/scores \
  --header 'Authorization: Bearer <token>'
{
  "symbol": "SPY.P",
  "value": 4,
  "quality": 8,
  "momentum": 6,
  "defensive": 8,
  "tactical": 6,
  "total": 5.9,
  "recommendation": "HOLD",
  "holdings_covered": 495,
  "weight_covered": 98.37
}

Documentation Index

Fetch the complete documentation index at: https://docs.chicago.global/llms.txt

Use this file to discover all available pages before exploring further.

Get Parallax factor scores for an ETF, calculated as weighted averages across its holdings.

​
Query Parameters

ParameterTypeRequiredDescription
symbolstringYesETF symbol (e.g., SPY, QQQ). Comma-separated for multiple.

​
Response

{
  "symbol": "SPY.P",
  "value": 4.0,
  "quality": 8.0,
  "momentum": 6.0,
  "defensive": 8.0,
  "tactical": 6.0,
  "total": 5.9,
  "recommendation": "HOLD",
  "holdings_covered": 495,
  "weight_covered": 98.37
}

​
Key Fields

FieldDescription
valueValue factor score (0-10)
qualityQuality factor score (0-10)
momentumMomentum factor score (0-10)
defensiveDefensive factor score (0-10)
tacticalTactical factor score (0-10)
totalComposite score (0-10)
recommendationOverall recommendation based on composite score
holdings_coveredNumber of ETF holdings that have Parallax scores
weight_coveredPercentage of ETF weight covered by scored holdings
Scores are weighted averages based on each holding’s weight in the ETF. ETFs with low weight_covered may have less reliable scores.

​
Example

curl "https://api.chicago.global/v1/etf/scores?symbol=QQQ" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Query Parameters

​
symbol
string
required

ETF symbol (e.g., SPY, QQQ). Comma-separated for multiple.

Response

ETF scores retrieved successfully

​
symbol
string

Resolved primary RIC

​
value
number

Value factor score (0-10)

​
quality
number

Quality factor score (0-10)

​
momentum
number

Momentum factor score (0-10)

​
defensive
number

Defensive factor score (0-10)

​
tactical
number

Tactical factor score (0-10)

​
total
number

Composite score (0-10)

​
recommendation
string

Overall recommendation

​
holdings_covered
integer

Number of ETF holdings with Parallax scores

​
weight_covered
number

Percentage of ETF weight covered by scored holdings