Skip to main content
GET
/
v1
/
etf
/
search
ETF Search
curl --request GET \
  --url https://api.chicago.global/v1/etf/search \
  --header 'Authorization: Bearer <token>'
[
  {
    "symbol": "ZPDE.F",
    "name": "STST SPDR S&P U S EN.SEL SECT.UCITS ETF",
    "activity": "ACTIVE",
    "market": "GERMANY",
    "exchange": "XETRA",
    "currency": "EUR",
    "value": 6,
    "quality": 7,
    "momentum": 9,
    "defensive": 8,
    "tactical": 10,
    "total": 8.8,
    "recommendation": "STRONG BUY"
  }
]
Search and filter ETFs by name, market, currency, score, and recommendation.

​
Query Parameters

ParameterTypeRequiredDefaultDescription
querystringNo—Search ETF name (partial match, e.g., S&P, Vanguard)
marketstringNo—Filter by market (e.g., UNITED STATES, UNITED KINGDOM)
currencystringNo—Filter by currency (e.g., USD, EUR)
min_scorenumberNo—Minimum total Parallax score
max_scorenumberNo—Maximum total Parallax score
recommendationstringNo—Filter by recommendation (e.g., BUY, STRONG BUY)
activitystringNoACTIVEActivity filter
limitintegerNo20Max results (1-100)

​
Response

Returns an array of matching ETFs: 
[
  {
    "symbol": "ZPDE.F",
    "name": "STST SPDR S&P U S EN.SEL SECT.UCITS ETF",
    "activity": "ACTIVE",
    "market": "GERMANY",
    "exchange": "XETRA",
    "currency": "EUR",
    "value": 6.0,
    "quality": 7.0,
    "momentum": 9.0,
    "defensive": 8.0,
    "tactical": 10.0,
    "total": 8.8,
    "recommendation": "STRONG BUY"
  },
  {
    "symbol": "XEG.TO",
    "name": "ISHARES S&P/TSX CAPPED EN.IDX.ETF",
    "activity": "ACTIVE",
    "market": "CANADA",
    "exchange": "Toronto",
    "currency": "CAD",
    "value": 7.0,
    "quality": 8.0,
    "momentum": 7.0,
    "defensive": 7.0,
    "tactical": 9.0,
    "total": 8.6,
    "recommendation": "STRONG BUY"
  }
]

​
Examples

# Search by name
curl "https://api.chicago.global/v1/etf/search?query=Vanguard&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filter by market and minimum score
curl "https://api.chicago.global/v1/etf/search?market=UNITED%20STATES&min_score=8&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Find strong buy ETFs in USD
curl "https://api.chicago.global/v1/etf/search?currency=USD&recommendation=STRONG%20BUY&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Query Parameters

​
query
string

Search ETF name (partial match, e.g., S&P, Vanguard)

​
market
string

Filter by market (e.g., UNITED STATES, UNITED KINGDOM)

​
currency
string

Filter by currency (e.g., USD, EUR)

​
min_score
number

Minimum total Parallax score

​
max_score
number

Maximum total Parallax score

​
recommendation
string

Filter by recommendation (e.g., BUY, STRONG BUY)

​
activity
string
default:ACTIVE

Activity filter

​
limit
integer
default:20

Max results (1-100)

Required range: 1 <= x <= 100

Response

ETF search results

​
symbol
string

ETF symbol

​
name
string

ETF name

​
activity
string

Activity status

​
market
string

Market

​
exchange
string

Exchange

​
currency
string

Trading currency

​
value
number

Value score (0-10)

​
quality
number

Quality score (0-10)

​
momentum
number

Momentum score (0-10)

​
defensive
number

Defensive score (0-10)

​
tactical
number

Tactical score (0-10)

​
total
number

Composite score (0-10)

​
recommendation
string

Overall recommendation