> ## Documentation Index > Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt > Use this file to discover all available pages before exploring further. # List Bonds > Retrieve a paginated list of NGX-listed bonds. 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. ## OpenAPI ````yaml GET /bonds openapi: 3.1.0 info: title: NGN Market API version: '1.0' description: > The NGN Market API provides programmatic access to Nigerian Exchange Group (NGX) market data, including equities, forex rates, company profiles, indices, bonds, and financial news. ## Base URL All endpoints are served from: ``` https://api.ngnmarket.com/v1 ``` ## Authentication Every request requires a Bearer token in the `Authorization` header: ``` Authorization: Bearer ngm_live_YOUR_KEY ``` Generate and manage your API keys from the [developer dashboard](https://ngnmarket.com/developer). ## Plans & Quotas | Plan | Monthly Calls | Requests/min | Price | | :--- | ---: | ---: | :--- | | Free | 3,000 | 30 | Free | | Hobby | 10,000 | 60 | ₦15,000/mo | | Starter | 100,000 | 120 | ₦50,000/mo | | Growth | 500,000 | 200 | ₦200,000/mo | | Business | 2,000,000 | 300 | ₦700,000/mo | | Enterprise | Unlimited | Unlimited | Custom | Every response includes a `meta` object showing your current usage and remaining quota. Exceeding the per-minute rate limit returns `429 RATE_LIMITED`. Exceeding the monthly quota returns `429 QUOTA_EXCEEDED`. ## Response Envelope All responses use a consistent JSON envelope: ```json { "success": true, "data": { ... }, "meta": { "plan": "starter", "calls_used": 4821, "calls_remaining": 95179, "reset_at": "2026-05-01T00:00:00.000Z" } } ``` contact: name: NGN Market Support email: support@ngnmarket.com url: https://ngnmarket.com license: name: Proprietary servers: - url: https://api.ngnmarket.com/v1 description: Production security: - BearerAuth: [] tags: - name: Market description: >- Daily market snapshots, top trades, movers, market breadth, sectors, and YTD performers. - name: Companies description: >- Browse, search, and retrieve profiles, price charts, and financial statements for NGX-listed companies. - name: Forex description: Current and historical NGN exchange rates against major currencies. - name: Indices description: >- All NGX market indices, including list, detail with constituents, and historical chart data. - name: ETFs description: >- NGX-listed Exchange Traded Funds and ETPs — list, full fund detail, and historical daily price data. - name: Bonds description: >- NGX-listed bond instruments with issuer details, coupon rates, and maturity dates. - name: Disclosures description: >- Official corporate filings from NGX-listed companies (financial statements, AGM notices, board meetings, director dealings, earnings forecasts). Sourced from NGX Group and updated twice daily. - name: Blog description: >- Published NGN Market blog posts. List, search, and filter by category or company. - name: Dividends description: >- Market-wide NGX dividend calendar. Browse upcoming and recently paid dividends across all listed companies with optional search and pagination. - name: Account description: >- Quota status, 30-day request analytics, and paginated request logs for the authenticated user. paths: /bonds: get: tags: - Bonds summary: NGX-listed bond instruments description: > Returns a paginated list of bonds listed on the Nigerian Exchange with ISIN, issuer, type, coupon rate, maturity date, and opening price. Filter by search term or bond type. **Plan required:** Starter operationId: listBonds parameters: - name: page in: query description: Page number. Defaults to `1`. required: false schema: type: integer minimum: 1 default: 1 - name: limit in: query description: Number of bonds per page (1–100). Defaults to `50`. required: false schema: type: integer minimum: 1 maximum: 100 default: 50 - name: search in: query description: Filter by name, issuer, or ISIN. Case-insensitive, partial match. required: false schema: type: string - name: type in: query description: Filter by bond classification. required: false schema: type: string enum: - government - corporate responses: '200': description: Bonds retrieved successfully. content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object properties: data: type: object properties: data: type: array items: $ref: '#/components/schemas/Bond' pagination: $ref: '#/components/schemas/PaginationExtended' examples: governmentBonds: summary: Government bonds page 1 value: 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' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/PlanRequired' '429': $ref: '#/components/responses/QuotaExceeded' '500': $ref: '#/components/responses/ServerError' components: schemas: SuccessEnvelope: type: object required: - success properties: success: type: boolean const: true meta: $ref: '#/components/schemas/Meta' Bond: type: object properties: id: type: integer isin: type: string description: International Securities Identification Number. name: type: string issuer: type: string type: type: string enum: - government - corporate coupon: type: number description: Annual coupon rate as a percentage. issue_date: type: string format: date maturity_date: type: string format: date open_price: type: number created_at: type: string format: date-time updated_at: type: string format: date-time PaginationExtended: type: object properties: page: type: integer example: 1 limit: type: integer example: 20 total: type: integer example: 42 pages: type: integer example: 3 has_next: type: boolean example: true has_prev: type: boolean example: false Meta: type: object description: Quota and plan metadata included on every authenticated response. properties: plan: type: string description: Current plan name. enum: - free - starter - growth - business - enterprise example: starter calls_used: type: integer description: Total calls made this calendar month across all your keys. example: 4821 calls_remaining: type: integer description: Calls remaining before your quota is exhausted. example: 95179 reset_at: type: string format: date-time description: ISO 8601 UTC timestamp of your next quota reset (1st of next month). example: '2026-05-01T00:00:00.000Z' ErrorEnvelope: type: object required: - success - error properties: success: type: boolean const: false error: type: object required: - code - message properties: code: type: string description: Machine-readable error identifier. example: NOT_FOUND message: type: string description: Human-readable error description. example: Resource not found. required_plan: type: string description: _(PLAN_REQUIRED only)_ Minimum plan needed. current_plan: type: string description: _(PLAN_REQUIRED only)_ Your current plan. responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: missingKey: summary: Missing Authorization header value: success: false error: code: MISSING_API_KEY message: 'Provide your API key via: Authorization: Bearer ' invalidKey: summary: Invalid or revoked key value: success: false error: code: INVALID_API_KEY message: API key not found or revoked. PlanRequired: description: Endpoint requires a higher plan. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: success: false error: code: PLAN_REQUIRED message: This endpoint requires a starter plan or higher. required_plan: starter current_plan: free QuotaExceeded: description: Monthly call limit reached. content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorEnvelope' - type: object properties: meta: $ref: '#/components/schemas/Meta' example: success: false error: code: QUOTA_EXCEEDED message: >- Monthly call limit of 100,000 reached. Resets on 2026-05-01T00:00:00.000Z. meta: plan: starter calls_used: 100000 calls_remaining: 0 reset_at: '2026-05-01T00:00:00.000Z' ServerError: description: Unexpected server-side failure. Safe to retry with backoff. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: success: false error: code: SERVER_ERROR message: Something went wrong on our end. Please try again. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: ngm_live_* description: > Pass your API key as a Bearer token: `Authorization: Bearer ngm_live_YOUR_KEY`. Generate keys at [ngnmarket.com/dashboard/developer](https://ngnmarket.com/developer). ````