# Kobo Terminal NGX API > The Nigerian stock market data API: live prices for every NGX-listed stock, daily price history back to May 2000, fundamentals, dividends, ISIN/FIGI identifiers, corporate disclosures, director dealings, FGN bonds, T-bill auctions, ETFs and all 21 NGX indices. JSON over HTTPS, free key in seconds. Kobo Terminal (formerly **NGX Pulse**) serves Nigerian market data to developers, fintechs, brokers and researchers. The API is the same data that powers [koboterminal.com](https://koboterminal.com), Nigeria's free stock market terminal. ## Why developers pick Kobo Terminal - **Deepest NGX history.** Daily OHLCV from **May 2000** to today: more than 25 years for the older listings. Backtest real cycles: the 2008 crash, the 2016 devaluation, the 2023-26 bull run. - **Every NGX stock in one call.** `/api/ngxdata/stocks` returns the full daily price list (about 150 equities) with open, high, low, close, volume, value, trades and market cap. - **A verified security master.** ISIN and FIGI for 152 NGX securities, check-digit validated and cross-checked against a second source, never guessed. - **Income data that is actually complete.** Dividend history with ex-dates, qualification dates and pay dates, plus a market-wide dividend calendar. - **Signals you cannot get elsewhere.** Director dealings (insider trades) parsed from NGX filings, and block-trade flow showing where ₦10M+ trades are going. - **Fixed income too.** FGN bonds, Eurobonds, Sukuk and corporate bonds listed on the NGX, plus every CBN Treasury bill auction with stop rates and subscription levels. - **Built for AI.** A hosted [MCP server](https://koboterminal.com/docs/mcp) at `https://koboterminal.com/mcp`, an [agent skill](https://koboterminal.com/docs/agent-skill) for coding assistants, an [OpenAPI spec](https://koboterminal.com/openapi.json) and [llms.txt](https://koboterminal.com/docs/llms.txt). - **Transparent sources.** Every dataset names where it comes from: see [Data sources](https://koboterminal.com/docs/data-sources). ## Quick example ```bash curl "https://koboterminal.com/api/ngxdata/prices/DANGCEM?days=5" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```json { "success": true, "symbol": "DANGCEM", "count": 5, "prices": [ { "trade_date": "2026-11-12", "open_price": 1469.9, "close_price": 1469.9, "volume": 376126 } ] } ``` ## Get started 1. [Get a free API key](https://koboterminal.com/api#get-key) (instant, no card): 100 requests a day. 2. Follow the [Quickstart](https://koboterminal.com/docs/quickstart): first request in under two minutes. 3. Browse the [endpoints](#endpoints) below, or connect your AI assistant through the [MCP server](https://koboterminal.com/docs/mcp). ## Plans | Plan | Price (NGN) | Price (USD) | Requests / day | Requests / min | Best for | |---|---|---|---|---|---| | **Free** | Free | Free | 100 | 10 | Learning, prototypes, personal dashboards | | **Starter** | ₦29,000/mo | $20/mo | 1,000 | 20 | Solo builders and small apps | | **Professional** | ₦75,000/mo | $50/mo | 10,000 | 60 | Production apps, fintechs, client work | | **Institutional** | ₦350,000/mo | $200/mo | 50,000 | 120 | Brokers, asset managers, trading terminals | Full details: [Plans and pricing](https://koboterminal.com/docs/plans). Pay in naira (bank transfer or card) or USD (card). ## Endpoints Base URL: `https://koboterminal.com`. Authentication: `X-API-Key` header. ### Market | Endpoint | What it returns | Plan | |---|---|---| | [`GET /api/ngxdata/market`](https://koboterminal.com/docs/api/market) | NGX All-Share Index level and daily change, market capitalisation, volume, value, deals and breadth (advancers, decliners, unchanged). | Free | | [`GET /api/ngxdata/market-status`](https://koboterminal.com/docs/api/market-status) | Is the NGX open right now? Weekend and Nigerian public-holiday aware. | Free | | [`GET /api/ngxdata/stocks`](https://koboterminal.com/docs/api/stocks) | 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. | Free | | [`GET /api/ngxdata/prices/{symbol}`](https://koboterminal.com/docs/api/prices) | Daily open, high, low, close and volume for one NGX stock, from May 2000 to today. | Free | ### Indices and ETFs | Endpoint | What it returns | Plan | |---|---|---| | [`GET /api/ngxdata/indices`](https://koboterminal.com/docs/api/indices) | 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. | Free | | [`GET /api/ngxdata/indices/{code}`](https://koboterminal.com/docs/api/index) | One NGX index by code or slug. | Free | | [`GET /api/ngxdata/indices/{code}/history`](https://koboterminal.com/docs/api/index-history) | Daily closing levels for any NGX index, including the full All-Share Index history. | Free | | [`GET /api/ngxdata/indices/intraday/{code}`](https://koboterminal.com/docs/api/index-intraday) | Today's intraday points for an index (level, change, value and volume traded) plus the latest live reading. | Free | | [`GET /api/ngxdata/etfs`](https://koboterminal.com/docs/api/etfs) | Every NGX exchange-traded fund with ISIN, issuer, previous close, open/high/low, change, trades, volume and value. | Free | | [`GET /api/ngxdata/etfs/{symbol}`](https://koboterminal.com/docs/api/etf) | One ETF by symbol. Common aliases are resolved to the canonical NGX symbol. | Free | | [`GET /api/ngxdata/etfs/resolve/{symbol}`](https://koboterminal.com/docs/api/etf-resolve) | Map an ETF alias to its canonical NGX symbol, slug and name. | Free | ### Company data | Endpoint | What it returns | Plan | |---|---|---| | [`GET /api/ngxdata/fundamentals`](https://koboterminal.com/docs/api/fundamentals) | 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. | Starter | | [`GET /api/ngxdata/fundamentals/{symbol}`](https://koboterminal.com/docs/api/fundamentals-symbol) | The fundamentals record for a single stock. | Starter | | [`GET /api/ngxdata/identifiers`](https://koboterminal.com/docs/api/identifiers) | 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. | Starter | | [`GET /api/ngxdata/identifiers/{symbol}`](https://koboterminal.com/docs/api/identifiers-symbol) | ISIN and FIGI for a single ticker. | Starter | | [`GET /api/ngxdata/disclosures`](https://koboterminal.com/docs/api/disclosures) | NGX corporate filings: financial statements, board meeting notices, dividend declarations, director dealings, AGM notices and more, with links to the original PDFs. | Starter | | [`GET /api/ngxdata/insider-signal`](https://koboterminal.com/docs/api/insider-signal) | 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. | Professional | ### Dividends and corporate actions | Endpoint | What it returns | Plan | |---|---|---| | [`GET /api/ngxdata/dividends/{symbol}`](https://koboterminal.com/docs/api/dividends) | Every dividend a company has paid: amount per share, ex-dividend date, record (qualification) date and payment date. | Free | | [`GET /api/ngxdata/dividends-calendar`](https://koboterminal.com/docs/api/dividends-calendar) | Dividends across the whole market by ex-dividend date. Use `upcoming=true` for what is coming next. | Free | | [`GET /api/ngxdata/offers`](https://koboterminal.com/docs/api/offers) | Open and recent NGX public offers, rights issues and IPOs with unit price, opening and closing dates and days remaining. | Free | ### Bonds and T-bills | Endpoint | What it returns | Plan | |---|---|---| | [`GET /api/ngxdata/bonds`](https://koboterminal.com/docs/api/bonds) | 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). | Free | | [`GET /api/ngxdata/bonds/auctions`](https://koboterminal.com/docs/api/bond-auctions) | CBN Nigerian Treasury Bill auction results: tenor, amount offered, subscribed and allotted, subscription rate, stop rate and yields. | Free | ### Trade flow | Endpoint | What it returns | Plan | |---|---|---| | [`GET /api/whale-flow`](https://koboterminal.com/docs/api/whale-flow) | Net buying and selling in large trades (₦10 million and up) by stock over the last N days: where the big money is going. | Free | | [`GET /api/whale-flow/{symbol}`](https://koboterminal.com/docs/api/whale-flow-symbol) | Daily net block-trade flow and the 20 most recent large trades for one stock. | Free | ### NASD, FX and news | Endpoint | What it returns | Plan | |---|---|---| | [`GET /api/nasddata/stocks`](https://koboterminal.com/docs/api/nasd-stocks) | 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). | Starter | | [`GET /api/nasddata/history/{symbol}`](https://koboterminal.com/docs/api/nasd-history) | Daily closing price, change and market capitalisation for one NASD OTC security, oldest first. | Professional | | [`GET /api/forex/rates`](https://koboterminal.com/docs/api/forex) | Naira exchange rates against USD, EUR, GBP, CAD, AUD, CNY, JPY, GHS, ZAR and AED. | Professional | | [`GET /api/news`](https://koboterminal.com/docs/api/news) | Latest Nigerian business and capital-market headlines from BusinessDay, Nairametrics, Premium Times, SEC Nigeria and more. | Starter | ### Account | Endpoint | What it returns | Plan | |---|---|---| | [`GET /api/keys/info`](https://koboterminal.com/docs/api/key-info) | Your plan, requests used today, daily limit, per-minute limit and lifetime requests. | Free | ## Guides - [Quickstart](https://koboterminal.com/docs/quickstart) - [Authentication](https://koboterminal.com/docs/authentication) - [Plans and pricing](https://koboterminal.com/docs/plans) - [Rate limits and errors](https://koboterminal.com/docs/errors) - [Data sources and freshness](https://koboterminal.com/docs/data-sources) - [MCP server for Claude, ChatGPT and Cursor](https://koboterminal.com/docs/mcp) - [Agent skill for coding assistants](https://koboterminal.com/docs/agent-skill) - [OpenAPI 3.1 spec](https://koboterminal.com/openapi.json) --- # Quickstart > Get a key, make a request, chart a stock. Under two minutes. ## 1. Get a free key Go to [https://koboterminal.com/api#get-key](https://koboterminal.com/api#get-key), enter your name and email, and choose **Personal / Learning**. Your key is issued straight away (you may be asked to confirm your email first) and looks like `kobo_xxxxxxxxxxxxxxxx`. Older keys from our NGX Pulse days start with `ngxpulse_` and keep working. Store it in an environment variable: ```bash export KOBO_API_KEY="kobo_your_key_here" ``` ## 2. Fetch every NGX stock ```bash curl "https://koboterminal.com/api/ngxdata/stocks" -H "X-API-Key: $KOBO_API_KEY" ``` You get the full NGX daily price list: about 150 stocks with price, change, volume, value and market cap. ## 3. Get a price history and chart it (Python) ```python import os, requests import matplotlib.pyplot as plt r = requests.get( "https://koboterminal.com/api/ngxdata/prices/GTCO", params={"from": "2025-01-01"}, # Starter plan: full history back to 2000 headers={"X-API-Key": os.environ["KOBO_API_KEY"]}, timeout=30, ) r.raise_for_status() rows = r.json()["prices"] # oldest first plt.plot([x["trade_date"] for x in rows], [x["close_price"] for x in rows]) plt.title("GTCO close, NGN") plt.show() ``` Free keys can request the last 7 days (`?days=7`). Longer ranges need [Starter](https://koboterminal.com/docs/plans). ## 4. JavaScript / Node.js ```javascript const res = await fetch("https://koboterminal.com/api/ngxdata/market", { headers: { "X-API-Key": process.env.KOBO_API_KEY }, }); const { data } = await res.json(); console.log(`ASI ${data.asi} (${data.pct_change}%)`); ``` ## 5. Check your usage ```bash curl "https://koboterminal.com/api/keys/info" -H "X-API-Key: $KOBO_API_KEY" ``` ## Next steps - Browse all [endpoints](https://koboterminal.com/docs#endpoints) - Let your AI assistant call the API: [MCP server](https://koboterminal.com/docs/mcp) or [agent skill](https://koboterminal.com/docs/agent-skill) - See [Rate limits and errors](https://koboterminal.com/docs/errors) --- # Authentication > Every request carries your API key in the `X-API-Key` header. ```http GET https://koboterminal.com/api/ngxdata/stocks X-API-Key: kobo_your_key_here ``` If you cannot set headers (for example in Google Sheets `IMPORTDATA` or a quick browser test), pass it as a query parameter instead: ``` https://koboterminal.com/api/ngxdata/market?api_key=kobo_your_key_here ``` The header is preferred: query strings end up in logs and browser history. ## Getting a key - **Free:** self-serve at [https://koboterminal.com/api#get-key](https://koboterminal.com/api#get-key), issued straight away. One free key per email. - **Paid plans:** choose a plan on the same page and pay by card or naira bank transfer. Your key is upgraded in place, so your code does not change. ## Keep your key secret - Call the API from your server, not from browser JavaScript or a mobile app bundle. - Store it in an environment variable or secrets manager, never in a public repo. - If a key leaks, revoke it (`POST /api/keys/revoke` with the key) and request a new one. ## Key format New keys start with `kobo_`. Keys issued under our former name, NGX Pulse, start with `ngxpulse_` and keep working on koboterminal.com. --- # Plans and pricing > Start free. Upgrade when you need history, fundamentals or production limits. Same key, same code. | Plan | Price (NGN) | Price (USD) | Requests / day | Requests / min | Best for | |---|---|---|---|---|---| | **Free** | Free | Free | 100 | 10 | Learning, prototypes, personal dashboards | | **Starter** | ₦29,000/mo | $20/mo | 1,000 | 20 | Solo builders and small apps | | **Professional** | ₦75,000/mo | $50/mo | 10,000 | 60 | Production apps, fintechs, client work | | **Institutional** | ₦350,000/mo | $200/mo | 50,000 | 120 | Brokers, asset managers, trading terminals | Annual billing is available on every paid plan. Pay in **naira** (bank transfer or card, renews by reminder, never automatically) or **USD** (card, renews automatically). [Choose a plan](https://koboterminal.com/api#get-key). ## What each plan includes - **Free:** Live prices for every NGX stock, market summary, indices, ETFs, bonds, T-bill auctions, dividends, IPOs and offers, block-trade flow, last 7 days of price history. - **Starter:** Everything in Free, plus full price history back to 2000, fundamentals (P/E, EPS, ROE, dividend yield, 40+ ratios), ISIN/FIGI security master, corporate disclosures, NASD OTC prices, market news. - **Professional:** Everything in Starter, plus NGN FX rates, NASD OTC price history, full insider (director dealings) feed, commercial use. - **Institutional:** Everything in Professional, plus 50,000 requests/day, priority support and custom limits on request. ## Endpoint access by plan | Endpoint | Free | Starter | Professional | Institutional | |---|---|---|---|---| | [`/api/ngxdata/market`](https://koboterminal.com/docs/api/market) | yes | yes | yes | yes | | [`/api/ngxdata/market-status`](https://koboterminal.com/docs/api/market-status) | yes | yes | yes | yes | | [`/api/ngxdata/stocks`](https://koboterminal.com/docs/api/stocks) | yes | yes | yes | yes | | [`/api/ngxdata/prices/{symbol}`](https://koboterminal.com/docs/api/prices) | last 7 days | yes | yes | yes | | [`/api/ngxdata/indices`](https://koboterminal.com/docs/api/indices) | yes | yes | yes | yes | | [`/api/ngxdata/indices/{code}`](https://koboterminal.com/docs/api/index) | yes | yes | yes | yes | | [`/api/ngxdata/indices/{code}/history`](https://koboterminal.com/docs/api/index-history) | yes | yes | yes | yes | | [`/api/ngxdata/indices/intraday/{code}`](https://koboterminal.com/docs/api/index-intraday) | yes | yes | yes | yes | | [`/api/ngxdata/etfs`](https://koboterminal.com/docs/api/etfs) | yes | yes | yes | yes | | [`/api/ngxdata/etfs/{symbol}`](https://koboterminal.com/docs/api/etf) | yes | yes | yes | yes | | [`/api/ngxdata/etfs/resolve/{symbol}`](https://koboterminal.com/docs/api/etf-resolve) | yes | yes | yes | yes | | [`/api/ngxdata/fundamentals`](https://koboterminal.com/docs/api/fundamentals) | · | yes | yes | yes | | [`/api/ngxdata/fundamentals/{symbol}`](https://koboterminal.com/docs/api/fundamentals-symbol) | · | yes | yes | yes | | [`/api/ngxdata/identifiers`](https://koboterminal.com/docs/api/identifiers) | · | yes | yes | yes | | [`/api/ngxdata/identifiers/{symbol}`](https://koboterminal.com/docs/api/identifiers-symbol) | · | yes | yes | yes | | [`/api/ngxdata/disclosures`](https://koboterminal.com/docs/api/disclosures) | · | yes | yes | yes | | [`/api/ngxdata/insider-signal`](https://koboterminal.com/docs/api/insider-signal) | preview | preview | yes | yes | | [`/api/ngxdata/dividends/{symbol}`](https://koboterminal.com/docs/api/dividends) | yes | yes | yes | yes | | [`/api/ngxdata/dividends-calendar`](https://koboterminal.com/docs/api/dividends-calendar) | yes | yes | yes | yes | | [`/api/ngxdata/offers`](https://koboterminal.com/docs/api/offers) | yes | yes | yes | yes | | [`/api/ngxdata/bonds`](https://koboterminal.com/docs/api/bonds) | yes | yes | yes | yes | | [`/api/ngxdata/bonds/auctions`](https://koboterminal.com/docs/api/bond-auctions) | yes | yes | yes | yes | | [`/api/whale-flow`](https://koboterminal.com/docs/api/whale-flow) | yes | yes | yes | yes | | [`/api/whale-flow/{symbol}`](https://koboterminal.com/docs/api/whale-flow-symbol) | yes | yes | yes | yes | | [`/api/nasddata/stocks`](https://koboterminal.com/docs/api/nasd-stocks) | · | yes | yes | yes | | [`/api/nasddata/history/{symbol}`](https://koboterminal.com/docs/api/nasd-history) | · | · | yes | yes | | [`/api/forex/rates`](https://koboterminal.com/docs/api/forex) | · | · | yes | yes | | [`/api/news`](https://koboterminal.com/docs/api/news) | · | yes | yes | yes | | [`/api/keys/info`](https://koboterminal.com/docs/api/key-info) | yes | yes | yes | yes | ## Limits - **Daily limit** resets at midnight West Africa Time (WAT, UTC+1). - When you hit it you get `429` with `reset_at` and the next plan in the body. We also email you, at most once every 30 days. - Need more than 50,000 requests a day, redistribution rights or a dedicated feed? Email **hello@koboterminal.com**. --- # Rate limits and errors > Errors are JSON with an `error` message, and upgrade or reset hints where relevant. ## Error codes | Status | Error | What to do | |---|---|---| | 401 | API key required | No key sent. Pass X-API-Key or ?api_key=. Get a free key instantly at https://koboterminal.com/api#get-key | | 401 | Invalid API key | The key does not exist. Check for typos or copy it again from your email. | | 403 | API key is not active / has expired | The key was revoked, expired, or a paid period ended. Renew at https://koboterminal.com/api | | 403 | Plan upgrade required | The endpoint needs a higher plan. The body includes current_plan, required plan and upgrade_url. | | 429 | Daily limit exceeded | You used today's allowance. Resets at midnight WAT (reset_at in the body). The body names the next plan. | | 400 | Bad request | A parameter is malformed, e.g. a date not in YYYY-MM-DD. | | 404 | Not found | Unknown symbol, index or ETF. | | 5xx | Upstream or server error | Retry with backoff. Data is cached, so retries are cheap. | ### Example: daily limit reached ```json { "error": "Daily limit exceeded", "limit": 100, "message": "You've used all 100 requests on the Free plan today...", "current_plan": "Free", "upgrade_url": "https://koboterminal.com/api", "next_plan": "starter", "reset_at": "2026-11-18T23:00:00.000Z" } ``` ## Rate limits | Plan | Price (NGN) | Price (USD) | Requests / day | Requests / min | Best for | |---|---|---|---|---|---| | **Free** | Free | Free | 100 | 10 | Learning, prototypes, personal dashboards | | **Starter** | ₦29,000/mo | $20/mo | 1,000 | 20 | Solo builders and small apps | | **Professional** | ₦75,000/mo | $50/mo | 10,000 | 60 | Production apps, fintechs, client work | | **Institutional** | ₦350,000/mo | $200/mo | 50,000 | 120 | Brokers, asset managers, trading terminals | ## Good practice - **Cache.** Prices refresh every 20 minutes during market hours (10:00 to 14:30 WAT). Polling more often than that returns the same numbers. - **Check the clock.** Call `/api/ngxdata/market-status` and stop polling when `is_open` is false. - **Use the bulk endpoint.** One `/api/ngxdata/stocks` call returns every stock: cheaper than 150 single-stock calls. - **Read `stale_after`.** Market payloads tell you when to refresh. - **Back off on 5xx.** Retry after 2, 4, 8 seconds. --- # Data sources and freshness > We name every source. You should know exactly where your numbers come from. | Dataset | Source | Refresh | |---|---|---| | Equity prices, daily price list, market summary, ASI | Nigerian Exchange Group (NGX) official market data: the NGX daily price list and market snapshot published on ngxgroup.com and doclib.ngxgroup.com | Every 20 minutes during market hours (10:00 to 14:30 WAT), final close captured after 16:00 WAT | | Price history | NGX official closing prices, stored daily by Kobo Terminal since May 2000 | Daily after the close | | Indices (ASI, NGX30, NGX Banking and 18 more) | NGX index data (doclib.ngxgroup.com chartdata) | Every 30 minutes during market hours | | ETFs | NGX ETF statistics | Every 30 minutes during market hours | | Corporate disclosures | NGX corporate filings library (doclib.ngxgroup.com), mirrored and indexed | Within minutes of publication | | Director dealings (insider trades) | Parsed from NGX director-dealing filings | As filings are published | | Dividends | Company announcements and NGX corporate action notices | As declared | | FGN bonds, Eurobonds, Sukuk, corporate bonds | NGX bond listings and quoted prices | Daily | | Treasury bill auctions | Central Bank of Nigeria (CBN) auction results | After each auction | | Public offers, rights issues, IPOs | NGX Invest (invest.ngxgroup.com) | Every few days | | NASD OTC securities | NASD OTC Securities Exchange daily price list | Daily | | FX rates | Mid-market reference rates from ExchangeRate API (open.er-api.com), converted to an NGN base | Daily, cached hourly | | News | BusinessDay, Nairametrics, Premium Times, SEC Nigeria and other Nigerian business feeds | Every 15 minutes | ## Delay NGX equity prices are delayed (about 30 minutes) and refreshed every 20 minutes during market hours. Closing prices are final after the post-market capture at 16:00 WAT and are written to history the same evening. ## Freshness fields Market payloads include `as_of` (when the data was fetched) and `stale_after` (when to refresh). During the session `stale_after` is the next refresh; after the close it is the next session open. ## Corrections If a price looks wrong, email **hello@koboterminal.com** with the symbol and date. We reconcile against the official NGX price list and correct history in place. --- # MCP server > A hosted Model Context Protocol server at `https://koboterminal.com/mcp`. Your AI assistant gets 24 NGX tools: live prices, history, fundamentals, dividends, disclosures, insider dealings, bonds, T-bills and more. Transport: **Streamable HTTP** (stateless, JSON responses). Auth: your Kobo API key. Calls count against your plan like normal API requests. ## Claude Code ```bash claude mcp add --transport http kobo-terminal https://koboterminal.com/mcp \ --header "X-API-Key: $KOBO_API_KEY" ``` ## Claude Desktop, Cursor, Windsurf and other clients Add this to your MCP config (`claude_desktop_config.json`, `.cursor/mcp.json`, etc.): ```json { "mcpServers": { "kobo-terminal": { "url": "https://koboterminal.com/mcp", "headers": { "X-API-Key": "kobo_your_key_here" } } } } ``` Clients that only support local (stdio) servers can bridge with `mcp-remote`: ```json { "mcpServers": { "kobo-terminal": { "command": "npx", "args": ["-y", "mcp-remote", "https://koboterminal.com/mcp", "--header", "X-API-Key:kobo_your_key_here"] } } } ``` ## Claude.ai, ChatGPT and other URL-only connectors Where you can only paste a URL, put the key in the query string: ``` https://koboterminal.com/mcp?api_key=kobo_your_key_here ``` ## Tools | Tool | What it does | Plan | |---|---|---| | `get_market_summary` | NGX All-Share Index level and daily change, market capitalisation, volume, value, deals and breadth (advancers, decliners, unchanged). | Free | | `get_market_status` | Is the NGX open right now? Weekend and Nigerian public-holiday aware. | Free | | `list_stocks` | 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. | Free | | `get_price_history` | Daily open, high, low, close and volume for one NGX stock, from May 2000 to today. | Free | | `list_indices` | 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. | Free | | `get_index` | One NGX index by code or slug. | Free | | `get_index_history` | Daily closing levels for any NGX index, including the full All-Share Index history. | Free | | `get_index_intraday` | Today's intraday points for an index (level, change, value and volume traded) plus the latest live reading. | Free | | `list_etfs` | Every NGX exchange-traded fund with ISIN, issuer, previous close, open/high/low, change, trades, volume and value. | Free | | `get_etf` | One ETF by symbol. Common aliases are resolved to the canonical NGX symbol. | Free | | `get_fundamentals` | 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. | Starter | | `lookup_identifiers` | 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. | Starter | | `get_disclosures` | NGX corporate filings: financial statements, board meeting notices, dividend declarations, director dealings, AGM notices and more, with links to the original PDFs. | Starter | | `get_insider_dealings` | 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. | Professional | | `get_dividend_history` | Every dividend a company has paid: amount per share, ex-dividend date, record (qualification) date and payment date. | Free | | `get_dividend_calendar` | Dividends across the whole market by ex-dividend date. Use `upcoming=true` for what is coming next. | Free | | `get_offers` | Open and recent NGX public offers, rights issues and IPOs with unit price, opening and closing dates and days remaining. | Free | | `get_bonds` | 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). | Free | | `get_tbill_auctions` | CBN Nigerian Treasury Bill auction results: tenor, amount offered, subscribed and allotted, subscription rate, stop rate and yields. | Free | | `get_block_trade_flow` | Net buying and selling in large trades (₦10 million and up) by stock over the last N days: where the big money is going. | Free | | `list_nasd_stocks` | 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). | Starter | | `get_fx_rates` | Naira exchange rates against USD, EUR, GBP, CAD, AUD, CNY, JPY, GHS, ZAR and AED. | Professional | | `get_market_news` | Latest Nigerian business and capital-market headlines from BusinessDay, Nairametrics, Premium Times, SEC Nigeria and more. | Starter | | `get_my_usage` | Your plan, requests used today, daily limit, per-minute limit and lifetime requests. | Free | ## Try it Ask your assistant things like: - "What is the NGX All-Share Index doing today?" - "Chart Zenith Bank's closing price since January 2024." - "Which NGX banks pay the highest dividend yield?" - "Show me director dealings at First HoldCo in the last 30 days." - "What did the 364-day T-bill clear at in the last CBN auction?" ## Without a key `tools/list` works without a key so clients can discover the tools. Tool calls without a key return a message with a link to get a free key instantly. --- # Agent skill > One file that teaches your coding agent when and how to use the Kobo Terminal NGX API: the right endpoint, the right plan, and the gotchas. The skill lives at [`https://koboterminal.com/docs/skill.md`](https://koboterminal.com/docs/skill.md). ## Claude Code ```bash mkdir -p ~/.claude/skills/kobo-ngx-api curl -s https://koboterminal.com/docs/skill.md -o ~/.claude/skills/kobo-ngx-api/SKILL.md ``` For one project only, use `.claude/skills/kobo-ngx-api/SKILL.md` in the repo instead. ## Cursor, Windsurf, Codex and others Save the file into your rules or instructions folder, for example: ```bash curl -s https://koboterminal.com/docs/skill.md -o .cursor/rules/kobo-ngx-api.md curl -s https://koboterminal.com/docs/skill.md -o AGENTS.kobo.md # then reference it from AGENTS.md ``` ## Set your key ```bash export KOBO_API_KEY="kobo_your_key_here" ``` Get one free at [https://koboterminal.com/api#get-key](https://koboterminal.com/api#get-key). ## One-prompt setup Paste this into your coding agent: ```text Read https://koboterminal.com/docs/skill.md and https://koboterminal.com/docs/llms.txt. Then find every place in this codebase that hardcodes Nigerian stock prices, scrapes ngxgroup.com, or could use live NGX data, and replace it with calls to the Kobo Terminal NGX API using the KOBO_API_KEY environment variable. Show me the plan before editing. ``` ## Prefer tools over code? Connect the [MCP server](https://koboterminal.com/docs/mcp) instead: your assistant calls the API directly, no code needed. --- # Market summary > NGX All-Share Index level and daily change, market capitalisation, volume, value, deals and breadth (advancers, decliners, unchanged). ```http GET https://koboterminal.com/api/ngxdata/market ``` **Plan:** Free and above (free key, no card). The 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. ## Request ```bash curl "https://koboterminal.com/api/ngxdata/market" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/market", 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/market", { 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, "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" } } ``` ## Fields | Field | Type | Description | |---|---|---| | `data.asi` | number | NGX All-Share Index level | | `data.pct_change` | number | ASI change today, percent | | `data.market_cap` | number | Total equity market capitalisation, NGN | | `data.volume / value / deals` | number | Shares traded, naira value traded and number of deals today | | `data.advancers / decliners / unchanged` | integer | Market breadth | | `data.as_of / stale_after` | ISO 8601 | When the numbers were fetched and when to treat them as stale | | `data.market_status` | string | open, closed or pre_market | ## Use it from an AI assistant This endpoint is available as the `get_market_summary` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Market status > Is the NGX open right now? Weekend and Nigerian public-holiday aware. ```http GET https://koboterminal.com/api/ngxdata/market-status ``` **Plan:** Free and above (free key, no card). Use 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). ## Request ```bash curl "https://koboterminal.com/api/ngxdata/market-status" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/market-status", 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/market-status", { 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, "data": { "status": "Closed", "raw_status": "AFTER_HOURS", "is_open": false, "holiday": null, "source": "mansaapi-calendar" } } ``` ## Fields | Field | Type | Description | |---|---|---| | `data.is_open` | boolean | True while the market is in session | | `data.status` | string | Open, Pre-Open, Closed, or "Closed — " | | `data.holiday` | string|null | Holiday name when closed for a holiday | ## Use it from an AI assistant This endpoint is available as the `get_market_status` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # All stocks (daily price list) > 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. ```http GET https://koboterminal.com/api/ngxdata/stocks ``` **Plan:** Free and above (free key, no card). The 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. ## Request ```bash curl "https://koboterminal.com/api/ngxdata/stocks" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/stocks", 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/stocks", { 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 { "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 } } ``` ## Fields | Field | Type | Description | |---|---|---| | `stocks[].symbol` | string | NGX ticker, e.g. DANGCEM, GTCO, ZENITHBANK, MTNN | | `stocks[].current_price` | number | Last price, NGN | | `stocks[].previous_close` | number | Official previous close, NGN | | `stocks[].change_percent` | number | Change today, percent | | `stocks[].pct_change_7d` | number|null | Change over the last 7 calendar days, percent | | `stocks[].open_price / high_price / low_price` | number|null | Official daily price list fields | | `stocks[].volume / value / trades` | number | Shares traded, naira value and number of trades today | | `stocks[].market_cap` | number|null | Price x shares outstanding, NGN | | `stocks[].sector` | string | NGX sector | | `market` | object | Same block as /api/ngxdata/market | ## Use it from an AI assistant This endpoint is available as the `list_stocks` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Price history (OHLCV) > Daily open, high, low, close and volume for one NGX stock, from May 2000 to today. ```http GET https://koboterminal.com/api/ngxdata/prices/{symbol} ``` **Plan:** Free and above (free key, no card). Free keys get the last 7 days. Starter and above get the full daily history back to May 2000. Daily 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. ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | path | string | yes | NGX ticker (e.g. `DANGCEM`) | | `days` | query | integer | no | Most recent N trading days (e.g. `30`) | | `from` | query | string | no | Start date, YYYY-MM-DD (e.g. `2020-01-01`) | | `to` | query | string | no | End date, YYYY-MM-DD (e.g. `2026-11-18`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/prices/GTCO?days=2" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/prices/GTCO", params={"days": "2"}, 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/prices/GTCO?days=2", { 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, "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 } ``` ## Fields | Field | Type | Description | |---|---|---| | `prices[].trade_date` | string | Session date, YYYY-MM-DD | | `prices[].open_price / high_price / low_price / close_price` | number | NGN | | `prices[].volume` | integer | Shares traded | | `count` | integer | Number of rows returned | ## Use it from an AI assistant This endpoint is available as the `get_price_history` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # All NGX indices > 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. ```http GET https://koboterminal.com/api/ngxdata/indices ``` **Plan:** Free and above (free key, no card). ## Request ```bash curl "https://koboterminal.com/api/ngxdata/indices" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/indices", 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/indices", { 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": "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 } ] } ``` ## Fields | Field | Type | Description | |---|---|---| | `data[].code` | string | Index code, e.g. ASI, NGX30, NGXBNK, NGXPENSION | | `data[].currentPrice` | number | Index level | | `data[].changePercentage` | number | Change today, percent | | `data[].weekChange / monthChange / yearChange / inceptionChange` | number|null | Percent change over each window | ## Use it from an AI assistant This endpoint is available as the `list_indices` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Single index > One NGX index by code or slug. ```http GET https://koboterminal.com/api/ngxdata/indices/{code} ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `code` | path | string | yes | Index code or slug, e.g. ASI, NGX30, ngx-bnk (e.g. `NGX30`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/indices/NGX30" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/indices/NGX30", 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/indices/NGX30", { 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, "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 } } ``` ## Use it from an AI assistant This endpoint is available as the `get_index` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Index history > Daily closing levels for any NGX index, including the full All-Share Index history. ```http GET https://koboterminal.com/api/ngxdata/indices/{code}/history ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `code` | path | string | yes | Index code or slug (e.g. `ASI`) | | `from` | query | string | no | Start date, YYYY-MM-DD (e.g. `2025-01-01`) | | `to` | query | string | no | End date, YYYY-MM-DD (e.g. `2026-11-18`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/indices/ASI/history?from=2026-11-01" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/indices/ASI/history", params={"from": "2026-11-01"}, 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/indices/ASI/history?from=2026-11-01", { 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, "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 } ] } ``` ## Use it from an AI assistant This endpoint is available as the `get_index_history` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Index intraday > Today's intraday points for an index (level, change, value and volume traded) plus the latest live reading. ```http GET https://koboterminal.com/api/ngxdata/indices/intraday/{code} ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `code` | path | string | yes | Index code (e.g. `ASI`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/indices/intraday/ASI" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/indices/intraday/ASI", 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/indices/intraday/ASI", { 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, "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 } ] } ``` ## Use it from an AI assistant This endpoint is available as the `get_index_intraday` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # All ETFs > Every NGX exchange-traded fund with ISIN, issuer, previous close, open/high/low, change, trades, volume and value. ```http GET https://koboterminal.com/api/ngxdata/etfs ``` **Plan:** Free and above (free key, no card). ## Request ```bash curl "https://koboterminal.com/api/ngxdata/etfs" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/etfs", 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/etfs", { 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": "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" } ] } ``` ## Use it from an AI assistant This endpoint is available as the `list_etfs` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Single ETF > One ETF by symbol. Common aliases are resolved to the canonical NGX symbol. ```http GET https://koboterminal.com/api/ngxdata/etfs/{symbol} ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | path | string | yes | ETF symbol or alias (e.g. `STANBICETF30`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/etfs/STANBICETF30" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/etfs/STANBICETF30", 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/etfs/STANBICETF30", { 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, "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" } } ``` ## Use it from an AI assistant This endpoint is available as the `get_etf` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Resolve ETF symbol > Map an ETF alias to its canonical NGX symbol, slug and name. ```http GET https://koboterminal.com/api/ngxdata/etfs/resolve/{symbol} ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | path | string | yes | ETF symbol or alias (e.g. `SIAMLETF40`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/etfs/resolve/SIAMLETF40" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/etfs/resolve/SIAMLETF40", 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/etfs/resolve/SIAMLETF40", { 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, "input": "SIAMLETF40", "canonical_symbol": "SIAMLETF40", "slug": "siamletf40", "name": "SIAML Pension ETF 40" } ``` ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Fundamentals (all stocks) > 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. ```http GET https://koboterminal.com/api/ngxdata/fundamentals ``` **Plan:** Starter and above (from ₦29,000 / $20 a month). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbols` | query | string | no | Comma-separated ticker filter (e.g. `GTCO,ZENITHBANK,MTNN`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/fundamentals?symbols=GTCO,ZENITHBANK" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/fundamentals", params={"symbols": "GTCO,ZENITHBANK"}, 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/fundamentals?symbols=GTCO,ZENITHBANK", { 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, "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 } } ] } ``` ## Fields | Field | Type | Description | |---|---|---| | `pe_ratio / forward_pe` | number | Trailing and forward price-to-earnings | | `eps` | number | Earnings per share, NGN | | `dividend_per_share / dividend_yield` | number | NGN and percent | | `roe / roa` | number | Return on equity and assets, percent | | `pb_ratio / debt_equity` | number | Price-to-book and debt-to-equity | | `extra` | object | Extended metrics: EV/EBITDA, PEG, F-score, Z-score, RSI, SMA 50/200, analyst consensus, price target, payout ratio | ## Use it from an AI assistant This endpoint is available as the `get_fundamentals` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Fundamentals (one stock) > The fundamentals record for a single stock. ```http GET https://koboterminal.com/api/ngxdata/fundamentals/{symbol} ``` **Plan:** Starter and above (from ₦29,000 / $20 a month). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | path | string | yes | NGX ticker (e.g. `PRESCO`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/fundamentals/PRESCO" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/fundamentals/PRESCO", 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/fundamentals/PRESCO", { 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, "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 } } } ``` ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # ISIN and FIGI security master > 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. ```http GET https://koboterminal.com/api/ngxdata/identifiers ``` **Plan:** Starter and above (from ₦29,000 / $20 a month). Identifiers 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. ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `isin` | query | string | no | Resolve an ISIN to its security (e.g. `NGDANGCEM008`) | | `figi` | query | string | no | Resolve a FIGI to its security | | `identified_only` | query | boolean | no | Only securities with at least one identifier | | `limit` | query | integer | no | Rows per page, default 200, max 500 | | `offset` | query | integer | no | Pagination offset | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/identifiers?isin=NGDANGCEM008" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/identifiers", params={"isin": "NGDANGCEM008"}, 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/identifiers?isin=NGDANGCEM008", { 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, "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" } ] } ``` ## Use it from an AI assistant This endpoint is available as the `lookup_identifiers` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Identifiers (one stock) > ISIN and FIGI for a single ticker. ```http GET https://koboterminal.com/api/ngxdata/identifiers/{symbol} ``` **Plan:** Starter and above (from ₦29,000 / $20 a month). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | path | string | yes | NGX ticker (e.g. `DANGCEM`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/identifiers/DANGCEM" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/identifiers/DANGCEM", 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/identifiers/DANGCEM", { 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, "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" } } ``` ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Corporate disclosures > NGX corporate filings: financial statements, board meeting notices, dividend declarations, director dealings, AGM notices and more, with links to the original PDFs. ```http GET https://koboterminal.com/api/ngxdata/disclosures ``` **Plan:** Starter and above (from ₦29,000 / $20 a month). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | query | string | no | Filter by ticker (e.g. `MTNN`) | | `company` | query | string | no | Filter by company name | | `type` | query | string | no | Filter by submission type, e.g. Financial Statements | | `limit` | query | integer | no | Number of filings, or "all" (e.g. `20`) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/disclosures?symbol=MTNN&limit=20" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/disclosures", params={"symbol": "MTNN", "limit": "20"}, 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/disclosures?symbol=MTNN&limit=20", { 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, "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 } ``` ## Use it from an AI assistant This endpoint is available as the `get_disclosures` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Director dealings (insider trades) > 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. ```http GET https://koboterminal.com/api/ngxdata/insider-signal ``` **Plan:** Professional and above (from ₦75,000 / $50 a month). Professional and above get the full feed. Lower tiers receive a limited preview. ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | query | string | no | Filter by ticker (e.g. `FIRSTHOLDCO`) | | `side` | query | string | no | buy or sell | | `days` | query | integer | no | Only filings from the last N days (e.g. `30`) | | `limit` | query | integer | no | Max rows, default 100, max 500 | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/insider-signal?days=30" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/insider-signal", params={"days": "30"}, 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/insider-signal?days=30", { 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, "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 } ] } } ``` ## Use it from an AI assistant This endpoint is available as the `get_insider_dealings` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Dividend history > Every dividend a company has paid: amount per share, ex-dividend date, record (qualification) date and payment date. ```http GET https://koboterminal.com/api/ngxdata/dividends/{symbol} ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | path | string | yes | NGX ticker (e.g. `GTCO`) | | `limit` | query | integer | no | Number of payments, or "all" (default) | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/dividends/GTCO" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/dividends/GTCO", 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/dividends/GTCO", { 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, "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" } ] } ``` ## Use it from an AI assistant This endpoint is available as the `get_dividend_history` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Dividend calendar > Dividends across the whole market by ex-dividend date. Use `upcoming=true` for what is coming next. ```http GET https://koboterminal.com/api/ngxdata/dividends-calendar ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `upcoming` | query | boolean | no | Only ex-dates from today forward, soonest first (e.g. `true`) | | `from` | query | string | no | Earliest ex-date, YYYY-MM-DD (default 90 days ago) | | `to` | query | string | no | Latest ex-date, YYYY-MM-DD | | `symbol` | query | string | no | Filter by ticker | | `limit` | query | integer | no | Default 200, max 500 | ## Request ```bash curl "https://koboterminal.com/api/ngxdata/dividends-calendar?upcoming=true" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/dividends-calendar", params={"upcoming": "true"}, 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/dividends-calendar?upcoming=true", { 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 Illustrative example (values are examples, field names are exact): ```json { "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" } ] } ``` ## Use it from an AI assistant This endpoint is available as the `get_dividend_calendar` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Public offers, rights issues and IPOs > Open and recent NGX public offers, rights issues and IPOs with unit price, opening and closing dates and days remaining. ```http GET https://koboterminal.com/api/ngxdata/offers ``` **Plan:** Free and above (free key, no card). ## Request ```bash curl "https://koboterminal.com/api/ngxdata/offers" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/offers", 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/offers", { 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 Illustrative example (values are examples, field names are exact): ```json { "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" } ] } ``` ## Use it from an AI assistant This endpoint is available as the `get_offers` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Bonds > 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). ```http GET https://koboterminal.com/api/ngxdata/bonds ``` **Plan:** Free and above (free key, no card). ## Request ```bash curl "https://koboterminal.com/api/ngxdata/bonds" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/ngxdata/bonds", 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", { 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": "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 } ] } ``` ## Use it from an AI assistant This endpoint is available as the `get_bonds` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # 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 | Name | In | Type | Required | Description | |---|---|---|---|---| | `limit` | query | integer | no | Number 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](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Block-trade flow (market) > Net buying and selling in large trades (₦10 million and up) by stock over the last N days: where the big money is going. ```http GET https://koboterminal.com/api/whale-flow ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `days` | query | integer | no | Window in days, 1 to 90 (default 30) (e.g. `30`) | ## Request ```bash curl "https://koboterminal.com/api/whale-flow?days=30" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/whale-flow", params={"days": "30"}, 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/whale-flow?days=30", { 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, "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" } ] } ``` ## Use it from an AI assistant This endpoint is available as the `get_block_trade_flow` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Block-trade flow (one stock) > Daily net block-trade flow and the 20 most recent large trades for one stock. ```http GET https://koboterminal.com/api/whale-flow/{symbol} ``` **Plan:** Free and above (free key, no card). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | path | string | yes | NGX ticker (e.g. `GTCO`) | | `days` | query | integer | no | Window in days, 1 to 90 (default 30) | ## Request ```bash curl "https://koboterminal.com/api/whale-flow/GTCO?days=30" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/whale-flow/GTCO", params={"days": "30"}, 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/whale-flow/GTCO?days=30", { 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, "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" } ] } ``` ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # NASD OTC stocks > 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). ```http GET https://koboterminal.com/api/nasddata/stocks ``` **Plan:** Starter and above (from ₦29,000 / $20 a month). ## Request ```bash curl "https://koboterminal.com/api/nasddata/stocks" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/nasddata/stocks", 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/nasddata/stocks", { 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 { "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" } ``` ## Use it from an AI assistant This endpoint is available as the `list_nasd_stocks` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # NASD OTC price history > Daily closing price, change and market capitalisation for one NASD OTC security, oldest first. ```http GET https://koboterminal.com/api/nasddata/history/{symbol} ``` **Plan:** Professional and above (from ₦75,000 / $50 a month). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbol` | path | string | yes | NASD symbol (with or without the SD prefix) (e.g. `NASDPLC`) | | `days` | query | integer | no | Number of days, default 90 | ## Request ```bash curl "https://koboterminal.com/api/nasddata/history/NASDPLC?days=30" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/nasddata/history/NASDPLC", params={"days": "30"}, 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/nasddata/history/NASDPLC?days=30", { 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 { "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" } ``` ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # FX rates (NGN) > Naira exchange rates against USD, EUR, GBP, CAD, AUD, CNY, JPY, GHS, ZAR and AED. ```http GET https://koboterminal.com/api/forex/rates ``` **Plan:** Professional and above (from ₦75,000 / $50 a month). ## Parameters | Name | In | Type | Required | Description | |---|---|---|---|---| | `symbols` | query | string | no | Comma-separated currency codes (e.g. `USD,GBP,EUR`) | ## Request ```bash curl "https://koboterminal.com/api/forex/rates?symbols=USD,GBP,EUR" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/forex/rates", params={"symbols": "USD,GBP,EUR"}, 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/forex/rates?symbols=USD,GBP,EUR", { 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": "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 } } } ``` ## Use it from an AI assistant This endpoint is available as the `get_fx_rates` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Market news > Latest Nigerian business and capital-market headlines from BusinessDay, Nairametrics, Premium Times, SEC Nigeria and more. ```http GET https://koboterminal.com/api/news ``` **Plan:** Starter and above (from ₦29,000 / $20 a month). ## Request ```bash curl "https://koboterminal.com/api/news" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/news", 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/news", { 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, "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": "… 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" } ``` ## Use it from an AI assistant This endpoint is available as the `get_market_news` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors). --- # Key info and usage > Your plan, requests used today, daily limit, per-minute limit and lifetime requests. ```http GET https://koboterminal.com/api/keys/info ``` **Plan:** Free and above (free key, no card). ## Request ```bash curl "https://koboterminal.com/api/keys/info" \ -H "X-API-Key: $KOBO_API_KEY" ``` ```python import os, requests r = requests.get( "https://koboterminal.com/api/keys/info", 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/keys/info", { 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 Illustrative example (values are examples, field names are exact): ```json { "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" } ``` ## Use it from an AI assistant This endpoint is available as the `get_my_usage` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp). ## Errors Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors).