Skip to main content
GET
/
v1
/
etf
/
validate
Validate ETF Symbol
curl --request GET \
  --url https://api.chicago.global/v1/etf/validate \
  --header 'Authorization: Bearer <token>'
{ "valid": true, "symbol": "SPY", "primary_symbol": "SPY.P" }
Check if an ETF symbol is valid and get its resolved primary RIC.

​
Query Parameters

ParameterTypeRequiredDescription
symbolstringYesETF symbol to validate (e.g., SPY, QQQ)

​
Response

Valid symbol: 
{
  "valid": true,
  "symbol": "SPY",
  "primary_symbol": "SPY.P"
}
Invalid symbol: 
{
  "valid": false,
  "symbol": "FAKE123",
  "primary_symbol": null,
  "error": "ETF symbol 'FAKE123' not found in IDENTIFIERS"
}
This endpoint always returns 200, even for invalid symbols. Check the valid field to determine if the symbol was found.

​
Example

curl "https://api.chicago.global/v1/etf/validate?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 to validate (e.g., SPY, QQQ)

Response

Validation result

​
valid
boolean

Whether the symbol is valid

​
symbol
string

The symbol that was queried

​
primary_symbol
string | null

Resolved primary RIC (null if invalid)

​
error
string

Error message (only present for invalid symbols)