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

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/bond-bseindia/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/bond-bseindia/get-bond-announcements \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/bond-bseindia/get-bond-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/bond-bseindia/get-bond-gainers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/bond-bseindia/get-bond-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/bond-bseindia/get-bond-losers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/bond-bseindia/get-bond-market-activity \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"flag":"<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.