Skip to main content
POST
Find by details

Authorizations

X-API-KEY
string
header
required

Body

application/json

Request body for finding ETFs. Each field is optional. However, you must provide at least one field to perform a valid search. The values a filter accepts can be listed with GET /v1/knowledge-graph/etfs/values/{filter}.

query
string

Text query to search for ETFs by name, ticker, or description. Examples: 'Gold', 'SPDR', 'Vanguard'

Example:

"Gold"

statuses
string[]

Filter ETFs by listing status, as published in the status field of results (e.g., 'Active')

Example:
countries
string[]

Country codes using the ISO 3166-1 A-2 format (e.g., 'US' for United States, 'FR' for France, 'GB' for Great Britain)

Pattern: ^[A-Z]{2}$
Example:
sectors
string[]

Sector classification, as published in the sector field of results. It accepts the same list of sectors as companies, which can be retrieved with the endpoint "/knowledge-graph/companies/sectors"

Example:

Response

200 - application/json

Successful response with ETF data

Response containing ETF results and metadata

results
object[]
required

Array of ETF results

metadata
object
required
usage
object

Optional. Present for token-billing accounts only. Reports the number of tokens consumed by this request.