All Symbols Overview
Retrieve the most recent snapshot of all stocks including pricing, sector, valuation metrics, and market data for the entire market.
GET/3.0/market/stocks
Description
This endpoint returns comprehensive snapshots of all stocks in the market including current prices, trading volumes, market capitalizations, P/E ratios, dividend yields, and the indices they're listed in. This is ideal for market-wide analysis and screening.
Request
Authentication
- Type: Bearer Token
- Required: Yes
Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
symbol | string | No | Comma-separated stock symbols to filter results | SYS,UNITY,TRG |
Response
Success Response (200)
{
"status": "ok",
"message": "",
"data": [
{
"date": "2025-12-11 12:38:06",
"symbol": "GGGL",
"name": "Ghani Global Glass Limited",
"sector": "0811",
"type": 1,
"status": 1,
"open": 10.69,
"high": 10.8,
"low": 10.47,
"close": 10.6,
"volume": 223415,
"ldcp": 10.56,
"change": 0.04,
"ldcv": 1843912,
"change_percent": 0.0038,
"bid_price": 10.57,
"bid_volume": 100,
"ask_price": 10.6,
"ask_volume": 487,
"high52": 14.47,
"low52": 6.92,
"ucap": 11.62,
"lcap": 9.5,
"shares": 240000000,
"free_float": 120000000,
"market_cap": 2544000000,
"listed_in": [
"ALLSHR",
"KMIALLSHR"
],
"xb": false,
"xd": false,
"xr": false,
"sd": false
},
{
"date": "2025-12-11 12:38:14",
"symbol": "MIRKS",
"name": "Mirpurkhas Sugar Mills Limited",
"sector": "0826",
"type": 1,
"status": 1,
"open": 39.11,
"high": 39.79,
"low": 39.11,
"close": 39.36,
"volume": 58181,
"ldcp": 39.59,
"change": -0.23,
"ldcv": 111006,
"change_percent": -0.0058,
"bid_price": 39.25,
"bid_volume": 337,
"ask_price": 39.3,
"ask_volume": 200,
"high52": 44.5,
"low52": 25,
"ucap": 43.55,
"lcap": 35.63,
"shares": 66557888,
"free_float": 29951050,
"market_cap": 2619718471.68,
"listed_in": [
"ALLSHR"
],
"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 |
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.
Examples
Get All Stocks Overview
curl -X GET "https://csapis.com/3.0/market/stocks" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Get Specific Symbols Overview
curl -X GET "https://csapis.com/3.0/market/stocks?symbol=GLANCE,HUBCO,AHCL" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Use Cases
- Market Screening: Screen all stocks by P/E ratio, dividend yield, or market cap
- Portfolio Analysis: Compare multiple stocks' performance metrics
- Index Replication: Track stocks in specific indices
- Sector Analysis: Compare stocks across different sectors
- Dividend Hunting: Find stocks with attractive dividend yields
- Technical Analysis: Review pivot points for multiple stocks