nepalstock.com.np APInepalstock.com.np ↗
Access real-time NEPSE indices, stock prices, market summaries, top performers, and historical OHLC data for all securities listed on Nepal's stock exchange.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/200a3fbe-2c84-436d-8f67-6c08621de86e/get_nepse_index' \ -H 'X-API-Key: $PARSE_API_KEY'
Get current values and changes for various NEPSE indices including NEPSE Index, Sensitive Index, Float Index, and Sensitive Float Index.
No input parameters required.
{
"type": "array",
"fields": {
"id": "integer index identifier",
"low": "number low value",
"high": "number high value",
"close": "number closing value",
"index": "string name of the index",
"change": "number absolute change",
"perChange": "number percentage change",
"currentValue": "number current index value",
"previousClose": "number previous day close value",
"fiftyTwoWeekLow": "number 52-week low",
"fiftyTwoWeekHigh": "number 52-week high"
},
"sample": {
"data": [
{
"id": 58,
"low": 2720.4145,
"high": 2747.8489,
"close": 2744.41,
"index": "NEPSE Index",
"change": -4.15,
"auditId": null,
"perChange": -0.15,
"currentValue": 2740.25,
"generatedTime": "2026-05-13T15:17:57.747",
"previousClose": 2740.2544,
"exchangeIndexId": null,
"fiftyTwoWeekLow": 2487.18,
"fiftyTwoWeekHigh": 3002.08
}
],
"status": "success"
}
}About the nepalstock.com.np API
This API exposes 7 endpoints covering Nepal Stock Exchange (NEPSE) market data, from live index values to per-security OHLC details. Use get_nepse_index to retrieve current values, percentage changes, and 52-week lows across four major NEPSE indices, or call get_today_prices to pull closing prices, volumes, and percentage changes for every security traded on a given day.
Market Indices and Daily Prices
get_nepse_index returns live data for the NEPSE Index, Sensitive Index, Float Index, and Sensitive Float Index. Each entry includes currentValue, change, perChange, previousClose, high, low, and fiftyTwoWeekLow. get_today_prices returns a flat list of all securities traded on the main NEPSE board (index ID 58), with fields like symbol, closePrice, lastTradedPrice, percentageChange, and totalTradeQuantity per security.
Stock Search and Detail
search_stocks accepts an optional query parameter for case-insensitive partial matching against symbol or company name. It returns id, symbol, securityName, and activeStatus — useful for resolving a ticker before passing it to get_stock_detail. That endpoint accepts either a symbol string (e.g., NABIL) or a numeric security ID and returns two nested objects: securityData (sector, email, active status) and securityMcsData (open, high, low, close, previous close, last traded price, total trade quantity).
Market Summary and Top Performers
get_market_summary returns key market-wide metrics as value/detail pairs covering total turnover, traded shares, transactions, scrips traded, and market capitalization. get_top_performers ranks up to 10 securities by one of five criteria: gainer, loser, turnover, volume, or transaction. Each result includes ltp, pointChange, percentageChange, symbol, and securityName.
Historical Index Data
get_index_history returns paginated daily OHLC data for a chosen index. Supported index IDs are 58 (NEPSE), 57 (Sensitive), 62 (Float), and 63 (Sensitive Float). Each page contains up to 20 records ordered most-recent first, with businessDate, closingIndex, openIndex, highIndex, lowIndex, turnoverValue, and turnoverVol. The response also includes totalPages and totalElements so clients can paginate through the full history.
- Display a live NEPSE dashboard showing current index values and percentage changes for all four major indices.
- Screen all traded securities by percentage change or volume using get_today_prices to identify movers at market close.
- Build a stock lookup tool that resolves partial company names or symbols via search_stocks before fetching OHLC detail.
- Track NEPSE market capitalization and total turnover over time using get_market_summary on a daily schedule.
- Populate a top-gainers and top-losers widget using get_top_performers with the gainer and loser type parameters.
- Plot historical index performance charts by paginating through get_index_history for the NEPSE or Sensitive Index.
- Alert users when a specific security's percentageChange crosses a threshold by monitoring get_today_prices output.
| 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 Nepal Stock Exchange (nepalstock.com.np) offer an official developer API?+
What does get_top_performers return and how is the type parameter used?+
type parameter accepts one of five values: gainer, loser, turnover, volume, or transaction. Each result includes symbol, securityName, ltp, pointChange, and percentageChange. If no type is supplied, the default ranking is applied.How is pagination handled in get_index_history?+
totalPages and totalElements so you can determine how many additional requests are needed to retrieve the full history for a given index ID.