Subsector Report

Returns a comprehensive report for an IDX subsector, organized into distinct sections. Use sections to fetch only the data you need.

The sub_sector path parameter must be in kebab-case format. Get valid values from the Subsectors endpoint. E.g. banks, utilities, food-beverage.

Available sections

• statistics: Company count, median PE, weighted avg PE, min/max PE
• market_cap: Total and avg market cap, quarterly market cap trend, mcap change (1w/1y/YTD)
• stability: Weighted max drawdown, weighted relative standard deviation
• valuation: Historical PB, PE, PS, PCF by year
• growth: Weighted avg revenue and earnings growth
• companies: List of companies in the subsector with key metrics

GET /v2/subsector/report/{sub_sector}

Subsector Report

cURL

curl --request GET \
  --url https://api.sectors.app/v2/subsector/report/{sub_sector}/ \
  --header 'Authorization: <api-key>'

200

{
  "sector": "Financials",
  "sub_sector": "Banks",
  "statistics": {
    "total_companies": 47,
    "filtered_median_pe": 11.2,
    "filtered_weighted_avg_pe": 12.8,
    "min_company_pe": 3.1,
    "max_company_pe": 42.5
  },
  "market_cap": {
    "total_market_cap": 3200000000000000,
    "avg_market_cap": 68085106382978.7
  },
  "stability": {
    "weighted_max_drawdown": -0.18,
    "weighted_rsd_close": 0.12
  }
}

Authorizations

ApiKeyAuthOAuthBearerAuth

Authorization · string · header · required

API key passed directly in the Authorization header (without Bearer prefix).

Path Parameters

sub_sector · string · required

Kebab-case subsector slug. E.g. banks, utilities. Get valid values from the Subsectors endpoint.

Query Parameters

sections · string

Comma-separated sections to include. Default: all. Options: statistics, market_cap, stability, valuation, growth, companies.

Response

200

application/json

Subsector report with requested sections.

{key} · any