List All Market Sectors

Retrieve every market sector classification available in the ROIC.ai API. Each entry returns the sector name and a count of how many companies belong to that sector. Use this endpoint to build sector-based stock screeners, create sector allocation charts, or populate filter menus with up-to-date sector options.

Sectors represent the broadest level of industry classification (e.g., Technology, Healthcare, Financials, Energy) - For more granular classifications, see the Industries endpoint. Results are live.

GEThttps://api.roic.ai/v2/sectors/list
Request
curl "https://api.roic.ai/v2/sectors/list?apikey=YOUR_API_KEY"
Response
200 OK
[
  {
    "sector": "Technology",
    "ticker_count": 1200
  },
  {
    "sector": "Healthcare",
    "ticker_count": 950
  }
]

Parameters

Query parameters

formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel

Response

Response fields

sectorstring

Name of the market sector, e.g. Technology. Values match the sector field on company profiles.

ticker_countnumber

Number of companies classified in this sector.

Use Cases

  • Populate sector filter dropdowns in a stock screener with live company counts
  • Build a sector allocation pie chart showing the distribution of companies across sectors
  • Create sector-based watchlists or portfolio groupings
  • Compare sector coverage across different time periods to identify market trends
  • Validate sector names before using them in filtered queries

Related Endpoints