# Debt securities

Instrument-level debt prices from **MUFAP**: 193 instruments, with daily prices since 2022.

## `GET /v1/securities` (key required)

| Param | Type | Notes |
|---|---|---|
| `type` | string | `pib_floating` (floating-rate PIBs), `gis_sukuk` (GoP Ijara Sukuk), `tfc_sukuk` (corporate TFCs and Sukuk) |
| `q` | string | Code or issuer-name filter |
| `limit` | int | Default 1000 |

```json
{ "success": true, "count": 1, "data": [
  { "code": "PIBFR10YQ2030-10-22", "type": "pib_floating", "name": null, "rating_category": null,
    "sbp_code": null, "first_seen": "2024-11-20", "last_seen": "2026-09-23",
    "latest_price": { "date": "2026-09-23", "price": 98.81, "net_change": 0.02 } } ] }
```

A corporate example:

```json
{ "code": "ABPL/SUK/220817", "type": "tfc_sukuk",
  "name": "AL BARAKA BANK (PAKISTAN) LTD. - SUKUK (22-08-17) - Amortization",
  "rating_category": "RATED A", "first_seen": "2024-04-01", "last_seen": "2024-08-23",
  "latest_price": { "date": "2024-08-23", "price": 100.0, "net_change": null } }
```

**Codes:**
- Floating PIBs: `PIBFR<tenor><Q|S><maturity>`.
- GoP Ijara Sukuk: normalized to `GOPIS-<FRR|VRR>-<maturity>`.
- TFCs: MUFAP's own code, which **can contain slashes**.

## `GET /v1/securities/{code}/prices` (key required)

Price history, per 100 of face value. Params: `from`, `to`, `limit`, `sort`. Send slashes in the code raw (don't URL-encode them); it's a path segment.

```bash
curl -H "X-API-Key: pk_live_xxx" \
  "https://api.pakdatahub.com/v1/securities/PIBFR10YQ2030-10-22/prices?limit=2"
```

```json
{ "success": true, "code": "PIBFR10YQ2030-10-22", "count": 2, "data": [
  { "date": "2026-09-23", "price": 98.81, "net_change": 0.02 },
  { "date": "2026-09-22", "price": 98.79, "net_change": 0.04 } ] }
```

## `GET /v1/securities/trades` (key required)

Trade-level secondary-market debt transactions (MUFAP "Debt Instruments Daily Trading").

| Param | Type | Notes |
|---|---|---|
| `from`, `to` | date | Trade date window |
| `issue` | string | Issuer or instrument name filter, e.g. `K Electric` |
| `limit` | int | Default 500 |

```json
{ "success": true, "count": 1, "data": [
  { "trade_date": "2026-06-11", "bats": "BATS", "issue_name": "K Electric Ltd. Sukuk VI",
    "issue_date": "2022-11-23", "maturity_date": "2029-11-23", "listed": "Listed",
    "face_value": 70000.0, "volume": 357.0, "value_mn": 25.55, "price_pct": 102.25 } ] }
```

| Field | Meaning |
|---|---|
| `bats` | Venue: `BATS` (Bond Automated Trading System) or `Non-BATS` |
| `value_mn` | Trade value in Rs million |
| `price_pct` | Price as % of face value |

## Related

- **Primary-market auction cut-offs:** [Auctions](https://pakdatahub.com/docs/api-auctions.md).
- **Yield curves** (PKRV, PKISRV): [Rates dataset](https://pakdatahub.com/docs/data-rates.md).
- **Government-securities holdings by investor type:** the `debt.*` series ([Debt dataset](https://pakdatahub.com/docs/data-debt.md)).
- Web: [/securities](https://pakdatahub.com/securities) and [/securities/trades](https://pakdatahub.com/securities/trades).

---
Source: https://pakdatahub.com/docs/api-securities - PakDataHub docs index: https://pakdatahub.com/docs/llms.txt