Gainers & Losers

Retrieve top 10 gaining and losing stocks based on 5-minute interval price movements.

GET/3.0/market/performers

Description

This endpoint returns the top 10 gaining and losing stocks in the market with a 5-minute delay. Includes closing price, price change, percentage change, and trading volume for each stock.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

This endpoint does not accept any query parameters.

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": {
    "timestamp": "2025-12-11T14:30:00Z",
    "symbols": [
      {
        "symbol": "SSGC",
        "close": 32.43,
        "change": 1.11,
        "change_percent": 0.0354,
        "volume": 19473150
      },
      {
        "symbol": "NATF",
        "close": 78.50,
        "change": 2.15,
        "change_percent": 2.81,
        "volume": 1250000
      },
      {
        "symbol": "LUCK",
        "close": 545.00,
        "change": 12.50,
        "change_percent": 2.35,
        "volume": 850000
      },
      {
        "symbol": "PGLC",
        "close": 42.25,
        "change": 0.85,
        "change_percent": 2.05,
        "volume": 650000
      }
    ]
  }
}

Response Fields

Field	Type	Description
timestamp	string	Timestamp of the data (ISO 8601 format)
symbols	array	Array of top 10 gaining and losing stocks - View

Stock Fields (in gainers/losers array)

Field	Type	Description
symbol	string	Stock symbol
close	number	Last traded price (delayed by 5 minutes)
change	number	Absolute price change in PKR as of the delayed timestamp
change_percent	number	Percentage price change (%) as of the delayed timestamp
volume	number	Total trading volume for the day up to the delayed timestamp

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get Gainers and Losers

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

Use Cases

• Market Screening: Identify top gainers and losers quickly
• Trading Signals: Use extreme gainers/losers as potential trading signals
• Portfolio Monitoring: Track if your holdings are among top movers
• Market Sentiment Analysis: Gauge market direction from gainers/losers ratio
• Intraday Trading: Monitor short-term price movements
• Real-time Market Updates: Get latest market performers