# Bond Bseindia — 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.

> Monitor real-time bond market activity from BSE India by accessing OTC trades, listed debt securities, bulk deals, and corporate announcements all in one place. Track market trends instantly with gainers and losers data to make informed investment decisions in the debt segment.

**Category:** Finance & Markets | **Website:** [bond.bseindia.com/](https://bond.bseindia.com/) | **Docs:** [parse.bot/marketplace/8807dbbf-d4de-4104-8687-27743ba5a872/bond-bseindia-com-api](https://parse.bot/marketplace/8807dbbf-d4de-4104-8687-27743ba5a872/bond-bseindia-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-bond-bseindia-com-api-8807dbbf/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bond_announcements

Returns corporate announcements for the debt segment on BSE. Supports pagination (50 per page) and date filtering. Results include announcement subject, headline, category, company name, and timestamps.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category filter ID. -1 for all categories. |
| `from_date` | string | No | Start date filter in YYYYMMDD format. Defaults to today if omitted. |
| `isin` | string | No | Filter announcements by ISIN code (e.g. INE202B07II5). When provided, takes precedence over scrip_code. |
| `page` | string | No | Page number for pagination (50 results per page). |
| `scrip_code` | string | No | Filter by specific security scrip code. |
| `subcategory` | string | No | Subcategory filter ID. -1 for all subcategories. |
| `to_date` | string | No | End date filter in YYYYMMDD format. Defaults to today if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bond-bseindia-com-api-8807dbbf/get_bond_announcements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","from_date":"<string>","isin":"<string>","page":"<string>","scrip_code":"<string>","subcategory":"<string>","to_date":"<string>"}'
```

### get_bond_deals

Returns bulk or block deals reported on BSE. Each deal includes date, security, client name, transaction type (B=Buy, S=Sell), quantity, and weighted average price.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `deal_type` | string | No | Type of deal to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bond-bseindia-com-api-8807dbbf/get_bond_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deal_type":"<string>"}'
```

### get_bond_gainers

Returns top gaining securities by price change for a given BSE market group. Use group IF for debt securities (F-Group bonds). Data is available only during market hours and may return empty outside trading sessions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `group` | string | No | BSE market group code. IF=Debt/Fixed Income group. Other groups: A, B, E, M, MS, MT, P, T, X, XT, Z, ZP. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bond-bseindia-com-api-8807dbbf/get_bond_gainers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"<string>"}'
```

### get_bond_listings

Returns listed debt securities on BSE with details including scrip code, security name, coupon rate, issue date, and maturity date. Filterable by security type, scrip code, scrip name, coupon rate, issue date range, and maturity date range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `coupon_rate` | string | No | Filter by coupon rate. |
| `issue_from_date` | string | No | Issue date range start in DD/MM/YYYY format. |
| `issue_to_date` | string | No | Issue date range end in DD/MM/YYYY format. |
| `maturity_from_date` | string | No | Maturity date range start in DD/MM/YYYY format. |
| `maturity_to_date` | string | No | Maturity date range end in DD/MM/YYYY format. |
| `scrip_code` | string | No | Filter by specific scrip code. |
| `scrip_name` | string | No | Filter by security name (partial match). |
| `security_type` | string | No | Type of debt security. C=Central Government Securities, S=State Government Securities, T=Treasury Bill Securities, P=Privately Placed Bonds. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bond-bseindia-com-api-8807dbbf/get_bond_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"coupon_rate":"<string>","issue_from_date":"<string>","issue_to_date":"<string>","maturity_from_date":"<string>","maturity_to_date":"<string>","scrip_code":"<string>","scrip_name":"<string>","security_type":"<string>"}'
```

### get_bond_losers

Returns top losing securities by price change for a given BSE market group. Use group IF for debt securities (F-Group bonds). Data is available only during market hours and may return empty outside trading sessions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `group` | string | No | BSE market group code. IF=Debt/Fixed Income group. Other groups: A, B, E, M, MS, MT, P, T, X, XT, Z, ZP. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bond-bseindia-com-api-8807dbbf/get_bond_losers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"<string>"}'
```

### get_bond_market_activity

Returns recent corporate bond OTC trades reported on BSE, including price, yield, turnover, and trade count per security. Data refreshes during market hours. The flag parameter selects the trade reporting category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `flag` | string | No | Trade reporting category flag. 1=Corporate Bond OTC Trades, 3=Broker Trade Reporting, 4=Buy-Back in Corporate Bonds. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bond-bseindia-com-api-8807dbbf/get_bond_market_activity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"flag":"<string>"}'
```