# Auctions

## `GET /v1/fixed-income/auctions` (key required)

Primary-market auction results for government securities: the **cut-off yield** of each auction, by tenor.

| Param | Type | Default | Notes |
|---|---|---|---|
| `type` | string | all | `tbill` (Market Treasury Bills), `pib` (fixed-rate Pakistan Investment Bonds), `gis` (GoP Ijara Sukuk) |
| `from`, `to` | date | - | Auction date window |
| `limit` | int | 500 | 1-5000, newest first |

```bash
curl -H "X-API-Key: pk_live_xxx" \
  "https://api.pakdatahub.com/v1/fixed-income/auctions?type=tbill&limit=2"
```

```json
{ "success": true, "count": 2, "data": [
  { "type": "tbill", "tenor": "12m", "auction_date": "2026-07-23", "settlement_date": null,
    "cutoff_yield": 11.9938, "offered_amount": null, "accepted_amount": null,
    "bid_to_cover": null, "source": "SBP" },
  { "type": "tbill", "tenor": "1m", "auction_date": "2026-07-23", "settlement_date": null,
    "cutoff_yield": 11.3504, "offered_amount": null, "accepted_amount": null,
    "bid_to_cover": null, "source": "SBP" } ] }
```

| Field | Meaning |
|---|---|
| `tenor` | T-Bills `1m`/`3m`/`6m`/`12m`; PIBs `2y`...`30y`; Sukuk `1y`...`10y` |
| `cutoff_yield` | Cut-off yield in % (for GIS, the SBP-reported cut-off rental rate or price) |
| `offered_amount`, `accepted_amount`, `bid_to_cover`, `settlement_date` | Currently `null`, because SBP's redesigned site no longer publishes them in a structured form |

**History:** T-Bills from 2004, PIBs from 2000, sourced from SBP. The latest dates follow SBP's release of each auction.

## The same data as series

Each type and tenor is also a series, which works with transforms and CSV:

```bash
curl -H "X-API-Key: pk_live_xxx" \
  "https://api.pakdatahub.com/v1/series/rates.auction.tbill.3m.cutoff_yield?from=2020-01-01&sort=asc&format=csv"
```

Ids: `rates.auction.tbill.{1m,3m,6m,12m}.cutoff_yield`, `rates.auction.pib.{2y,3y,5y,10y,15y,20y,30y}.cutoff_yield`, `rates.auction.gis.{3y,5y}.cutoff_price`.

Compare them with the secondary-market curve (`rates.pkrv.*`) and the policy rate. See the [Rates dataset](https://pakdatahub.com/docs/data-rates.md).

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