KoboTerminalNGX API DocsGet a free API key

Treasury bill auctions

CBN Nigerian Treasury Bill auction results: tenor, amount offered, subscribed and allotted, subscription rate, stop rate and yields.

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

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

Parameters

NameInTypeRequiredDescription
limitqueryintegernoNumber of auction rows, default 50, max 500 (e.g. 6)

Request

bash
curl "https://koboterminal.com/api/ngxdata/bonds/auctions?limit=6" \
  -H "X-API-Key: $KOBO_API_KEY"
python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/ngxdata/bonds/auctions",
    params={"limit": "6"},
    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/auctions?limit=6", {
  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": "cbn",
  "updated_at": "2026-11-18T22:39:33.611Z",
  "cache_ttl_seconds": 1800,
  "count": 2,
  "data": [
    {
      "country": "Nigeria",
      "instrument_type": "tbill",
      "tenor_days": 182,
      "tenor_label": "182-day",
      "auction_date": "2026-11-11",
      "settlement_date": null,
      "maturity_date": "2027-05-13",
      "offered_amount": 100000,
      "bid_amount": 23017.438,
      "allotted_amount": 22282.437,
      "subscription_rate": 23.0174,
      "stop_rate": 15.79,
      "average_yield": 15.79,
      "high_rate": 15.79,
      "low_rate": 15,
      "currency": "NGN"
    }
  ]
}

Use it from an AI assistant

This endpoint is available as the get_tbill_auctions tool on the Kobo Terminal MCP server (https://koboterminal.com/mcp). See MCP server.

Errors

Standard errors apply: see Rate limits and errors.