Bonds & sukuk

Fixed-income instruments — government bonds, treasury bills, corporate bonds, and sukuk — alongside their fixed-income terms. Bonds and sukuk share the catalog with equities and ETFs in /v1/instruments (distinguished by security_type); /v1/bonds is the focused view that joins each instrument to its bond terms (coupon, maturity, face value).

Bonds quote a clean price as a percent of par (100.000% = 100000000 micros). Coupon, maturity, and face value are disclosure — they are never a sort or merit key. The list is strictly alphabetical (FRA Decision 332).

GET /v1/bonds

List bonds and sukuk with their terms, alphabetical by market_id, symbol. Pass ?shariah=true to narrow to screened-compliant instruments (sukuk and any shariah-screened bond); the alphabetical order is preserved inside the filtered set.

{
  "bonds": [
    {
      "market_id": "EGX",
      "symbol": "EGTB182",
      "name": "Egypt T-Bill 182d",
      "name_ar": "أذون خزانة مصرية ١٨٢ يوم",
      "security_type": "bond",
      "clean_price_micros": 97250000,
      "currency": "EGP",
      "shariah_compliant": false,
      "face_value_micros": 1000000000,
      "coupon_rate_bps": 0,
      "coupon_frequency": 0,
      "issue_date": "2026-01-15T00:00:00Z",
      "maturity_date": "2026-07-16T00:00:00Z",
      "day_count_convention": "ACT/365",
      "first_coupon_date": null
    }
  ],
  "ordering": "alphabetical",
  "note": "clean_price_micros is the clean price as a percent of par (100% = 100000000); coupon and maturity are disclosure, not advice"
}

Field	Notes
security_type	bond | sukuk
clean_price_micros	clean price as a percent of par (100000000 = 100.000%)
face_value_micros	par / nominal value per unit
coupon_rate_bps	annual coupon in basis points (0 for a zero-coupon bill)
coupon_frequency	coupons per year (0, 1, 2, 4)
issue_date / maturity_date	RFC-3339 dates; maturity_date > issue_date
day_count_convention	accrual basis, e.g. ACT/365
first_coupon_date	first coupon date when it differs from a regular schedule; null otherwise

Clean vs. dirty. The quoted clean price excludes accrued interest. The dirty consideration a buyer pays is clean + accrued, where accrued interest grows each day between coupons from the coupon rate, face value, and day-count convention. See Asset classes → Bonds & sukuk for the mechanics, and Learn → Clean & dirty price for a worked walkthrough.

Order book & price history

Bonds expose the same order book and OHLCV endpoints as equities — in clean-price space. A bond's ref_price_micros is its clean price, so the band, tick, and candle fields all read in percent-of-par micros.

Trading

In this release bonds and sukuk are quoted (clean price) but not yet orderable through /v1/orders. When the bond money path opens, an order will carry a clean_price_micros limit and fills will itemize accrued_micros and the dirty consideration — see Orders for the forward-looking fields. Equity and ETF orders are unaffected.

No yield ranking. coupon_rate_bps and any indicative yield are returned as disclosure only. There is no sort=yield / sort=coupon parameter and no "highest-yield" surface — the catalog is alphabetical by construction.