Sector Overview

Retrieve comprehensive overview information for a specific market sector.

GET/3.0/sectors/overview

Description

This endpoint returns detailed overview information for a market sector including market capitalization, number of constituents, price-to-earnings ratio, dividend yield, and other key sector metrics.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

This endpoint does not require any parameters.

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
      {
          "code": "BANKING",
          "name": "Banking & Financial Services",
          "market_cap": 15420000000000,
          "constituents": 14,
          "pe": 8.45,
          "dy": 5.32
      },
      {
          "code": "CEMENT",
          "name": "Cement & Building Materials",
          "market_cap": 2850000000000,
          "constituents": 8,
          "pe": 9.12,
          "dy": 3.45
      },
      {
          "code": "ENERGY",
          "name": "Energy & Power",
          "market_cap": 3200000000000,
          "constituents": 12,
          "pe": 7.89,
          "dy": 6.78
      }
  ]
}

Response Fields

Field	Type	Description
code	string	Sector code identifier
name	string	Full sector name
market_cap	number	Total sector market capitalization (PKR)
constituents	integer	Number of companies in the sector
pe	number	Average sector price-to-earnings ratio
dy	number	Average sector dividend yield (%)

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get Banking Sector Overview

curl -X GET "https://csapis.com/3.0/sectors/overview" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Sector Analysis: Get comprehensive sector metrics and composition
• Investment Screening: Identify sector performance and valuation metrics
• Portfolio Management: Monitor sector allocation and performance
• Comparative Analysis: Compare sector metrics with market averages
• Constituent Tracking: Track companies within specific sectors
• Valuation Analysis: Analyze sector-level valuation ratios