# NGN Market API

> Access real-time and historical NGX market data including equities, forex rates, company profiles, indices, bonds, and financial news.

## Docs

- [AGENTS](https://docs.ngnmarket.com/AGENTS.md)
- [Paginated request log history](https://docs.ngnmarket.com/account/paginated-request-log-history.md): Returns a paginated, reverse-chronological list of authenticated API requests made by the user over the last 30 days. Filter by status class or endpoint path using query parameters.
- [Quota status and 30-day analytics](https://docs.ngnmarket.com/account/quota-status-and-30-day-analytics.md): Returns the authenticated user's current quota status and a 30-day analytics summary.
- [Agent Quickstart](https://docs.ngnmarket.com/agent-quickstart.md): Paste one prompt into your coding agent to find where NGX market data would replace hardcoded values, scrapers, or manual calculations in your codebase.
- [Account Logs](https://docs.ngnmarket.com/api-reference/account/logs.md): Paginated request log history for your API key.
- [Account Usage](https://docs.ngnmarket.com/api-reference/account/usage.md): Retrieve your current quota status and 30-day analytics.
- [Get Blog Post](https://docs.ngnmarket.com/api-reference/blog/post-detail.md): Retrieve the full detail record for a single post: rich author profile, named taxonomies, and a content preview.
- [List Blog Posts](https://docs.ngnmarket.com/api-reference/blog/posts.md): Paginated, filterable feed of all published NGN Market blog posts.
- [Search Blog Posts](https://docs.ngnmarket.com/api-reference/blog/search.md): Full-text search across all published posts with AI query expansion and relevance scoring.
- [List Bonds](https://docs.ngnmarket.com/api-reference/bonds/list.md): Retrieve a paginated list of NGX-listed bonds.
- [Price Chart](https://docs.ngnmarket.com/api-reference/companies/chart.md): Retrieve historical price series for an NGX-listed company.
- [Company Profile](https://docs.ngnmarket.com/api-reference/companies/detail.md): Retrieve the full profile for an NGX-listed company.
- [Company Disclosures](https://docs.ngnmarket.com/api-reference/companies/disclosures.md): Corporate filings scoped to a specific NGX-listed company.
- [Dividend History](https://docs.ngnmarket.com/api-reference/companies/dividends.md): Retrieve the full dividend history for an NGX-listed company.
- [Financial Statements](https://docs.ngnmarket.com/api-reference/companies/financials.md): Retrieve income statements, balance sheets, cash flow, and ratios.
- [Ticker Symbols](https://docs.ngnmarket.com/api-reference/companies/identifiers.md): Retrieve all NGX ticker symbols, names, and ISIN identifiers.
- [List Companies](https://docs.ngnmarket.com/api-reference/companies/list.md): Retrieve a paginated, filterable list of all NGX-listed companies.
- [Company News](https://docs.ngnmarket.com/api-reference/companies/news.md): Retrieve recent news articles for an NGX-listed company by ticker symbol.
- [List Disclosures](https://docs.ngnmarket.com/api-reference/disclosures/list.md): Paginated feed of official corporate filings from NGX-listed companies.
- [Disclosure Types](https://docs.ngnmarket.com/api-reference/disclosures/types.md): All submission types in the database with document counts.
- [Recent Dividends](https://docs.ngnmarket.com/api-reference/dividends/recent.md): Browse NGX-listed companies whose ex-dividend date fell within the last 60 days.
- [Upcoming Dividends](https://docs.ngnmarket.com/api-reference/dividends/upcoming.md): Browse NGX-listed companies with upcoming ex-dividend dates.
- [ETF Chart](https://docs.ngnmarket.com/api-reference/etfs/chart.md): Retrieve historical daily price data for any NGX-listed ETF or ETP.
- [ETF Detail](https://docs.ngnmarket.com/api-reference/etfs/detail.md): Retrieve full details for a single NGX-listed ETF or ETP.
- [List ETFs](https://docs.ngnmarket.com/api-reference/etfs/list.md): Retrieve all NGX-listed Exchange Traded Funds and ETPs with current prices and period performance.
- [Current Forex Rates](https://docs.ngnmarket.com/api-reference/forex/current.md): Retrieve the latest NGN exchange rates against all supported currencies.
- [Historical Forex Rates](https://docs.ngnmarket.com/api-reference/forex/history.md): Retrieve historical NGN exchange rates by currency pair and date range.
- [Index Chart](https://docs.ngnmarket.com/api-reference/indices/chart.md): Retrieve historical daily closing values for any NGX market index.
- [Index Detail](https://docs.ngnmarket.com/api-reference/indices/detail.md): Retrieve the full detail for a single NGX market index.
- [List Indices](https://docs.ngnmarket.com/api-reference/indices/list.md): Retrieve all NGX market indices with current values and daily change.
- [API Reference](https://docs.ngnmarket.com/api-reference/introduction.md): All NGN Market API endpoints.
- [Available Dates](https://docs.ngnmarket.com/api-reference/market/available-dates.md): List dates for which NGX market data is available.
- [Market Breadth](https://docs.ngnmarket.com/api-reference/market/breadth.md): List NGX trading dates with market breadth data.
- [Market Holidays](https://docs.ngnmarket.com/api-reference/market/holidays.md): List NGX public holidays when the exchange is closed.
- [Market Movers](https://docs.ngnmarket.com/api-reference/market/movers.md): Retrieve the top gaining and losing NGX stocks for any trading date.
- [Sectors](https://docs.ngnmarket.com/api-reference/market/sectors.md): Retrieve sector-level performance.
- [Market Snapshot](https://docs.ngnmarket.com/api-reference/market/snapshot.md): Retrieve the daily NGX market summary.
- [Market Status](https://docs.ngnmarket.com/api-reference/market/status.md): Check whether the NGX is currently open or closed.
- [Top Trades](https://docs.ngnmarket.com/api-reference/market/top-trades.md): Retrieve the most actively traded NGX stocks.
- [YTD Performers](https://docs.ngnmarket.com/api-reference/market/ytd-performers.md): Retrieve the best or worst performing NGX stocks year-to-date, with start price, current price, and percentage return.
- [Authentication](https://docs.ngnmarket.com/authentication.md): Learn how to generate an API key on NGN Market.
- [AI-powered blog post search](https://docs.ngnmarket.com/blog/ai-powered-blog-post-search.md): Full-text search across all published blog posts with AI-powered query expansion via Google Gemini. A search for `Dangote` also matches posts referencing `DANGCEM`. Falls back to plain keyword matching if AI is unavailable. Results are ordered by relevance score.
- [Blog post detail](https://docs.ngnmarket.com/blog/blog-post-detail.md): Returns the full detail record for a single post: rich author profile, named taxonomy objects (categories, tags, and companies each with a display name and slug), and a `content.html` preview (the article's "Key Highlights" section if present, or the first 500 characters of plain text as a fallback)…
- [Paginated blog post list](https://docs.ngnmarket.com/blog/paginated-blog-post-list.md): Returns a paginated list of published NGN Market blog posts sorted by publication date (newest first). Each page contains up to 20 posts.
- [NGX-listed bond instruments](https://docs.ngnmarket.com/bonds/ngx-listed-bond-instruments.md): Returns a paginated list of bonds listed on the Nigerian Exchange with ISIN, issuer, type, coupon rate, maturity date, and opening price. Filter by search term or bond type.
- [Changelog](https://docs.ngnmarket.com/changelog.md): API additions, endpoint improvements, and schema changes.
- [All NGX ticker symbols](https://docs.ngnmarket.com/companies/all-ngx-ticker-symbols.md): Returns every company listed on the NGX in a single lightweight response with no pagination. Each entry includes the ticker symbol, company name, and international securities identifier (ISIN). Ideal for populating dropdowns or building lookup tables.
- [Browse NGX-listed companies](https://docs.ngnmarket.com/companies/browse-ngx-listed-companies.md): Returns a paginated, filterable list of all NGX-listed companies with current price data. Filter by sector, search by name or ticker, sort by market cap, price, or other fields, and apply market-cap range filters.
- [Company news by ticker symbol](https://docs.ngnmarket.com/companies/company-news-by-ticker-symbol.md): Returns recent news articles for a specific company identified by its NGX ticker symbol. Articles are sourced in real time from Nigerian financial outlets. Older articles are excluded based on the `maxAge` parameter.
- [Disclosures by company](https://docs.ngnmarket.com/companies/disclosures-by-company.md): Returns corporate disclosures for a specific NGX-listed company. Equivalent to `GET /disclosures?symbol={symbol}` but scoped to a single company.
- [Financial statements](https://docs.ngnmarket.com/companies/financial-statements.md): Returns the complete set of financial statements filed by a company (income statement, balance sheet, cash flow statement, and computed financial ratios) for every reporting period available. Results are ordered from most recent to oldest.
- [Full company profile](https://docs.ngnmarket.com/companies/full-company-profile.md): Returns everything you need to build a comprehensive company page: current price data, 52-week range, market cap, trailing EPS, sector and sub-sector classification, contact details, and a business description. The ticker symbol lookup is case-insensitive.
- [Historical price series](https://docs.ngnmarket.com/companies/historical-price-series.md): Returns the complete OHLCV (open, high, low, close, volume) history for a company sourced from daily exchange data. Each data point includes a Unix timestamp, calendar date, and full OHLCV fields plus VWAP, trade count, and daily change. Use `format=chart` for compact `[timestamp, close]` pairs or `…
- [Corporate disclosures feed](https://docs.ngnmarket.com/disclosures/corporate-disclosures-feed.md): Paginated feed of official corporate filings from NGX-listed companies, sorted newest first. Covers financial statements, AGM notices, board meetings, director dealings, earnings forecasts, and more.
- [Disclosure submission types](https://docs.ngnmarket.com/disclosures/disclosure-submission-types.md): Returns all submission types present in the database with their document counts. Use the `type` values as the `type` filter on `GET /disclosures`.
- [Errors](https://docs.ngnmarket.com/errors.md): All NGN Market API error codes & their HTTP status, and how to fix them.
- [Plot the All Share Index](https://docs.ngnmarket.com/examples/asi-chart.md): Fetch NGX All Share Index history and render it as a price chart.
- [Get a Company Profile and Price Chart](https://docs.ngnmarket.com/examples/company-profile.md): Look up a company's full profile, current price, and 30-day price history in two requests.
- [Get Forex Rates](https://docs.ngnmarket.com/examples/forex-rates.md): Fetch the current USD/NGN rate and 30-day exchange rate history.
- [Get a Sector Performance Snapshot](https://docs.ngnmarket.com/examples/sector-snapshot.md): Fetch NGX sector-level performance data to identify which parts of the market are moving.
- [Get Today's Top Movers](https://docs.ngnmarket.com/examples/top-movers.md): Fetch the biggest gainers and losers on the NGX for the latest trading session.
- [Year-to-Date Best and Worst Performers](https://docs.ngnmarket.com/examples/ytd-performers.md): Find the NGX stocks that have gained or lost the most since the start of the year.
- [Historical NGN forex rates](https://docs.ngnmarket.com/forex/historical-ngn-forex-rates.md): Returns historical exchange rate data between NGN and any supported currency pair. Narrow results by currency code, date range, and record count.
- [Live NGN exchange rates](https://docs.ngnmarket.com/forex/live-ngn-exchange-rates.md): Returns the most recent NGN exchange rates for all supported currencies. Each rate expresses how much of the foreign currency one Nigerian Naira buys (e.g. a USD rate of `0.000623` means ₦1 = $0.000623).
- [Build a Candlestick Chart](https://docs.ngnmarket.com/guides/candlestick-chart.md): Fetch OHLCV data from the NGN Market API and render a professional candlestick chart.
- [Company Logos](https://docs.ngnmarket.com/guides/company-logos.md): Render NGX company logos in your app, and go beyond the default PNG when you need to.
- [Build a Currency Converter](https://docs.ngnmarket.com/guides/currency-converter.md): Use live NGN exchange rates to build a bidirectional NGN currency calculator.
- [Display a Live Price Ticker](https://docs.ngnmarket.com/guides/live-price-ticker.md): Poll the NGN Market API on an interval to keep stock prices current in your UI.
- [Build a Portfolio Tracker](https://docs.ngnmarket.com/guides/portfolio-tracker.md): Combine live prices with your users' holdings to calculate real-time portfolio value and P&L.
- [Set Up Price Alerts](https://docs.ngnmarket.com/guides/price-alerts.md): Poll stock prices and trigger notifications when a target price or percentage move is hit.
- [Historical index values](https://docs.ngnmarket.com/indices/historical-index-values.md): Returns a time series of daily closing values for a specific NGX market index. Use `period` for a preset lookback window or `from`/`to` for a custom range. Returns a statistics block alongside the data array.
- [Index detail and constituents](https://docs.ngnmarket.com/indices/index-detail-and-constituents.md): Returns comprehensive information for a specific NGX market index including its description, current value, daily change, and the list of constituent securities with their weights.
- [List all NGX market indices](https://docs.ngnmarket.com/indices/list-all-ngx-market-indices.md): Returns a snapshot of every NGX market index with current value and daily percentage change. Use this to build market overview dashboards or discover available indices before querying detail or chart data.
- [Install the agent skill](https://docs.ngnmarket.com/install-skill.md): Install the NGN Market skill so your coding agent knows when and how to use the correct API endpoints.
- [NGN Market API Documentation](https://docs.ngnmarket.com/introduction.md): Access real-time and historical NGX market data through NGN Market REST API.
- [Daily NGX market summary](https://docs.ngnmarket.com/market/daily-ngx-market-summary.md): Returns the full daily market summary for a given trading date: ASI level and change, total deals, volume, naira value traded, and a market-capitalisation breakdown across equities, bonds, and ETFs. Omit the `date` parameter to receive the most recent available trading day.
- [Market data date index](https://docs.ngnmarket.com/market/market-data-date-index.md): Lists every trading date for which NGX market data exists, in reverse chronological order. Each entry includes the closing ASI value and a convenience label (`today`, `yesterday`, `latest`, `previous`) for recent dates. Useful for building date pickers or validating dates before querying other endpo…
- [Most traded NGX stocks](https://docs.ngnmarket.com/market/most-traded-ngx-stocks.md): Returns a ranked list of the most actively traded NGX securities by naira value for a given session. Each entry includes the stock symbol, company name, sector, share volume, naira value, current price, and price change percentage. Omit `date` to get the current or most recent session.
- [Sector-level performance breakdown](https://docs.ngnmarket.com/market/sector-level-performance-breakdown.md): Shows which parts of the NGX market are gaining traction and which are pulling back. For every sector, returns the average price change across 1-day, 7-day, and 52-week windows, aggregate market cap, value traded, total volume, and a breadth count of advancers, decliners, and unchanged stocks.
- [Top gainers and losers](https://docs.ngnmarket.com/market/top-gainers-and-losers.md): Returns the biggest movers on the NGX for a given trading session: top gainers by percentage gain and top losers by percentage decline. Each entry includes previous close, current price, absolute and percentage change, and trading activity.
- [Trading date activity and breadth](https://docs.ngnmarket.com/market/trading-date-activity-and-breadth.md): Returns a list of NGX trading sessions enriched with market breadth data: total securities traded, how many advanced, how many declined, and how many were unchanged per day. Useful for identifying active sessions, powering calendar views, or filtering date ranges before querying snapshot data.
- [Year-to-date stock returns](https://docs.ngnmarket.com/market/year-to-date-stock-returns.md): Ranks NGX-listed stocks by their year-to-date return, from the first available trading day of the year through the most recent session. Request the best performers, worst performers, or both. Historical years are supported via the `year` parameter.
- [API Plans, Pricing, and Endpoint Access](https://docs.ngnmarket.com/plans.md): Compare Free, Hobby, Starter, Growth, Business, and Enterprise plans.
- [Quickstart](https://docs.ngnmarket.com/quickstart.md): Get your API key and make your first NGN Market API request in under five minutes.
- [Rate Limits](https://docs.ngnmarket.com/rate-limits.md): How monthly call quotas work.
- [Response Format](https://docs.ngnmarket.com/response-format.md): Every API response follows a consistent JSON envelope.

## OpenAPI Specs

- [openapi](https://docs.ngnmarket.com/openapi.yaml)

## Optional

- [Dashboard](https://ngnmarket.com/dashboard)
- [Blog](https://ngnmarket.com/blog)