{
  "openapi": "3.1.0",
  "info": {
    "title": "Kobo Terminal NGX API",
    "version": "1.0.0",
    "summary": "Nigerian stock market (NGX) data API: prices, history since 2000, fundamentals, dividends, ISIN/FIGI, disclosures, insider dealings, bonds, T-bills, ETFs, indices.",
    "description": "The Kobo Terminal NGX API (formerly NGX Pulse API). Free key: https://koboterminal.com/api#get-key. Docs: https://koboterminal.com/docs. MCP server: https://koboterminal.com/mcp.",
    "contact": {
      "name": "Kobo Terminal",
      "email": "hello@koboterminal.com",
      "url": "https://koboterminal.com/docs"
    },
    "x-logo": {
      "url": "https://koboterminal.com/apple-touch-icon.png"
    }
  },
  "externalDocs": {
    "url": "https://koboterminal.com/docs",
    "description": "Kobo Terminal NGX API documentation"
  },
  "servers": [
    {
      "url": "https://koboterminal.com"
    }
  ],
  "security": [
    {
      "ApiKeyHeader": []
    },
    {
      "ApiKeyQuery": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      },
      "ApiKeyQuery": {
        "type": "apiKey",
        "in": "query",
        "name": "api_key"
      }
    }
  },
  "tags": [
    {
      "name": "Market"
    },
    {
      "name": "Indices and ETFs"
    },
    {
      "name": "Company data"
    },
    {
      "name": "Dividends and corporate actions"
    },
    {
      "name": "Bonds and T-bills"
    },
    {
      "name": "Trade flow"
    },
    {
      "name": "NASD, FX and news"
    },
    {
      "name": "Account"
    }
  ],
  "paths": {
    "/api/ngxdata/market": {
      "get": {
        "operationId": "get_market_summary",
        "summary": "Market summary",
        "description": "NGX All-Share Index level and daily change, market capitalisation, volume, value, deals and breadth (advancers, decliners, unchanged).\n\nThe headline numbers for the Nigerian stock market today. The ASI change is the real market-cap-weighted index move from the NGX snapshot, not an average of stock moves. Every response carries `as_of` and `stale_after` so you know exactly how fresh it is.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/market",
        "tags": [
          "Market"
        ],
        "x-plan": "free",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "data": {
                    "asi": 248329.65,
                    "pct_change": -0.4,
                    "volume": 451141250,
                    "deals": 32572,
                    "value": 26608704718.61,
                    "market_cap": 161238118228226.2,
                    "advancers": 30,
                    "decliners": 33,
                    "unchanged": 83,
                    "trade_date": "2026-11-18T00:00:00",
                    "updated_at": "2026-11-18T22:38:18.439Z",
                    "as_of": "2026-11-18T22:38:18.439Z",
                    "stale_after": "2026-11-19T08:00:00.000Z",
                    "market_status": "closed",
                    "market_status_source": "mansaapi-calendar",
                    "source": "NGX"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/market-status": {
      "get": {
        "operationId": "get_market_status",
        "summary": "Market status",
        "description": "Is the NGX open right now? Weekend and Nigerian public-holiday aware.\n\nUse this before polling. NGX trades 10:00 to 14:30 WAT on weekdays, and the calendar includes Nigerian public holidays (for example Eid, Democracy Day, Christmas).\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/market-status",
        "tags": [
          "Market"
        ],
        "x-plan": "free",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "data": {
                    "status": "Closed",
                    "raw_status": "AFTER_HOURS",
                    "is_open": false,
                    "holiday": null,
                    "source": "mansaapi-calendar"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/stocks": {
      "get": {
        "operationId": "list_stocks",
        "summary": "All stocks (daily price list)",
        "description": "Every listed NGX equity in one call: price, previous close, open/high/low, change, 7-day change, volume, value, trades, market cap, shares outstanding and sector.\n\nThe full NGX daily price list as JSON, sorted by market capitalisation. One request returns every equity (about 150), which is usually all you need for a screener, a ticker tape or a portfolio tracker.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/stocks",
        "tags": [
          "Market"
        ],
        "x-plan": "free",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "stocks": [
                    {
                      "symbol": "GTCO",
                      "name": "Guaranty Trust Holding Company Plc",
                      "current_price": 116,
                      "previous_close": 117,
                      "change_percent": -0.85,
                      "official_change_percent": -0.85,
                      "pct_change_7d": -2.93,
                      "open_price": 117,
                      "high_price": 117,
                      "low_price": 115.8,
                      "value": 2232235378.1,
                      "trades": 2147,
                      "volume": 19238323,
                      "market_cap": 4239826623624,
                      "shares_outstanding": 36550229514,
                      "sector": "FINANCIAL SERVICES",
                      "market": "Main Board",
                      "trade_date": "2026-11-18T00:00:00"
                    }
                  ],
                  "total": 146,
                  "total_stocks": 146,
                  "as_of": "2026-11-18T23:17:57.326Z",
                  "stale_after": "2026-11-19T08:00:00.000Z",
                  "market": {
                    "asi": 248329.65,
                    "pct_change": -0.4,
                    "volume": 451141250,
                    "deals": 32572,
                    "value": 26608704718.61,
                    "market_cap": 161238118228226.2,
                    "advancers": 30,
                    "decliners": 33
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/prices/{symbol}": {
      "get": {
        "operationId": "get_price_history",
        "summary": "Price history (OHLCV)",
        "description": "Daily open, high, low, close and volume for one NGX stock, from May 2000 to today.\n\nDaily OHLCV bars for a single stock. Use `days` for the most recent N sessions, or `from`/`to` for a date range. Rows come back oldest first, ready to chart. This is one of the deepest NGX histories available anywhere: more than 25 years for the older listings.\n\nPlan: Free and above. Free keys get the last 7 days. Starter and above get the full daily history back to May 2000.\n\nDocs: https://koboterminal.com/docs/api/prices",
        "tags": [
          "Market"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "description": "NGX ticker",
            "schema": {
              "type": "string"
            },
            "example": "DANGCEM"
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Most recent N trading days",
            "schema": {
              "type": "integer"
            },
            "example": "30"
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Start date, YYYY-MM-DD",
            "schema": {
              "type": "string"
            },
            "example": "2020-01-01"
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "End date, YYYY-MM-DD",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-18"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "symbol": "GTCO",
                  "prices": [
                    {
                      "symbol": "GTCO",
                      "trade_date": "2026-11-17",
                      "open_price": 117.8,
                      "high_price": 118,
                      "low_price": 117,
                      "close_price": 117,
                      "volume": 9701642
                    },
                    {
                      "symbol": "GTCO",
                      "trade_date": "2026-11-18",
                      "open_price": 117,
                      "high_price": 117,
                      "low_price": 115.8,
                      "close_price": 116,
                      "volume": 19238323
                    }
                  ],
                  "count": 2
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/indices": {
      "get": {
        "operationId": "list_indices",
        "summary": "All NGX indices",
        "description": "All 21 NGX indices: ASI, NGX30, NGX Premium, NGX Pension, Banking, Insurance, Consumer Goods, Oil & Gas, Industrial, Lotus Islamic, ASeM and more, with week, month, year and inception change.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/indices",
        "tags": [
          "Indices and ETFs"
        ],
        "x-plan": "free",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "source": "NGX chartdata",
                  "updated_at": "2026-11-18T23:18:08.326Z",
                  "count": 21,
                  "data": [
                    {
                      "code": "ASI",
                      "slug": "asi",
                      "name": "NGX ALL SHARE INDEX",
                      "description": "The All-Share Index tracks the general market movement of all listed equities on Nigerian Exchange, including those listed on the Growth Board, regardless of capitalization.",
                      "currentPrice": 248329.65,
                      "changePercentage": -0.4,
                      "currentDateTime": "2026-11-18T23:17:53.968Z",
                      "points": 7636,
                      "weekChange": -1.58,
                      "monthChange": 0.32,
                      "yearChange": 71.07,
                      "inceptionChange": 4641.78
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/indices/{code}": {
      "get": {
        "operationId": "get_index",
        "summary": "Single index",
        "description": "One NGX index by code or slug.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/index",
        "tags": [
          "Indices and ETFs"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "description": "Index code or slug, e.g. ASI, NGX30, ngx-bnk",
            "schema": {
              "type": "string"
            },
            "example": "NGX30"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "input": "NGX30",
                  "code": "NGX30",
                  "slug": "ngx-30",
                  "updated_at": "2026-11-18T23:18:08.326Z",
                  "data": {
                    "code": "NGX30",
                    "slug": "ngx-30",
                    "name": "NGX 30",
                    "description": "Tracks the top 30 companies in terms of market capitalization and liquidity.",
                    "currentPrice": 9140.44,
                    "changePercentage": -0.41,
                    "currentDateTime": "2026-11-18T23:17:53.968Z",
                    "points": 4442,
                    "weekChange": -1.74,
                    "monthChange": 0.43,
                    "yearChange": 72.11,
                    "inceptionChange": 1146.12
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/indices/{code}/history": {
      "get": {
        "operationId": "get_index_history",
        "summary": "Index history",
        "description": "Daily closing levels for any NGX index, including the full All-Share Index history.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/index-history",
        "tags": [
          "Indices and ETFs"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "description": "Index code or slug",
            "schema": {
              "type": "string"
            },
            "example": "ASI"
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Start date, YYYY-MM-DD",
            "schema": {
              "type": "string"
            },
            "example": "2025-01-01"
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "End date, YYYY-MM-DD",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-18"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "code": "ASI",
                  "slug": "asi",
                  "name": "NGX ALL SHARE INDEX",
                  "count": 4,
                  "first_date": "2026-11-12",
                  "last_date": "2026-11-17",
                  "history": [
                    {
                      "date": "2026-11-12",
                      "value": 252366.8
                    },
                    {
                      "date": "2026-11-13",
                      "value": 252269.16
                    },
                    {
                      "date": "2026-11-16",
                      "value": 252809.78
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/indices/intraday/{code}": {
      "get": {
        "operationId": "get_index_intraday",
        "summary": "Index intraday",
        "description": "Today's intraday points for an index (level, change, value and volume traded) plus the latest live reading.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/index-intraday",
        "tags": [
          "Indices and ETFs"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "description": "Index code",
            "schema": {
              "type": "string"
            },
            "example": "ASI"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "code": "ASI",
                  "as_of": "2026-11-18T22:38:06.526Z",
                  "live": {
                    "code": "ASI",
                    "name": "NGX All-Share Index",
                    "value": 248329.65,
                    "chg_pct": -0.39668111471003076,
                    "high": 249452.08,
                    "low": 248265.12,
                    "val_traded": 21611296010.39003,
                    "vol_traded": 404142572,
                    "updated_at": 1795041486526
                  },
                  "points": [
                    {
                      "ts": "2026-11-18T08:00:00+00:00",
                      "value": 249318.65,
                      "chg_pct": 0,
                      "val_traded": 0,
                      "vol_traded": 0
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/etfs": {
      "get": {
        "operationId": "list_etfs",
        "summary": "All ETFs",
        "description": "Every NGX exchange-traded fund with ISIN, issuer, previous close, open/high/low, change, trades, volume and value.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/etfs",
        "tags": [
          "Indices and ETFs"
        ],
        "x-plan": "free",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "source": "NGX statistics/etfs",
                  "updated_at": "2026-11-18T23:20:39.145Z",
                  "count": 12,
                  "data": [
                    {
                      "symbol": "STANBICETF30",
                      "canonical_symbol": "STANBICETF30",
                      "slug": "stanbicetf30",
                      "name": "Stanbic IBTC ETF 30",
                      "issuer": "Stanbic IBTC Asset Management",
                      "isin": "NGSTBKETF308",
                      "description": "Stanbic IBTC ETF 30 tracks the NGX 30 Index — the 30 largest and most liquid companies on the Nigerian Exchange — providing diversified exposure to Nigeria's blue-chip equities.",
                      "instrument_type": "ETF",
                      "exchange": "NGX",
                      "currency": "NGN",
                      "sector": "Exchange Traded Funds",
                      "previous_close": 939.99,
                      "open": 940,
                      "high": 940,
                      "low": 899,
                      "close": 900,
                      "change": -39.99,
                      "change_percentage": -4.25,
                      "trades": 251,
                      "volume": 29919,
                      "value": 27240114.09,
                      "detail_url": "https://ngxgroup.com/exchange/trade/exchange-traded-funds/listed-etp/etp-details/?isin=NGSTBKETF308&directory=etpdirectory"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/etfs/{symbol}": {
      "get": {
        "operationId": "get_etf",
        "summary": "Single ETF",
        "description": "One ETF by symbol. Common aliases are resolved to the canonical NGX symbol.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/etf",
        "tags": [
          "Indices and ETFs"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "description": "ETF symbol or alias",
            "schema": {
              "type": "string"
            },
            "example": "STANBICETF30"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "input": "STANBICETF30",
                  "canonical_symbol": "STANBICETF30",
                  "updated_at": "2026-11-18T23:20:39.145Z",
                  "data": {
                    "symbol": "STANBICETF30",
                    "canonical_symbol": "STANBICETF30",
                    "slug": "stanbicetf30",
                    "name": "Stanbic IBTC ETF 30",
                    "issuer": "Stanbic IBTC Asset Management",
                    "isin": "NGSTBKETF308",
                    "description": "Stanbic IBTC ETF 30 tracks the NGX 30 Index — the 30 largest and most liquid companies on the Nigerian Exchange — providing diversified exposure to Nigeria's blue-chip equities.",
                    "instrument_type": "ETF",
                    "exchange": "NGX",
                    "currency": "NGN",
                    "sector": "Exchange Traded Funds",
                    "previous_close": 939.99,
                    "open": 940,
                    "high": 940,
                    "low": 899,
                    "close": 900,
                    "change": -39.99,
                    "change_percentage": -4.25,
                    "trades": 251,
                    "volume": 29919,
                    "value": 27240114.09,
                    "detail_url": "https://ngxgroup.com/exchange/trade/exchange-traded-funds/listed-etp/etp-details/?isin=NGSTBKETF308&directory=etpdirectory"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/etfs/resolve/{symbol}": {
      "get": {
        "operationId": "etf_resolve",
        "summary": "Resolve ETF symbol",
        "description": "Map an ETF alias to its canonical NGX symbol, slug and name.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/etf-resolve",
        "tags": [
          "Indices and ETFs"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "description": "ETF symbol or alias",
            "schema": {
              "type": "string"
            },
            "example": "SIAMLETF40"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "input": "SIAMLETF40",
                  "canonical_symbol": "SIAMLETF40",
                  "slug": "siamletf40",
                  "name": "SIAML Pension ETF 40"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/fundamentals": {
      "get": {
        "operationId": "get_fundamentals",
        "summary": "Fundamentals (all stocks)",
        "description": "Valuation, profitability, leverage and dividend metrics for 145 NGX stocks in one call: P/E, forward P/E, EPS, dividend per share, dividend yield, beta, ROE, ROA, P/B, debt/equity, margins, plus EV/EBITDA, PEG, F-score, RSI and analyst consensus.\n\nPlan: Starter and above.\n\nDocs: https://koboterminal.com/docs/api/fundamentals",
        "tags": [
          "Company data"
        ],
        "x-plan": "starter",
        "parameters": [
          {
            "name": "symbols",
            "in": "query",
            "required": false,
            "description": "Comma-separated ticker filter",
            "schema": {
              "type": "string"
            },
            "example": "GTCO,ZENITHBANK,MTNN"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "count": 2,
                  "fundamentals": [
                    {
                      "symbol": "GTCO",
                      "pe_ratio": 5.57,
                      "forward_pe": 4.71,
                      "eps": 21.39,
                      "dividend_per_share": 12.76,
                      "dividend_yield": 10.71,
                      "beta": 0.85,
                      "52w_change": 38.93,
                      "roa": 4.46,
                      "roe": 22.8,
                      "pb_ratio": 1.26,
                      "debt_equity": 0.01,
                      "profit_margin": 44.84,
                      "gross_margin": null,
                      "updated_at": "2026-11-15T05:02:22.431+00:00",
                      "extra": {
                        "rsi": 37.74,
                        "roic": null,
                        "sma_50": 127.32,
                        "f_score": 2,
                        "sma_200": 126.17,
                        "z_score": null,
                        "ev_sales": null,
                        "ps_ratio": 2.53,
                        "ev_ebitda": null,
                        "fcf_yield": -4.32,
                        "peg_ratio": 0.36,
                        "ex_div_date": "Oct 13, 2026",
                        "quick_ratio": null,
                        "payout_ratio": 60.14,
                        "price_target": 155.6,
                        "analyst_count": 3,
                        "current_ratio": null,
                        "earnings_date": "Oct 27, 2026",
                        "earnings_yield": 17.95,
                        "net_income_ttm": 771470000000,
                        "price_at_refresh": 119.29,
                        "analyst_consensus": "Buy",
                        "interest_coverage": null,
                        "shares_outstanding": 36550000000,
                        "dividend_growth_yoy": 58.9,
                        "book_value_per_share": 94.45,
                        "insider_ownership_pct": 0.13,
                        "eps_growth_3y_forecast": 13.29,
                        "rev_growth_3y_forecast": 20.28
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/fundamentals/{symbol}": {
      "get": {
        "operationId": "fundamentals_symbol",
        "summary": "Fundamentals (one stock)",
        "description": "The fundamentals record for a single stock.\n\nPlan: Starter and above.\n\nDocs: https://koboterminal.com/docs/api/fundamentals-symbol",
        "tags": [
          "Company data"
        ],
        "x-plan": "starter",
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "description": "NGX ticker",
            "schema": {
              "type": "string"
            },
            "example": "PRESCO"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "fundamentals": {
                    "symbol": "PRESCO",
                    "pe_ratio": 15.39,
                    "forward_pe": 14.6,
                    "eps": 107.65,
                    "dividend_per_share": 20,
                    "dividend_yield": 1.21,
                    "beta": 0.57,
                    "52w_change": 14.26,
                    "roa": 18.18,
                    "roe": 35.06,
                    "pb_ratio": 3.93,
                    "debt_equity": 0.29,
                    "profit_margin": 36.59,
                    "gross_margin": 78.92,
                    "updated_at": "2026-11-15T05:04:42.252+00:00",
                    "extra": {
                      "rsi": 0.01,
                      "roic": 26.07,
                      "sma_50": 1970.05,
                      "f_score": 5,
                      "sma_200": 2083.98,
                      "z_score": 6.47,
                      "ev_sales": 5.83,
                      "ps_ratio": 5.81,
                      "ev_ebitda": 8.56,
                      "fcf_yield": -1.31,
                      "peg_ratio": null,
                      "ex_div_date": "Aug 17, 2026",
                      "quick_ratio": 1.48,
                      "payout_ratio": 48.27,
                      "price_target": 1892.05,
                      "analyst_count": 3,
                      "current_ratio": 3.08,
                      "earnings_date": "Jan 29, 2027",
                      "earnings_yield": 6.5,
                      "net_income_ttm": 121740000000,
                      "price_at_refresh": 1649.57,
                      "analyst_consensus": "Hold",
                      "interest_coverage": 5.93,
                      "shares_outstanding": 1170000000,
                      "dividend_growth_yoy": -65.75,
                      "book_value_per_share": 422,
                      "insider_ownership_pct": 0.04,
                      "eps_growth_3y_forecast": 14.11,
                      "rev_growth_3y_forecast": 17.68
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/identifiers": {
      "get": {
        "operationId": "lookup_identifiers",
        "summary": "ISIN and FIGI security master",
        "description": "Maps every NGX ticker to its ISIN and FIGI. 152 securities, 147 with a verified ISIN. Resolve an ISIN or FIGI back to a ticker.\n\nIdentifiers are validated against the ISO 6166 check digit and cross-checked against a second independent source before publication. They are never computed or guessed: where a listing has no assigned ISIN the field is null. Useful for custody, settlement, portfolio imports and joining NGX data to global datasets.\n\nPlan: Starter and above.\n\nDocs: https://koboterminal.com/docs/api/identifiers",
        "tags": [
          "Company data"
        ],
        "x-plan": "starter",
        "parameters": [
          {
            "name": "isin",
            "in": "query",
            "required": false,
            "description": "Resolve an ISIN to its security",
            "schema": {
              "type": "string"
            },
            "example": "NGDANGCEM008"
          },
          {
            "name": "figi",
            "in": "query",
            "required": false,
            "description": "Resolve a FIGI to its security",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "identified_only",
            "in": "query",
            "required": false,
            "description": "Only securities with at least one identifier",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, default 200, max 500",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Pagination offset",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "count": 1,
                  "total": 1,
                  "limit": 200,
                  "offset": 0,
                  "has_more": false,
                  "identifiers": [
                    {
                      "symbol": "DANGCEM",
                      "legal_name": "Dangote Cement Plc",
                      "isin": "NGDANGCEM008",
                      "figi": "BBG0017Z8Z24",
                      "isin_verified_at": "2026-09-12T03:21:20.248916+00:00"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/identifiers/{symbol}": {
      "get": {
        "operationId": "identifiers_symbol",
        "summary": "Identifiers (one stock)",
        "description": "ISIN and FIGI for a single ticker.\n\nPlan: Starter and above.\n\nDocs: https://koboterminal.com/docs/api/identifiers-symbol",
        "tags": [
          "Company data"
        ],
        "x-plan": "starter",
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "description": "NGX ticker",
            "schema": {
              "type": "string"
            },
            "example": "DANGCEM"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "isin_coverage": "verified",
                  "identifiers": {
                    "symbol": "DANGCEM",
                    "legal_name": "Dangote Cement Plc",
                    "isin": "NGDANGCEM008",
                    "figi": "BBG0017Z8Z24",
                    "isin_verified_at": "2026-09-12T03:21:20.248916+00:00"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/disclosures": {
      "get": {
        "operationId": "get_disclosures",
        "summary": "Corporate disclosures",
        "description": "NGX corporate filings: financial statements, board meeting notices, dividend declarations, director dealings, AGM notices and more, with links to the original PDFs.\n\nPlan: Starter and above.\n\nDocs: https://koboterminal.com/docs/api/disclosures",
        "tags": [
          "Company data"
        ],
        "x-plan": "starter",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "Filter by ticker",
            "schema": {
              "type": "string"
            },
            "example": "MTNN"
          },
          {
            "name": "company",
            "in": "query",
            "required": false,
            "description": "Filter by company name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Filter by submission type, e.g. Financial Statements",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Number of filings, or \"all\"",
            "schema": {
              "type": "integer"
            },
            "example": "20"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "data": [
                    {
                      "symbol": "MTNN",
                      "company": "MTN Nigeria Communications Plc",
                      "title": "MTN NIGERIA COMMUNICATIONS PLC-NGX NOTIFICATION ON BOARD CHANGES",
                      "url": "https://doclib.ngxgroup.com/Financial_NewsDocs/48362_MTN_NIGERIA_COMMUNICATIONS_PLC-NGX_NOTIFICATION_ON_BOARD_CHANGES_CORPORATE_ACTIONS_NOVEMBER_2026.pdf",
                      "type": "Corporate Actions",
                      "created": "2026-11-03T16:16:23+00:00",
                      "modified": "2026-11-03T16:16:23+00:00"
                    }
                  ],
                  "source": "supabase",
                  "count": 2
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/insider-signal": {
      "get": {
        "operationId": "get_insider_dealings",
        "summary": "Director dealings (insider trades)",
        "description": "Structured director-dealing filings: who bought or sold, role, volume, price, total value and holdings after the trade, plus weekly net insider flow and the most active tickers.\n\nPlan: Professional and above. Professional and above get the full feed. Lower tiers receive a limited preview.\n\nDocs: https://koboterminal.com/docs/api/insider-signal",
        "tags": [
          "Company data"
        ],
        "x-plan": "professional",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "Filter by ticker",
            "schema": {
              "type": "string"
            },
            "example": "FIRSTHOLDCO"
          },
          {
            "name": "side",
            "in": "query",
            "required": false,
            "description": "buy or sell",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Only filings from the last N days",
            "schema": {
              "type": "integer"
            },
            "example": "30"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Max rows, default 100, max 500",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "count": 2,
                  "data": [
                    {
                      "symbol": "NEIMETH",
                      "company": "NEIMETH INTERNATIONAL PHARMACEUTICALS PLC",
                      "insider_name": "Clinoscope Services Limited",
                      "role": "Substantial Shareholder",
                      "transaction_type": "buy",
                      "volume": 74726661,
                      "price": 6,
                      "total_value": 448359966,
                      "post_trade_holdings": null,
                      "dealing_date": "2026-11-10",
                      "disclosure_created_at": "2026-11-13T20:15:04+00:00",
                      "pdf_url": "https://doclib.ngxgroup.com/Financial_NewsDocs/118_DEALING_IN_SHARES_CLINOSCOPE_PURCHASES_NOVEMBER_2026.pdf"
                    }
                  ],
                  "stats": {
                    "week_net_flow": 318859966,
                    "week_total_buys": 448359966,
                    "week_total_sells": 129500000,
                    "week_dealings": 2,
                    "biggest_buy": {
                      "symbol": "NEIMETH",
                      "transaction_type": "buy",
                      "total_value": 448359966,
                      "volume": 74726661
                    },
                    "biggest_sell": {
                      "symbol": "ACCESSCORP",
                      "transaction_type": "sell",
                      "total_value": 129500000,
                      "volume": 5000000
                    },
                    "top_tickers": [
                      {
                        "symbol": "NEIMETH",
                        "net": 448359966,
                        "buys": 448359966,
                        "sells": 0
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/dividends/{symbol}": {
      "get": {
        "operationId": "get_dividend_history",
        "summary": "Dividend history",
        "description": "Every dividend a company has paid: amount per share, ex-dividend date, record (qualification) date and payment date.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/dividends",
        "tags": [
          "Dividends and corporate actions"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "description": "NGX ticker",
            "schema": {
              "type": "string"
            },
            "example": "GTCO"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Number of payments, or \"all\" (default)",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "symbol": "GTCO",
                  "company_name": null,
                  "source": "stored",
                  "count": 11,
                  "latest_ex_dividend_date": "2026-10-13",
                  "history": [
                    {
                      "exchange": "NGX",
                      "symbol": "GTCO",
                      "company_name": "GTCO ",
                      "ex_dividend_date": "2026-10-13",
                      "record_date": "2026-10-13",
                      "pay_date": "2026-10-20",
                      "dividend_per_share": 1,
                      "raw_amount_text": "1.000 NGN",
                      "currency": "NGN",
                      "raw_declared_text": null,
                      "created_at": "2026-11-01T02:00:04.873+00:00",
                      "updated_at": "2026-11-01T02:00:04.873+00:00"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/dividends-calendar": {
      "get": {
        "operationId": "get_dividend_calendar",
        "summary": "Dividend calendar",
        "description": "Dividends across the whole market by ex-dividend date. Use `upcoming=true` for what is coming next.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/dividends-calendar",
        "tags": [
          "Dividends and corporate actions"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "upcoming",
            "in": "query",
            "required": false,
            "description": "Only ex-dates from today forward, soonest first",
            "schema": {
              "type": "boolean"
            },
            "example": "true"
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Earliest ex-date, YYYY-MM-DD (default 90 days ago)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Latest ex-date, YYYY-MM-DD",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "Filter by ticker",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Default 200, max 500",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "from": "2026-11-18",
                  "to": null,
                  "upcoming": true,
                  "count": 1,
                  "dividends": [
                    {
                      "symbol": "ZENITHBANK",
                      "company_name": "Zenith Bank Plc",
                      "ex_dividend_date": "2026-11-27",
                      "record_date": "2026-11-28",
                      "pay_date": "2026-12-08",
                      "dividend_per_share": 1.25,
                      "currency": "NGN"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/offers": {
      "get": {
        "operationId": "get_offers",
        "summary": "Public offers, rights issues and IPOs",
        "description": "Open and recent NGX public offers, rights issues and IPOs with unit price, opening and closing dates and days remaining.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/offers",
        "tags": [
          "Dividends and corporate actions"
        ],
        "x-plan": "free",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "source": "ngx_invest_snapshot",
                  "updated_at": "2026-11-16T08:00:00Z",
                  "count": 1,
                  "data": [
                    {
                      "id": "abc123",
                      "name": "Example Plc Rights Issue",
                      "type": "RIGHTS_ISSUE",
                      "type_label": "Rights Issue",
                      "status": "Open",
                      "days_remaining": 9,
                      "unit_price": 12.5,
                      "start_date": "2026-11-03",
                      "end_date": "2026-11-27",
                      "issuer": "Example Plc",
                      "source_url": "https://www.invest.ngxgroup.com/portal"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/bonds": {
      "get": {
        "operationId": "get_bonds",
        "summary": "Bonds",
        "description": "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).\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/bonds",
        "tags": [
          "Bonds and T-bills"
        ],
        "x-plan": "free",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/ngxdata/bonds/auctions": {
      "get": {
        "operationId": "get_tbill_auctions",
        "summary": "Treasury bill auctions",
        "description": "CBN Nigerian Treasury Bill auction results: tenor, amount offered, subscribed and allotted, subscription rate, stop rate and yields.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/bond-auctions",
        "tags": [
          "Bonds and T-bills"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Number of auction rows, default 50, max 500",
            "schema": {
              "type": "integer"
            },
            "example": "6"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "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"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/whale-flow": {
      "get": {
        "operationId": "get_block_trade_flow",
        "summary": "Block-trade flow (market)",
        "description": "Net buying and selling in large trades (₦10 million and up) by stock over the last N days: where the big money is going.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/whale-flow",
        "tags": [
          "Trade flow"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Window in days, 1 to 90 (default 30)",
            "schema": {
              "type": "integer"
            },
            "example": "30"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "days": 30,
                  "as_of": "2026-11-18T22:39:34.975Z",
                  "count": 77,
                  "inflow": [
                    {
                      "symbol": "SEPLAT",
                      "name": "SEPLAT ENERGY PLC",
                      "buy_value": 11542002195.1,
                      "sell_value": 5914461576.1,
                      "unknown_value": 262753642.2,
                      "net_value": 5627540619,
                      "trade_count": 222,
                      "last_trade": "2026-11-18T15:00:00.002+00:00"
                    }
                  ],
                  "outflow": [
                    {
                      "symbol": "ARADEL",
                      "name": "ARADEL HOLDINGS PLC",
                      "buy_value": 235569084.7,
                      "sell_value": 13743966685.9,
                      "unknown_value": 28100000,
                      "net_value": -13508397601.2,
                      "trade_count": 402,
                      "last_trade": "2026-11-18T13:58:12.394+00:00"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/whale-flow/{symbol}": {
      "get": {
        "operationId": "whale_flow_symbol",
        "summary": "Block-trade flow (one stock)",
        "description": "Daily net block-trade flow and the 20 most recent large trades for one stock.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/whale-flow-symbol",
        "tags": [
          "Trade flow"
        ],
        "x-plan": "free",
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "description": "NGX ticker",
            "schema": {
              "type": "string"
            },
            "example": "GTCO"
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Window in days, 1 to 90 (default 30)",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "symbol": "GTCO",
                  "days": 30,
                  "count": 358,
                  "buy_value": 7927614479.5,
                  "sell_value": 14736560848.999996,
                  "unknown_value": 1259138711,
                  "net_value": -6808946369.499996,
                  "daily": [
                    {
                      "date": "2026-11-18",
                      "buy_value": 0,
                      "sell_value": 1209040686.4,
                      "net_value": -1209040686.4,
                      "trades": 28
                    }
                  ],
                  "recent": [
                    {
                      "id": "20261118-000050174801",
                      "price": 115.9,
                      "qty": 90340,
                      "value": 10470406,
                      "time": "2026-11-18T15:00:00.002+00:00",
                      "side": "sell"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/nasddata/stocks": {
      "get": {
        "operationId": "list_nasd_stocks",
        "summary": "NASD OTC stocks",
        "description": "Prices for securities on the NASD OTC Securities Exchange (unlisted Nigerian companies such as NASD Plc, Friesland Campina WAMCO, Central Securities Clearing System and more).\n\nPlan: Starter and above.\n\nDocs: https://koboterminal.com/docs/api/nasd-stocks",
        "tags": [
          "NASD, FX and news"
        ],
        "x-plan": "starter",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "stocks": [
                    {
                      "symbol": "SD11PLC",
                      "name": "11 PLC",
                      "price": 247.5,
                      "change": 0,
                      "volume": null,
                      "shares_outstanding": 360595261,
                      "market_cap": 83333564817,
                      "date": "2026-11-17",
                      "scraped_at": "2026-11-18T12:30:03.33+00:00",
                      "spark": [
                        220.2
                      ],
                      "computed_change": 0.05,
                      "last_trade_date": "2026-11-17"
                    }
                  ],
                  "total": 47,
                  "as_of": "2026-11-17"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/nasddata/history/{symbol}": {
      "get": {
        "operationId": "nasd_history",
        "summary": "NASD OTC price history",
        "description": "Daily closing price, change and market capitalisation for one NASD OTC security, oldest first.\n\nPlan: Professional and above.\n\nDocs: https://koboterminal.com/docs/api/nasd-history",
        "tags": [
          "NASD, FX and news"
        ],
        "x-plan": "professional",
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "description": "NASD symbol (with or without the SD prefix)",
            "schema": {
              "type": "string"
            },
            "example": "NASDPLC"
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Number of days, default 90",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "symbol": "NASDPLC",
                  "name": "NASD Plc",
                  "history": [
                    {
                      "symbol": "SDNASDPLC",
                      "date": "2026-11-16",
                      "close": 30.56,
                      "change_amt": 0,
                      "change_pct": 0,
                      "volume": null,
                      "market_cap": 20376000000
                    },
                    {
                      "symbol": "SDNASDPLC",
                      "date": "2026-11-17",
                      "close": 30.56,
                      "change_amt": 0,
                      "change_pct": 0,
                      "volume": 3182,
                      "market_cap": 20376000000
                    }
                  ],
                  "total": 2,
                  "first_date": "2026-11-16",
                  "last_date": "2026-11-17"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/forex/rates": {
      "get": {
        "operationId": "get_fx_rates",
        "summary": "FX rates (NGN)",
        "description": "Naira exchange rates against USD, EUR, GBP, CAD, AUD, CNY, JPY, GHS, ZAR and AED.\n\nPlan: Professional and above.\n\nDocs: https://koboterminal.com/docs/api/forex",
        "tags": [
          "NASD, FX and news"
        ],
        "x-plan": "professional",
        "parameters": [
          {
            "name": "symbols",
            "in": "query",
            "required": false,
            "description": "Comma-separated currency codes",
            "schema": {
              "type": "string"
            },
            "example": "USD,GBP,EUR"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "source": "ExchangeRate API",
                  "base_code": "NGN",
                  "updated_at": "2026-11-18T00:02:31.000Z",
                  "next_update_at": "2026-11-19T00:34:21.000Z",
                  "fetched_at": "2026-11-18T22:38:16.259Z",
                  "stale": false,
                  "rates": {
                    "USD": {
                      "code": "USD",
                      "rate": 1352.74
                    },
                    "GBP": {
                      "code": "GBP",
                      "rate": 1785.57
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/news": {
      "get": {
        "operationId": "get_market_news",
        "summary": "Market news",
        "description": "Latest Nigerian business and capital-market headlines from BusinessDay, Nairametrics, Premium Times, SEC Nigeria and more.\n\nPlan: Starter and above.\n\nDocs: https://koboterminal.com/docs/api/news",
        "tags": [
          "NASD, FX and news"
        ],
        "x-plan": "starter",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "news": [
                    {
                      "title": "Education investment is security investment, Buratai tells African governments",
                      "link": "https://businessday.ng/education/article/education-investment-is-security-investment-buratai-tells-african-governments/",
                      "description": "&#8230; warns 98m out-of-school children face terrorist recruitment risks Investment in education must be treated as a critical component of read more Education investment is security investment, Buratai tells African governments ]]>",
                      "image": "https://cdn.businessday.ng/wp-content/uploads/2026/11/IMG-20261118-WA0002-1024x682.jpg",
                      "published_at": "2026-11-18T20:13:26.000Z",
                      "source": "BusinessDay"
                    }
                  ],
                  "updated_at": "2026-11-18T22:39:41.311Z"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    },
    "/api/keys/info": {
      "get": {
        "operationId": "get_my_usage",
        "summary": "Key info and usage",
        "description": "Your plan, requests used today, daily limit, per-minute limit and lifetime requests.\n\nPlan: Free and above.\n\nDocs: https://koboterminal.com/docs/api/key-info",
        "tags": [
          "Account"
        ],
        "x-plan": "free",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "example": {
                  "id": 1234,
                  "name": "My app",
                  "email": "you@example.com",
                  "tier": "free",
                  "requests_today": 12,
                  "requests_limit": 100,
                  "rate_limit": 10,
                  "total_requests": 3410,
                  "last_request_at": "2026-11-18T13:19:02Z"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Plan upgrade required, or key inactive"
          },
          "429": {
            "description": "Daily limit exceeded (resets midnight WAT)"
          }
        }
      }
    }
  }
}