NepseAlpha APInepsealpha.com ↗
Access live NEPSE prices, historical OHLCV, sector metrics, technical and fundamental signals, risk scores, and broker holdings via the NepseAlpha API.
What is the NepseAlpha API?
The NepseAlpha API covers Nepal Stock Exchange data across 14 endpoints, returning everything from real-time price snapshots and historical OHLCV candles to technical signals, fundamental ratios, and broker-level floor-sheet holdings. The get_live_market endpoint delivers the current NEPSE index level, top gainers and losers, per-sector breakdowns, and a market-open boolean in a single call. Whether you need daily candles for a single ticker or a full-market RSI divergence scan, the endpoints are structured for direct integration.
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 and Price History
The get_live_market endpoint returns a real-time snapshot of all NEPSE-listed stocks including open, high, low, close, percent_change, volume, and turn_over per symbol, alongside the NEPSE index today_price, previous_close, and an is_market_open flag. For historical work, get_historical_price_data accepts a symbol, start_date, end_date, and an optional time_frame parameter to aggregate candles daily, weekly, or monthly. The companion get_tradingview_history endpoint returns the same data in parallel arrays (o, h, l, c, v, t) ready for TradingView-compatible charting libraries.
Technical and Fundamental Analysis Signals
get_technical_signals returns a pre-computed signal for every listed stock: RSI 14, MACD VS Signal Line, Bollinger Band %B, MFI, Stochastic, CCI, a volume trend flag, and an overall Technical Summary rating (Bullish/Bearish with strength level) plus computed entry and exit price levels. The get_fundamental_signals endpoint surfaces PE, PB, ROE, ROA, PEG, dividend yield, payout ratio, and Graham number discount for each stock. A sector filter parameter narrows results to a single sector (matched case-insensitively), and the include_debt flag attaches debt-to-equity and raw balance-sheet figures sourced from the latest quarterly report. Both endpoints return a total count alongside the signals array.
Risk Assessment and Divergence Scanning
get_risk_assessment provides per-stock quantitative risk metrics including _3_m_beta, alpha, sharpe_ratio, daily_volatility, var_95 (Value at Risk at 95% confidence), and Piotroski F-score, Altman Z-score, and G-score. The divergence endpoints—get_rsi_divergence and get_ad_divergence—scan either a single symbol or all listed stocks and return arrays of detected divergence objects. Each object carries type (bullish/bearish), strength, price and indicator trend directions, and a date. Both endpoints expose symbols_total and symbols_scanned counts so callers can detect partial scans caused by the time cap.
Broker Holdings and Company Financials
get_broker_holding accepts a symbol and a timeframe (weekly or monthly) and returns a brokers array with per-broker buy, sell, and net_quantity breakdowns, a summary object, daily_activity time series, and top_accumulators and top_distributors lists of up to ten brokers each. get_stock_financials returns the full particulars array from a company's published unaudited quarterly report, including total_assets, total_equity, debt_to_equity, and borrowings, denominated in NPR thousands. Quarter and fiscal year can be specified explicitly; otherwise the latest available period is returned.
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?+
- Building a NEPSE portfolio tracker that polls
get_live_marketfor real-time price updates during trading hours - Running a nightly RSI oversold screen using
get_rsi_oversold_stocksfiltered by sector to surface reversion candidates - Charting historical OHLCV candles with
get_tradingview_historyin a TradingView-compatible front-end widget - Comparing sector PE and PB ratios from
get_sector_summaryto identify relatively cheap segments of the NEPSE market - Monitoring broker accumulation patterns for a specific stock using
get_broker_holdingwith a weekly timeframe - Screening all NEPSE stocks for RSI or A/D divergence signals via
get_rsi_divergenceandget_ad_divergencefor swing trade ideas - Pulling quarterly balance-sheet data with
get_stock_financialsto compute custom debt or earnings metrics not pre-calculated elsewhere
| 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_fundamental_signals` return and how can I filter it by sector?+
sector string (e.g. Commercial Banks) to the optional parameter and only stocks whose sector field matches case-insensitively are included in the signals array and total count. Set include_debt to true to also receive debt-to-equity and raw borrowings values from the latest quarterly report.How complete is a divergence scan when I omit the `symbol` parameter on `get_rsi_divergence` or `get_ad_divergence`?+
symbols_total (stocks targeted) and symbols_scanned (stocks actually processed), so you can tell when a full-market scan was truncated. For guaranteed full coverage of a specific stock, pass the symbol parameter to scope the call to one ticker.Does the API provide intraday tick-by-tick or minute-level price data?+
get_daily_market_summary under todayNepse, and the real-time per-stock snapshot in get_live_market. Minute-level candles for individual stocks are not exposed. You can fork this API on Parse and revise it to add the missing endpoint if that data becomes available on NepseAlpha.Does the API cover historical broker floor-sheet data beyond one month?+
get_broker_holding endpoint supports weekly and monthly trailing windows via the timeframe parameter. Longer historical periods—such as quarterly or year-to-date floor-sheet aggregations—are not currently returned. You can fork this API on Parse and revise it to add longer lookback windows if NepseAlpha surfaces that data.