NepseAlpha APInepsealpha.com ↗
Access live NEPSE prices, historical OHLCV, sector performance, technical/fundamental signals, risk metrics, and divergence scans via the NepseAlpha API.
What is the NepseAlpha API?
The NepseAlpha API exposes 13 endpoints covering Nepal Stock Exchange (NEPSE) market data, from real-time price snapshots to multi-factor risk assessments. get_live_market returns the current NEPSE index level, per-stock OHLC, market open/closed status, top gainers/losers, and aggregate turnover in a single call. Other endpoints deliver historical OHLCV candles, sector-level PE/PB/ROE metrics, RSI and A/D divergence scans, and fundamental ratio signals across all listed stocks.
curl -X GET 'https://api.parse.bot/scraper/646d18ff-34ab-4123-becc-9b1b6b35031e/search_symbol?limit=10&query=NABIL' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search over NEPSE-listed stocks by company name or ticker symbol. Returns matching stocks with metadata including symbol, name, sector, and exchange. The limit parameter caps total results returned by the upstream API.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return from the search |
| queryrequired | string | Search keyword matching company name or stock symbol (e.g. NABIL, Himalayan) |
{
"type": "object",
"fields": {
"total": "integer count of results returned",
"results": "array of stock objects each with symbol, full_name, description, exchange, type, sector"
},
"sample": {
"data": {
"total": 9,
"results": [
{
"type": "stock",
"sector": "BANKING",
"symbol": "NABIL",
"exchange": "Commercial Banks src:Nepsealpha.com",
"full_name": "NABIL",
"is_master": true,
"logo_urls": [
"/storage/stock-full-names/alpha-stocks/66e4090d005f21726220557.png"
],
"description": "Nabil Bank Limited",
"exchange_logo": [
"/storage/stock-full-names/alpha-stocks/66e4090d005f21726220557.png"
]
}
]
},
"status": "success"
}
}About the NepseAlpha API
Market Data Coverage
get_live_market returns a real-time snapshot that includes a stock_live array (symbol, open, high, low, close, percent_change, volume, turn_over), the current NEPSE index today_price and percent_change, a looser_gainer list of top movers by gain and turnover, and a marketSummary with total turnover, traded shares, and transaction counts. The boolean is_market_open flag lets you gate downstream logic without maintaining your own trading-calendar logic.
Historical and Charting Data
get_historical_price_data accepts a symbol, start_date, end_date, and optional time_frame to return daily, weekly, or monthly OHLCV records ordered most-recent-first. For TradingView-compatible charting, get_tradingview_history returns the same data in parallel arrays (o, h, l, c, v, t) where t values are Unix timestamps. The 1D resolution is the most reliable option for this endpoint. Both endpoints accept the NEPSE composite index as a symbol in addition to individual stock tickers.
Technical and Fundamental Signals
get_technical_signals returns a signal per listed stock that includes RSI 14, MACD vs Signal Line, Bollinger Band %B, MFI, Stochastic, CCI, volume trend, and an overall Technical Summary rating such as "Strong Bullish" or "Weak Bearish", plus computed entry and exit price levels. get_fundamental_signals covers PE, PB, ROE, ROA, PEG, dividend yield, payout ratio, and Graham number discount alongside sector-relative valuations. get_risk_assessment adds beta, alpha, Sharpe ratio, daily volatility, VaR (95%), Piotroski F-score, Altman Z-score, and G-score for every stock.
Divergence Scanning
get_rsi_divergence and get_ad_divergence scan all NEPSE-listed stocks (or a single symbol) for bullish and bearish divergence patterns. Both accept a lookback parameter to widen or narrow the detection window. Response objects include symbols_scanned and symbols_total so you can detect when the scan was capped before processing every stock. get_rsi_oversold_stocks is a focused filter that returns only stocks with RSI 14 between 25 and 35, useful as a quick screener without running a full divergence pass.
The NepseAlpha API is a managed, monitored endpoint for nepsealpha.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nepsealpha.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nepsealpha.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a NEPSE portfolio dashboard that polls
get_live_marketfor real-time prices and flags positions above a percent_change threshold. - Feed
get_tradingview_historycandle arrays directly into a TradingView Lightweight Charts widget for any NEPSE-listed stock. - Screen for undervalued stocks by filtering
get_fundamental_signalsresults where PE is below sector average and Graham number discount is positive. - Generate daily risk reports using
get_risk_assessmentfields: beta, Sharpe ratio, VaR 95%, and Altman Z-score per holding. - Run an end-of-day divergence alert by calling
get_rsi_divergencewith a 30-candle lookback and notifying on all newly detected bullish signals. - Track sector rotation by comparing
daily_gainandturnover_valuesacross all sectors fromget_sector_summary. - Pre-filter watchlists using
get_rsi_oversold_stocksto surface stocks with RSI 14 in the 25–35 range before deeper fundamental review.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does NepseAlpha have an official developer API?+
What does `get_live_market` return and how current is the data?+
get_live_market returns a full price array for all NEPSE-listed stocks (symbol, open, high, low, close, percent_change, volume, turn_over), the current NEPSE index level, top gainers/losers, market turnover totals, and an is_market_open boolean. Data refreshes intraday while the exchange is open; outside trading hours it reflects the most recent closing snapshot.Can I retrieve intraday (sub-daily) OHLCV candles?+
get_historical_price_data endpoint aggregates at daily, weekly, or monthly granularity via the time_frame parameter. The get_tradingview_history endpoint notes that the 1D resolution is the most reliable. Finer intraday candles are not currently exposed. You can fork this API on Parse and revise it to add sub-daily resolution if that data becomes available on the source.Does the divergence scan always process every listed stock?+
get_rsi_divergence and get_ad_divergence return symbols_scanned alongside symbols_total. If the scan hits an internal time cap before finishing, symbols_scanned will be less than symbols_total. Providing a specific symbol parameter limits the scan to a single stock and avoids the cap entirely.