# Bonds

> Nigerian FGN bonds, Eurobonds, Sukuk and corporate bonds listed on the NGX: issuer, type, currency, coupon, maturity and latest quoted clean price (yield to maturity where published).

```http
GET https://koboterminal.com/api/ngxdata/bonds
```

**Plan:** Free and above (free key, no card).

## Request

```bash
curl "https://koboterminal.com/api/ngxdata/bonds" \
  -H "X-API-Key: $KOBO_API_KEY"
```

```python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/ngxdata/bonds",
    headers={"X-API-Key": os.environ["KOBO_API_KEY"]},
    timeout=30,
)
r.raise_for_status()
data = r.json()
```

```javascript
const res = await fetch("https://koboterminal.com/api/ngxdata/bonds", {
  headers: { "X-API-Key": process.env.KOBO_API_KEY },
});
if (!res.ok) throw new Error(`Kobo API ${res.status}`);
const data = await res.json();
```

## Response

Real response from the live API on 18 November 2026, trimmed to the first item of each list:

```json
{
  "success": true,
  "source": "ngx_bonds",
  "updated_at": "2026-11-18T23:20:41.267Z",
  "cache_ttl_seconds": 1800,
  "count": 43,
  "data": [
    {
      "ticker": "LAB2027T4",
      "name": "Nigerian State Government 2027",
      "issuer": "Nigerian State Government",
      "issuer_type": "sub-sovereign",
      "bond_type": "govt_local",
      "currency": "NGN",
      "coupon_rate": 15.85,
      "maturity_date": "2027-12-31",
      "listing_exchange": "NGX",
      "source_url": "https://ngxgroup.com/bonds-details/?symbol=LAB2027T4&directory=bonddirectory",
      "latest_quote_date": "2026-11-19",
      "clean_price": 100,
      "change_pct": 0,
      "yield_to_maturity": null
    }
  ]
}
```

## Use it from an AI assistant

This endpoint is available as the `get_bonds` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp).

## Errors

Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors).
