List Bonds - NGN Market API

NGX-listed bond instruments

curl --request GET \
  --url https://api.ngnmarket.com/v1/bonds \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "data": [
      {
        "id": 1,
        "isin": "NG0000123456",
        "name": "FGN Bond 2030",
        "issuer": "Federal Government of Nigeria",
        "type": "government",
        "coupon": 12.5,
        "issue_date": "2020-03-27",
        "maturity_date": "2030-03-27",
        "open_price": 98.5,
        "created_at": "2024-01-15T08:00:00.000Z",
        "updated_at": "2026-04-17T06:30:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 84,
      "pages": 9,
      "has_next": true,
      "has_prev": false
    }
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4821,
    "calls_remaining": 95179,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

GET

bonds

NGX-listed bond instruments

curl --request GET \
  --url https://api.ngnmarket.com/v1/bonds \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "data": [
      {
        "id": 1,
        "isin": "NG0000123456",
        "name": "FGN Bond 2030",
        "issuer": "Federal Government of Nigeria",
        "type": "government",
        "coupon": 12.5,
        "issue_date": "2020-03-27",
        "maturity_date": "2030-03-27",
        "open_price": 98.5,
        "created_at": "2024-01-15T08:00:00.000Z",
        "updated_at": "2026-04-17T06:30:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 84,
      "pages": 9,
      "has_next": true,
      "has_prev": false
    }
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4821,
    "calls_remaining": 95179,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

This endpoint returns a paginated list of bonds listed on the Nigerian Exchange (NGX). Each record includes the bond’s ISIN, issuer name, bond type, coupon rate, maturity date, and opening price. You can narrow results with optional search and type filters. Results are sorted by bond type priority (Federal Government bonds first, then state, then corporate), then by maturity date ascending. This endpoint requires a Starter plan or higher.

Authorizations

Authorization

string

header

required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Query Parameters

page

integer

default:1

Page number. Defaults to 1.

Required range: x >= 1

limit

integer

default:50

Number of bonds per page (1–100). Defaults to 50.

Required range: 1 <= x <= 100

string

Filter by name, issuer, or ISIN. Case-insensitive, partial match.

type

enum<string>

Filter by bond classification.

Available options:

government,

corporate

Response

Bonds retrieved successfully.

success

boolean

required