---
title: "Search exchange-traded funds and products by ticker, fund name, sponsor or ISIN, US and other exchanges. US ETF identity comes from the authoritative active security-type directory, with SEC series facts attached when a matching Form NPORT-P series is stored; a fund listed on another exchange (MIC:TICKER, with its exchange, currency and ISIN) is one the exchange's directory lists and the EU instrument register files as an exchange-traded fund, commodity or note. US matches come first, largest net assets first, then other exchanges in listing-search order."
method: GET
path: "/v1/etfs"
tags: ["Etfs"]
---

# Search exchange-traded funds and products by ticker, fund name, sponsor or ISIN, US and other exchanges. US ETF identity comes from the authoritative active security-type directory, with SEC series facts attached when a matching Form NPORT-P series is stored; a fund listed on another exchange (MIC:TICKER, with its exchange, currency and ISIN) is one the exchange's directory lists and the EU instrument register files as an exchange-traded fund, commodity or note. US matches come first, largest net assets first, then other exchanges in listing-search order.

`GET /v1/etfs`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/etfs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/etfs/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `query` string, required
- `exchange` string
- `limit` integer

## Response `200`

OK

- EtfSearchResponse: Result of an ETF directory search. Matching is substring-based across ticker, fund name and sponsor.
  - `totalMatches` integer: Total listings matching the query across all pages and exchanges searched, before limit is applied.
  - `data` EtfSummaryDto[], nullable: Matching listings: US ETFs first, largest net assets first, then funds listed on other exchanges.
    - `ticker` string, nullable: The exchange-traded ticker, normalized to dash-listed form; MIC:TICKER for a fund listed outside the US.
    - `name` string, nullable: SEC series name, or the listing's own registered security name when the ticker is that listing's own primary ticker; null when neither is stated.
    - `sponsor` string, nullable: Registrant that files the series; null when no series is linked.
    - `structure` string, nullable: Registration form the series files under, in plain words.
    - `netAssets` number, double, nullable: Net assets in US dollars from the latest report; null when no series is linked.
    - `holdingCount` integer, nullable: Holding rows stored for the latest report; null when no series is linked.
    - `reportPeriodDate` string, date, nullable: Date the latest reported portfolio is as of.
    - `exchange` string, nullable: The ISO 10383 market identifier code of a fund listed outside the US; absent for a US listing.
    - `currency` string, nullable: ISO 4217 currency a fund listed outside the US trades and is priced in, in major units; absent for a US listing, which is in US dollars.
    - `isin` string, nullable: ISIN of a fund listed outside the US; absent for a US listing.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)