Catalog

Search ETFs in the Sugra Catalog

Changed on

Search exchange-traded funds by category, fund family, listing exchange, or a free-text name query. All filters are optional and combined with AND.

get/api/v1/catalog/etfs

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/catalog/etfs
  • Auth: API key in header x-api-key

Query parameters

categorystring nullable

ETF category to filter by (exact match).

familystring nullable

Fund family / sponsor to filter by (exact match).

exchangestring nullable

Listing exchange to filter by (exact match).

qstring nullable

Free-text search over the ETF name.

limitinteger

Maximum number of ETFs to return.

offsetinteger

Number of ETFs to skip (pagination).

Response

Matching ETFs, plus the total match count for pagination.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes