Catalog

Search market indices in the Sugra Catalog

Changed on

Search market indices by category or a free-text name query. Both filters are optional and combined with AND.

get/api/v1/catalog/indices

Request

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

Query parameters

categorystring nullable

Index category to filter by (exact match).

qstring nullable

Free-text search over the index name.

limitinteger

Maximum number of indices to return.

offsetinteger

Number of indices to skip (pagination).

Response

Matching indices, 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