# Hdfcsec — 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 real-time equity market movements by finding the most active NSE stocks, top gainers and losers, 52-week highs and lows, and detailed stock quotes. Search for specific stocks and get comprehensive market overviews to make informed investment decisions.

**Category:** Finance & Markets | **Website:** [hdfcsec.com/](https://hdfcsec.com/) | **Docs:** [parse.bot/marketplace/abc99eaa-7402-4a9b-9ef1-e20469244d48/hdfcsec-com-api](https://parse.bot/marketplace/abc99eaa-7402-4a9b-9ef1-e20469244d48/hdfcsec-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-hdfcsec-com-api-abc99eaa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_52_week_high_stocks

Get stocks hitting 52-week highs. Returns stocks that have reached their highest price in the past 52 weeks, with their current price and previous day high for comparison.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | No | Exchange code: NSE or BSE |
| `index` | string | No | Index code to filter by (optional, omit or leave empty for all stocks) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hdfcsec-com-api-abc99eaa/get_52_week_high_stocks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"<string>","index":"<string>"}'
```

### get_52_week_low_stocks

Get stocks hitting 52-week lows. Returns stocks that have reached their lowest price in the past 52 weeks, with their current price and previous day low for comparison.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | No | Exchange code: NSE or BSE |
| `index` | string | No | Index code to filter by (optional, omit or leave empty for all stocks) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hdfcsec-com-api-abc99eaa/get_52_week_low_stocks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"<string>","index":"<string>"}'
```

### get_equity_market_overview

Get an overview of all available indices for a given exchange. Returns index names, codes, current values, and changes. Useful for discovering valid index codes to pass to other endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | No | Exchange code: NSE or BSE |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hdfcsec-com-api-abc99eaa/get_equity_market_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"<string>"}'
```

### get_most_active_nse_stocks

Get the most active stocks for a given exchange and index, sorted by trading volume descending. Each result includes last traded price, change, percent change, day range, and volume. Supports filtering by exchange and index code, and time period.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | No | Exchange code: NSE or BSE |
| `index` | string | No | Index code to filter by (e.g., 20559 for Nifty 50, 20558 for Sensex) |
| `period` | string | No | Time period: I (Intra Day), W (Week), M (Month) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hdfcsec-com-api-abc99eaa/get_most_active_nse_stocks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"<string>","index":"<string>","period":"<string>"}'
```

### get_stock_quote

Get a detailed quote for a specific stock by its trading symbol. Returns comprehensive information including price, volume, market cap, 52-week range, PE ratio, and sector. Internally resolves the symbol via search then fetches the company detail page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock trading symbol (e.g., INFY for Infosys, TCS for TCS, RELIANCE for Reliance Industries) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hdfcsec-com-api-abc99eaa/get_stock_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_top_gainers_nse

Get the top gaining stocks for a given exchange and index, sorted by percent change descending. Each result includes last traded price, change, percent change, day range, and volume.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | No | Exchange code: NSE or BSE |
| `index` | string | No | Index code to filter by (e.g., 20559 for Nifty 50) |
| `limit` | integer | No | Maximum number of results to return |
| `period` | string | No | Time period: I (Intra Day), W (Week), M (Month) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hdfcsec-com-api-abc99eaa/get_top_gainers_nse \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"<string>","index":"<string>","limit":"<integer>","period":"<string>"}'
```

### get_top_losers_nse

Get the top losing stocks for a given exchange and index, sorted by percent change ascending. Each result includes last traded price, change, percent change, day range, and volume.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | No | Exchange code: NSE or BSE |
| `index` | string | No | Index code to filter by (e.g., 20559 for Nifty 50) |
| `limit` | integer | No | Maximum number of results to return |
| `period` | string | No | Time period: I (Intra Day), W (Week), M (Month) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hdfcsec-com-api-abc99eaa/get_top_losers_nse \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"<string>","index":"<string>","limit":"<integer>","period":"<string>"}'
```

### search_stock

Search for stocks by name or symbol. Returns matching stocks with basic price information including last traded price, change, and ISIN. Results are limited to 10 matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term — stock name or trading symbol (e.g., INFY, Reliance, TCS) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hdfcsec-com-api-abc99eaa/search_stock \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```