dps.psx.com.pk APIdps.psx.com.pk ↗
Access PSX market data via API: live quotes, indices, sector summaries, financials, dividends, and announcements for all listed companies on the Pakistan Stock Exchange.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/0f3edd12-1750-4749-9b05-539f1e94db49/get_symbols' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all listed symbols with their names and sectors on the Pakistan Stock Exchange.
No input parameters required.
{
"type": "array",
"fields": {
"name": "string - company or instrument name",
"isETF": "boolean - whether the instrument is an ETF",
"isDebt": "boolean - whether the instrument is a debt security",
"symbol": "string - ticker symbol",
"sectorName": "string - sector classification"
},
"sample": {
"data": [
{
"name": "Askari Bank(TFC6)",
"isETF": false,
"isDebt": true,
"symbol": "AKBLTFC6",
"sectorName": "BILLS AND BONDS"
}
],
"status": "success"
}
}About the dps.psx.com.pk API
This API covers 11 endpoints for the Pakistan Stock Exchange Data Portal (dps.psx.com.pk), returning live quotes, market indices, sector breakdowns, financial highlights, payout history, and company announcements. The get_stock_quote endpoint delivers current price, P/E ratio, market cap, free float, and trading statistics for any listed symbol. The get_symbols endpoint enumerates every listed instrument with sector classification and flags for ETF and debt instruments.
Market Data and Quotes
The get_market_summary endpoint returns board-level trading statistics — trades, volume, and value — alongside top index values with daily change and percent change. For granular per-stock data, get_trading_panel exposes the live trading board with bid/offer prices, bid/offer volumes, last day closing price (LDCP), and traded volume. The board_type parameter accepts REG (regular equity), FUT (deliverable futures), CSF (cash settled futures), and ODL (odd lot). Note that only the REG board reliably returns data outside market hours.
Indices and Constituents
get_market_indices lists all PSX indices with high, low, volume, 52-week range, YTD change, and previous close. To drill into an index, get_index_constituents accepts a named index — KSE100, KSE30, KMI30, ALLSHR, PSXDIV20, and others — and returns each constituent's current price, change, volume, and contribution to index points (indexPoints). This makes it straightforward to decompose which stocks are driving a given index's movement on any given day.
Company-Level Data
get_stock_financials returns annual and quarterly highlights for a given symbol, structured as a headers array (year or quarter labels) plus rows of metric values covering Sales, Profit, EPS, and margins. get_stock_payouts provides full dividend history per symbol, including announcement date, book closure date range, payout details (percentage and type), and the financial period each payout references. get_stock_announcements supports filtering by symbol and by announcement type (C for company, E for exchange, CDC, SECP, NCCPL), and returns a PDF download link where available.
Listings and Sector Coverage
get_listings enumerates all main-board companies with their sector, total outstanding shares, and free float. get_sector_summary aggregates trading activity by sector, returning advance/decline counts, turnover volume, and market cap in billions alongside the PSX sector code. Together these endpoints give a complete cross-sectional view of the exchange without requiring per-symbol iteration.
- Building a PSX portfolio tracker that pulls live bid/offer prices via
get_trading_paneland calculates unrealized P&L. - Screening stocks by sector using
get_sector_summaryadvance/decline ratios and market cap to identify sector rotation. - Monitoring dividend calendars by ingesting
get_stock_payoutsbook closure dates for multiple symbols. - Aggregating company announcements via
get_stock_announcementswith type C to trigger alerts on regulatory filings or results. - Constructing index-tracking spreadsheets using
get_index_constituentsindex points contributions for KSE100 or KMI30. - Charting annual EPS and profit trends from
get_stock_financialsquarterly headers across multiple listed companies. - Populating a symbol lookup service with
get_symbolsto classify instruments as equity, ETF, or debt across all PSX sectors.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Pakistan Stock Exchange have an official developer API?+
What does `get_stock_quote` return beyond the current price?+
get_stock_quote returns a stats object that includes Open, High, Low, Volume, LDCP, P/E Ratio, Market Cap, total Shares, and Free Float for the requested symbol, along with the price change and percentage change. The symbol parameter is required — there is no bulk quote endpoint that returns all symbols in one call.Are there any known limitations with the `get_trading_panel` endpoint?+
Does the API return historical OHLCV price series for individual stocks?+
Can I retrieve announcements for all company types, including SECP and NCCPL filings?+
get_stock_announcements endpoint accepts type values C, E, CDC, SECP, and NCCPL, but type C (company announcements) is the most reliable. Other types may return inconsistent results. Filtering by symbol is only meaningful for type C; regulatory bodies like SECP do not map cleanly to individual stock symbols.