# Nepsealpha — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track Nepal's stock market in real-time with live prices, historical OHLCV data, and detailed sector summaries, while leveraging technical and fundamental analysis signals to make informed trading decisions. Monitor floorsheet transactions, assess investment risks, and search specific symbols all from a single comprehensive market data platform.

**Category:** Finance & Markets | **Website:** [nepsealpha.com/](https://nepsealpha.com/) | **Docs:** [parse.bot/marketplace/2a778b14-5d16-4433-b5e6-e99b66da5350/nepsealpha-com-api](https://parse.bot/marketplace/2a778b14-5d16-4433-b5e6-e99b66da5350/nepsealpha-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_daily_market_summary

Fetch the daily market summary including top-performing sectors, intraday gainers, intraday losers, volume leaders, and turnover leaders. Also includes intraday NEPSE index OHLC snapshots.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_daily_market_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_floorsheet_live

Fetch live floorsheet transaction data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_floorsheet_live \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_fundamental_signals

Fetch fundamental trading signals for all NEPSE stocks based on financial ratios. Each signal includes PE, PB, ROE, ROA, PEG, dividend yield, payout ratio, Graham number discount, and sector-relative valuations.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_fundamental_signals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_historical_price_data

Fetch historical OHLCV price data for a specific stock symbol or index within a date range. Returns daily, weekly, or monthly candles with open, high, low, close, volume, turnover, and percent change. Results are ordered most-recent-first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | End date in YYYY-MM-DD format. Defaults to current date if omitted. |
| `price_type` | string | No | Price adjustment type |
| `start_date` | string | No | Start date in YYYY-MM-DD format. Defaults to 2025-01-01 if omitted. |
| `symbol` | string | Yes | Stock symbol or index name (e.g. NABIL, NEPSE, SBL) |
| `time_frame` | string | No | Candle aggregation period |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_historical_price_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","price_type":"<string>","start_date":"<string>","symbol":"<string>","time_frame":"<string>"}'
```

### get_live_market

Fetch a real-time snapshot of all NEPSE-listed stock prices, top gainers and losers, the NEPSE index level, market open/closed status, sector breakdown, and aggregate market summary (total turnover, traded shares, transactions). Data refreshes intraday while the market is open.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_live_market \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_risk_assessment

Fetch risk assessment data for all NEPSE stocks categorized by quantitative risk metrics. Each entry includes beta, alpha, Sharpe ratio, daily volatility, Value at Risk (95%), Piotroski F-score, Altman Z-score, and G-score.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_risk_assessment \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_sector_summary

Fetch performance metrics for all NEPSE market sectors including PE, PB, ROE, daily gain, turnover, sparkline data, and current index value. Returns one record per sector/index.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_sector_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_technical_signals

Fetch technical trading signals for all NEPSE stocks. Each signal includes RSI, MACD, SMA crossovers, Bollinger Band %B, MFI, Stochastic, CCI, volume trend, an overall technical summary rating (Bullish/Bearish with strength), and computed entry/exit price levels derived from Bollinger Band support/resistance.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_technical_signals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_tradingview_history

Fetch historical OHLCV data in parallel-array format compatible with TradingView charting. Returns arrays of open, high, low, close, volume, and Unix timestamps covering the full available history for the symbol. The 1D resolution is most reliable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `resolution` | string | No | Chart candle resolution |
| `symbol` | string | Yes | Stock symbol (e.g. NABIL, NEPSE, SBL) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/get_tradingview_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resolution":"<string>","symbol":"<string>"}'
```

### search_symbol

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return from the search |
| `query` | string | Yes | Search keyword matching company name or stock symbol (e.g. NABIL, Himalayan) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nepsealpha-com-api-2a778b14/search_symbol \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```