Company/Symbol Returns

Retrieve performance returns for individual companies and symbols across various time periods.

GET/3.0/market/stocks/stats

Description

This endpoint returns detailed return statistics for individual stocks across multiple time periods including 1 week, 1 month, 3 months, 6 months, and 1 year returns. Useful for analyzing stock performance and comparative analysis.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

This endpoint does not accept any query parameters.

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
      {
          "date": "2025-10-03 16:37:55",
          "symbol": "BELA",
          "name": "Bela Automotives Limited",
          "c1w": 120.07,
          "c1m": 125.84,
          "c3m": 111.67,
          "c6m": 156.11,
          "c1y": 167.17,
          "cytd": 171.06,
          "cfy": 116.42,
          "c5y": 1.3
      },
      {
          "date": "2025-01-03 16:47:18",
          "symbol": "DAWH",
          "name": "Dawood Hercules Corporation Limited",
          "c1w": 275.28,
          "c1m": 275.28,
          "c3m": 275.28,
          "c6m": 275.28,
          "c1y": 141.5,
          "cytd": 259.81,
          "cfy": 275.28,
          "c5y": 121
      }
  ]
}

Response Fields

Field	Type	Description
date	string	Timestamp of the data (YYYY-MM-DD HH:MM:SS)
symbol	string	Stock symbol/ticker
name	string	Full company name
c1w	number	1-week return value
c1m	number	1-month return value
c3m	number	3-month return value
c6m	number	6-month return value
c1y	number	1-year return value
cytd	number	Year-to-date return value
cfy	number	Fiscal year return value
c5y	number	5-year return value

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get Returns for Stock

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

Use Cases

• Performance Analysis: Compare stock returns across periods
• Investment Screening: Identify best/worst performing stocks
• Portfolio Analysis: Evaluate portfolio constituent performance
• Return Comparison: Compare returns between stocks
• Trading Signals: Use performance trends for trading decisions
• Performance Benchmarking: Compare individual stock performance with market