Skip to main content

​
GET /v1/market/universe

Browse the full ticker universe with pagination, filtering by exchange, type, sector, industry, and search
Audience: application and coding agent.

​
Query parameters

ParameterTypeDescription
exchangestringFilter by primary exchange (e.g. XNYS, XNAS)
typestringFilter by security type (e.g. CS, ETF, ADRC)
sectorstringFilter by GICS-style sector (e.g. Technology, Healthcare)
industrystringFilter by industry classification
activebooleanFilter by active listing status
has_figibooleanOnly tickers with a composite FIGI
has_cikbooleanOnly tickers with a SEC CIK
searchstringCase-insensitive search across symbol and company name
limitintegerPage size (default 100, max 1000)
cursorintegerPagination offset

​
Canonical metadata

  • requestId
  • traceparent

​
Example request

curl -X GET \
  -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/market/universe?exchange=XNYS&sector=Technology&limit=5"

​
Example response

{
  "object": "list",
  "data": [
    {
      "object": "universe_ticker",
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "displayName": "Apple",
      "primaryExchange": "XNAS",
      "securityType": "CS",
      "active": true,
      "currency": "USD",
      "cik": "0000320193",
      "compositeFigi": "BBG000B9XRY4",
      "shareClassFigi": "BBG001S5N8V8",
      "marketCap": 3400000000000,
      "listDate": "1980-12-12",
      "sicCode": "3571",
      "sicDescription": "Electronic Computers",
      "sector": "Technology",
      "industry": "Computer Hardware",
      "asOf": "2026-03-30T00:00:00.000Z"
    }
  ],
  "totalCount": 2845,
  "hasMore": true,
  "nextCursor": "5",
  "configured": true,
  "requestId": "req_example_123",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

​
Give this prompt to your agent

​
Failure posture

  • treat non-2xx responses as contract-aware failures, not free-form errors
  • preserve requestId and traceparent in logs and downstream reports