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 for the current 5-minute interval. Includes closing price, price change, percentage change, and trading volume for each stock.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
interval	string	No	Time interval (5m, 15m, 1h, 1d). Default is 5m	5m

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": {
    "interval": "5m",
    "timestamp": "2025-12-11T14:30:00Z",
    "symbols": [
      {
        "symbol": "GLANCE",
        "close": 135.50,
        "change": 4.25,
        "change_percent": 3.24,
        "volume": 2850000
      },
      {
        "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
interval	string	Time interval for the data (5m, 15m, 1h, 1d)
timestamp	string	Timestamp of the data (ISO 8601 format)
symbols	array	Array of top 10 gaining stocks - View

Stock Fields (in gainers/losers array)

Field	Type	Description
symbol	string	Stock symbol
close	number	Closing price for the interval
change	number	Absolute price change (PKR)
change_percent	number	Percentage change (%)
volume	number	Trading volume for the interval

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?interval=15m" \
  -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