Symbol Returns

Retrieve the opening price of individual symbols across various time periods.

GET/3.0/market/stocks/returns

Description

This endpoint returns the opening price for individual stocks across multiple time periods including 1 week, 1 month, 3 months, 6 months, and 1 year. 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": "2026-06-22 12:24:07",
            "symbol": "FEROZ",
            "name": "Ferozsons Laboratories Limited",
            "c1w": 402.49,
            "c1m": 374.18,
            "c3m": 314.33,
            "c6m": 368.47,
            "c1y": 362.9,
            "cytd": 375.74,
            "cfy": 389.62
        },
        {
            "date": "2019-03-27 16:12:23",
            "symbol": "HSMR2",
            "name": "Husein Sugar (R)",
            "c1w": 0,
            "c1m": 0,
            "c3m": 0,
            "c6m": 0,
            "c1y": 0,
            "cytd": 0,
            "cfy": 0
        }
    ]
}

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	Opening price for the 1 week period
c1m	number	Opening price for the 1 month period
c3m	number	Opening price for the 3 month period
c6m	number	Opening price for the 6 month period
c1y	number	Opening price for the 1 year period
cytd	number	Opening price for the year-to-date period
cfy	number	Opening price for the fiscal year period

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/returns" \
  -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