Catalog

Search equities in the Sugra Catalog

Changed on

Search the catalog of listed companies. All filters are optional and combined with AND. Each result carries the company's listings (ticker, exchange, MIC, currency, identifiers). By default only companies with at least one active listing are returned; set include_delisted=true to include companies whose listings are all delisted.

get/api/v1/catalog/equities

Request

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

Query parameters

sectorstring nullable

Sector classification to filter by (exact match).

industrystring nullable

Industry to filter by (exact match).

countrystring nullable

Country of the company to filter by (exact match).

exchangestring nullable

Restrict to companies with a listing on this exchange.

market_capstring nullable

Market-capitalization bucket to filter by (exact match).

qstring nullable

Free-text search over the company name.

include_delistedboolean

Include companies whose only listings are delisted.

limitinteger

Maximum number of companies to return.

offsetinteger

Number of companies to skip (pagination).

Response

Matching companies with their listings, 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