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": "0820",
            "name": "OIL & GAS EXPLORATION COMPANIES",
            "market_cap": 3091595590061.6797,
            "constituents": 4,
            "pe": 8.95895662,
            "dy": 0.05
        },
        {
            "code": "0821",
            "name": "OIL & GAS MARKETING COMPANIES",
            "market_cap": 447091796838.26,
            "constituents": 10,
            "pe": 5.46055148,
            "dy": 0.036
        },
        {
            "code": "0824",
            "name": "POWER GENERATION & DISTRIBUTION",
            "market_cap": 655413769953.69,
            "constituents": 16,
            "pe": 20.42324119,
            "dy": 0.0797
        },
        {
            "code": "0803",
            "name": "CABLE & ELECTRICAL GOODS",
            "market_cap": 84836410972.21999,
            "constituents": 7,
            "pe": 14.95607815,
            "dy": 0.0041
        }
    ]
}

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