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"
  }
]

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.

Search ETFs by symbol or name with typo-tolerant fuzzy matching.

​
Query Parameters

ParameterTypeRequiredDefaultDescription
querystringYes—Search query (typo-tolerant, e.g., SPY, vanguard, gold, sp500)
marketstringNo—Filter by market (e.g., UNITED STATES, UNITED KINGDOM)
limitintegerNo20Max results (1-100)

​
Response

Returns an array of matching ETFs: 
[
  {
    "symbol": "VFV.TO",
    "name": "VANGUARD S&P 500 IX.ETF",
    "market": "CANADA",
    "exchange": "Toronto",
    "currency": "CAD"
  },
  {
    "symbol": "VGS.AX",
    "name": "VANGUARD MSCI INDEX INTL.SHARES ETF",
    "market": "AUSTRALIA",
    "exchange": "Australian SE",
    "currency": "AUD"
  }
]

​
Examples

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

# Search by symbol
curl "https://api.chicago.global/v1/etf/search?query=SPY" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filter by market
curl "https://api.chicago.global/v1/etf/search?query=gold&market=UNITED%20STATES&limit=10" \
  -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