Single Symbol Overview

Retrieve the most recent snapshot of a single stock ticker including pricing, sector, valuation metrics, and market data.

GET/3.0/market/stock

Description

This endpoint returns a comprehensive snapshot of a single stock symbol including current price, trading volume, market capitalization, P/E ratio, dividend yield, and the indices it's listed in. This is ideal for quick lookups of a specific company's market data.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
symbol	string	Yes	Stock symbol/ticker code	BAFS

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data":{
    "date": "2025-12-11 12:26:54",
    "symbol": "BAFS",
    "name": "Baba Farid Sugar Mills Limited",
    "sector": "0826",
    "type": 1,
    "status": 1,
    "open": 337,
    "high": 337,
    "low": 325,
    "close": 332.99,
    "volume": 1412,
    "ldcp": 330.88,
    "change": 2.11,
    "ldcv": 227,
    "change_percent": 0.0064,
    "bid_price": 326.05,
    "bid_volume": 50,
    "ask_price": 332.99,
    "ask_volume": 8,
    "high52": 388.42,
    "low52": 41,
    "ucap": 363.97,
    "lcap": 297.79,
    "shares": 9450000,
    "free_float": 472500,
    "market_cap": 3146755500,
    "listed_in": [
        "ALLSHR"
    ],
    "haircut": 42.5,
    "xb": false,
    "xd": false,
    "xr": false,
    "sd": false
  }
}

Response Fields

Field	Type	Description
date	string	Data timestamp (YYYY-MM-DD HH:MM:SS)
symbol	string	Stock symbol/ticker
name	string	Company name
sector	string	Sector classification
type	number	Stock type ( 1- Company, 2 - Rights, 5 - Defaulter)
status	number	Stock status (0 - Inactive, 1 - Active, 2 - Suspended, 3 - Hidden)
open	number	Opening price
high	number	Highest price
low	number	Lowest price
close	number	Closing price
volume	number	Trading volume
ldcp	number	Last day close price
change	number	Absolute price change
ldcv	number	Last day close volume
change_percent	number	Percentage price change
bid_price	number	Current bid price
bid_volume	number	Bid volume
ask_price	number	Current ask price
ask_volume	number	Ask volume
high52	number	52-week high price
low52	number	52-week low price
ucap	number	Upper circuit price
lcap	number	Lower circuit price
shares	number	Total shares outstanding
free_float	number	Free float shares
market_cap	number	Market capitalization
listed_in	array	Indices the stock is listed in
haircut	number	Margin haircut percentage
xb	boolean	XB flag (ex-bonus)
xd	boolean	XD flag (ex-dividend)
xr	boolean	XR flag (ex-rights)
sd	boolean	SD flag (ex-specie-dividend)

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Symbol (200)

{
  "status": "error",
  "message": "symbol not provided"
}

Stock Not Found (200)

{
  "status": "error",
  "message": "not found"
}

Examples

Get Single Stock Overview

curl -X GET "https://csapis.com/3.0/market/stock?symbol=UBLPETF" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Stock Quick Look: Get a snapshot of a specific stock's current performance
• Valuation Analysis: Review P/E ratio and dividend yield
• Technical Analysis: Access pivot points and support/resistance levels
• Portfolio Tracking: Monitor individual stock holdings
• Investment Decision: Compare valuation metrics across stocks