# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/nepsealpha/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/nepsealpha/get-daily-market-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/get-floorsheet-live \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/get-fundamental-signals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/get-historical-price-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/get-live-market \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/get-risk-assessment \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/get-sector-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/get-technical-signals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/get-tradingview-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nepsealpha/search-symbol \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.