# Chittorgarh — 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.

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-chittorgarh-com-api-08d8e38e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-chittorgarh-com-api-08d8e38e/get_ipo_dashboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-chittorgarh-com-api-08d8e38e/get_ipo_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-chittorgarh-com-api-08d8e38e/get_ipo_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-chittorgarh-com-api-08d8e38e/get_ipo_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-chittorgarh-com-api-08d8e38e/get_mainboard_ipo_subscription \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-chittorgarh-com-api-08d8e38e/get_stock_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-chittorgarh-com-api-08d8e38e/search_ipo \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```