> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NGN Market API Documentation

> Access real-time and historical NGX market data through NGN Market REST API.

Welcome to the NGN Market API where you can retrieve NGX equity prices, the All Share Index, company financial statements, dividend history and calendars, forex rates, market indices, ETFs and ETPs, bond listings, and financial news from a single REST API that returns consistent, structured JSON.

## Data freshness

| Data type                                                   | Update frequency                          |
| :---------------------------------------------------------- | :---------------------------------------- |
| Equity prices (stocks, market snapshot, movers, top trades) | Every 20 minutes during NGX trading hours |
| ETF and ETP prices                                          | Every 20 minutes during NGX trading hours |
| NGX trading hours                                           | Monday–Friday, 09:00–16:00 WAT            |
| Forex rates                                                 | Daily                                     |
| Dividend data                                               | As declared                               |
| Disclosures & filings                                       | Twice daily                               |
| Historical price charts                                     | End-of-day                                |

Outside trading hours, equity price endpoints return the most recent session close. The `last_updated` field on each price response shows the exact timestamp of the last refresh.

## Get started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get your API key and make your first request in under 5 minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to attach your API key to every request.
  </Card>

  <Card title="Plans & Limits" icon="credit-card" href="/plans">
    Compare Free, Starter, Growth, and Business plan quotas and endpoint access.
  </Card>

  <Card title="Response Format" icon="brackets-curly" href="/response-format">
    Understand the standard JSON envelope and the `meta` quota object.
  </Card>
</CardGroup>

## Explore the API

<CardGroup cols={3}>
  <Card title="Market" icon="chart-line" href="/api-reference/market/snapshot">
    Live intraday snapshots, top trades, movers, breadth, sectors, and YTD performers.
  </Card>

  <Card title="Companies" icon="building" href="/api-reference/companies/list">
    Live intraday prices, profiles, historical price charts, financials, news, and disclosures.
  </Card>

  <Card title="Forex" icon="money-bill-wave" href="/api-reference/forex/current">
    Live and historical NGN exchange rates against major currencies.
  </Card>

  <Card title="Indices" icon="chart-bar" href="/api-reference/indices/list">
    All NGX market indices with constituents and historical chart data.
  </Card>

  <Card title="ETFs" icon="chart-mixed" href="/api-reference/etfs/list">
    All NGX-listed ETFs and ETPs with live prices, fund profiles, and historical chart data.
  </Card>

  <Card title="Bonds" icon="file-invoice" href="/api-reference/bonds/list">
    NGX-listed government and corporate bond instruments.
  </Card>

  <Card title="Disclosures" icon="file-lines" href="/api-reference/disclosures/list">
    Official corporate filings: financials, AGM notices, earnings forecasts, and more.
  </Card>

  <Card title="Dividends" icon="coins" href="/api-reference/dividends/upcoming">
    Full dividend history, upcoming ex-dates, and recent payouts across all NGX companies.
  </Card>

  <Card title="Blog" icon="newspaper" href="/api-reference/blog/posts">
    Financial news and analysis on NGX companies — paginated, filterable, and AI-searchable.
  </Card>
</CardGroup>