ShareSansar APIsharesansar.com ↗
Fetch Nepal stock prices, listed company symbols, and market news from ShareSansar via 4 API endpoints covering NEPSE data.
What is the ShareSansar API?
The ShareSansar API gives developers access to Nepal Stock Exchange (NEPSE) data across 4 endpoints: daily stock prices for all listed companies, a full company directory, categorized news listings, and full-text news article content. The get_stock_prices endpoint returns eight price fields per ticker — symbol, LTP, volume, open, high, low, close, and turnover — for any requested trading date or the latest available session.
curl -X GET 'https://api.parse.bot/scraper/cbe5bf21-3b47-4fb7-8ce3-a3f775409108/get_stock_prices?date=2026-07-10§or=all_sec' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace sharesansar-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.sharesansar_nepali_stock_market_api import ShareSansar, NewsCategory, Stock, StockSnapshot, NewsItem, Article, Company
client = ShareSansar()
# Get stock prices for the latest trading day
snapshot = client.stocksnapshots.get()
print(snapshot.actual_date, snapshot.count)
for stock in snapshot.data:
print(stock.symbol, stock.ltp, stock.volume, stock.turnover)
# Browse IPO/FPO news using the enum
for item in client.newsitems.list(category=NewsCategory.IPO_FPO_NEWS, limit=5):
print(item.title, item.url)
# Get full article details
article = client.articles.get(url="https://www.sharesansar.com/newsdetail/example-2026-06-10")
print(article.headline, article.published_at, article.content)
# List all companies on NEPSE
for company in client.companies.list(limit=5):
print(company.symbol, company.companyname)
Get stock prices for all companies listed on NEPSE for a specific date or the latest available trading day. Returns Symbol, LTP, Volume, Open, High, Low, Close, and Turnover for each stock. When the requested date has no trading data (e.g., holidays or weekends), the site returns the latest available data instead. The actual_date field in the response indicates which date's data was returned.
| Param | Type | Description |
|---|---|---|
| date | string | Date in YYYY-MM-DD format. If not provided or if no trading data exists for the date, returns the latest available data. |
| sector | string | Sector filter for stock prices. Default is 'all_sec' for all sectors. |
{
"type": "object",
"fields": {
"data": "array of stock price objects with keys: symbol, ltp, volume, open, high, low, close, turnover",
"count": "integer total number of stocks returned",
"actual_date": "string date of the data actually returned (YYYY-MM-DD)",
"requested_date": "string or null, the date requested by the user"
},
"sample": {
"data": {
"data": [
{
"low": "949.00",
"ltp": "951.00",
"high": "958.00",
"open": "950.00",
"close": "951.00",
"symbol": "ACLBSL",
"volume": "1256.00",
"turnover": "1195754.00"
}
],
"count": 357,
"actual_date": "2026-06-09",
"requested_date": "2026-06-09"
},
"status": "success"
}
}About the ShareSansar API
Stock Price Data
The get_stock_prices endpoint returns an array of price objects for every company trading on the Nepal Stock Exchange. Each object includes symbol, ltp (last traded price), volume, open, high, low, close, and turnover. Pass a date parameter in YYYY-MM-DD format to request a specific session. If that date falls on a weekend or market holiday with no trading data, the response falls back to the most recent available session and indicates the difference via requested_date and actual_date fields. An optional sector parameter filters results to a specific market sector.
Company Directory
The get_companies endpoint returns every company currently listed on the Nepal Stock Exchange. Each record contains an integer id, a symbol ticker string, and a companyname full name string. This endpoint accepts no parameters and is useful for building symbol lookups, autocomplete interfaces, or cross-referencing tickers returned by get_stock_prices.
News and Article Content
get_news_list retrieves paginated article listings from ShareSansar's news categories. Pass a category slug such as exclusive, ipo-fpo-news, proposed-dividend, or latest-news to scope results. Each item in the news array includes a title, url, and published_at timestamp (which may be null for some articles). Use the next_cursor value from one response as the cursor input on the next call to page through results.
get_news_detail accepts the full article URL from get_news_list and returns the complete article text via the content field, along with the headline and published_at timestamp. This makes it possible to build full-text search indexes or news monitors without additional fetching.
The ShareSansar API is a managed, monitored endpoint for sharesansar.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when sharesansar.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 sharesansar.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?+
- Track daily NEPSE closing prices and turnover for a portfolio of tickers using
get_stock_prices. - Build a historical price database by iterating
get_stock_pricesacross multiple dates and storing theactual_datealongside each snapshot. - Populate a company symbol autocomplete by loading the full directory from
get_companies. - Monitor IPO and FPO announcements by polling
get_news_listwith theipo-fpo-newscategory slug. - Aggregate dividend proposal news by filtering
get_news_liston theproposed-dividendcategory. - Build a full-text news archive of ShareSansar articles by pairing
get_news_listpagination withget_news_detailcontent extraction. - Alert on sector-specific price movements by combining the
sectorfilter onget_stock_priceswith a daily diff.
| 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 | 100 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 ShareSansar have an official developer API?+
What happens if I request a date with no trading data, like a weekend?+
get_stock_prices endpoint automatically falls back to the most recent session that has data. The response includes both requested_date (what you passed) and actual_date (what was actually returned), so you can detect the fallback in your code.Does the API expose historical price series or intraday tick data?+
get_stock_prices returns one session snapshot per call — either a specific date or the latest available session. Intraday tick data and multi-date range queries are not covered. You can fork this API on Parse and revise it to add a batch-date or historical range endpoint.Which news categories are supported by get_news_list?+
category parameter accepts slugs such as exclusive, ipo-fpo-news, proposed-dividend, and latest-news. Omitting the parameter returns results from the default category. The API does not currently expose a programmatic list of all available category slugs; you can fork it on Parse and revise it to add a category-listing endpoint.