# Chittorgarh — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Access real-time IPO details, SME stock prices, and financial information directly from Chittorgarh.com to research investment opportunities and track market performance. Search IPOs, view detailed dashboards, and stay updated with the latest financial news all in one place.

**Category:** Finance & Markets | **Website:** [chittorgarh.com/](https://chittorgarh.com/) | **Docs:** [parse.bot/marketplace/08d8e38e-b185-4b9b-a423-ed645129c8bf/chittorgarh-com-api](https://parse.bot/marketplace/08d8e38e-b185-4b9b-a423-ed645129c8bf/chittorgarh-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/chittorgarh/`
**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 ipo dashboard

Retrieve summary dashboard data for IPO subscriptions, performance, prospectus, board of approvals, or calendar. Returns live data for the selected dashboard type and category with a list of relevant IPOs and their key metrics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Dashboard category. |
| `type` | string | No | Dashboard type. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/chittorgarh/get-ipo-dashboard \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","type":"<string>"}'
```

### Get ipo detail

Retrieve comprehensive details for a specific IPO including pricing, lot size, dates, financials, and KPIs. Requires slug and ipo_id which can be obtained from get_ipo_list (extract from Company_url) or search_ipo (urlrewrite_folder_name and id fields).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ipo_id` | string | Yes | Numeric IPO identifier (e.g. '2658'). Available as id from search_ipo results or extractable from Company_url in get_ipo_list. |
| `slug` | string | Yes | IPO URL slug identifier (e.g. 'hexagon-nutrition-ipo'). Available as urlrewrite_folder_name from search_ipo results or extractable from Company_url in get_ipo_list. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/chittorgarh/get-ipo-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"ipo_id":"<string>","slug":"<string>"}'
```

### Get ipo list

Retrieve a list of Mainboard and SME IPOs from Chittorgarh. Supports filtering by category (all/mainboard/sme), calendar year, and financial year. Returns company name, issue details, pricing, listing exchange, and lead manager information. Each item includes a URL from which the slug and ipo_id can be extracted for use with get_ipo_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | IPO category filter. |
| `fin_year` | string | No | Financial year filter in format 'YYYY-YY'. |
| `year` | string | No | Calendar year to filter IPOs. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/chittorgarh/get-ipo-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","fin_year":"<string>","year":"<string>"}'
```

### Get ipo news

Retrieve latest news articles for a specific IPO by its numeric ID. Returns news titles, dates, summaries, sources, and links. News is sourced from major financial publications.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ipo_id` | string | Yes | Numeric IPO identifier (e.g. '2658'). Available as id from search_ipo results or extractable from Company_url in get_ipo_list. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/chittorgarh/get-ipo-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"ipo_id":"<string>"}'
```

### Get mainboard ipo subscription

Retrieve live subscription status for mainboard IPOs from BSE and NSE combined bidding data. Returns each IPO's company name and subscription multiples (times subscribed) broken down by investor category: QIB, NII, Retail, and Total. Data covers the selected calendar/financial year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fin_year` | string | No | Financial year filter in format 'YYYY-YY'. |
| `year` | string | No | Calendar year to filter IPOs. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/chittorgarh/get-mainboard-ipo-subscription \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"fin_year":"<string>","year":"<string>"}'
```

### Get stock prices

Retrieve stock prices for all SME stocks on NSE or BSE. Returns company name, group, open/high/low/LTP prices, volume, turnover, and trade count. The full list is returned in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | No | Stock exchange to query. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/chittorgarh/get-stock-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"<string>"}'
```

### Search ipo

Search for IPOs by company name. Returns matching IPO records with id and slug (urlrewrite_folder_name) that can be used with get_ipo_detail and get_ipo_news endpoints. Performs a case-insensitive partial match against the full IPO catalog.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Company name search term (case-insensitive partial match). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/chittorgarh/search-ipo \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

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