Financial Data API

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

Parameters

Query Parameters

apikeystringrequired

Your API key for authentication.

formatstringoptional

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

Default: jsonValues: json, excel

Code Examples

curl "https://api.roic.ai/v2/sectors/list?apikey=YOUR_API_KEY"

Response

Response200 OK
[
  {
    "sector": "Technology",
    "ticker_count": 1200
  },
  {
    "sector": "Healthcare",
    "ticker_count": 950
  }
]

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