> ## 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.
# Market Status
> Check whether the NGX is currently open or closed.
The status endpoint tells you at a glance whether the Nigerian Exchange (NGX) is currently trading, and — if not — exactly why and when it will next open.
All times are computed in the **Africa/Lagos** timezone (WAT, UTC+1). The NGX trading session runs **Monday–Friday, 09:00–16:00 WAT**, excluding public holidays.
```bash curl theme={null}
curl "https://api.ngnmarket.com/v1/market/status" \
-H "Authorization: Bearer ngm_live_YOUR_KEY"
```
```javascript JavaScript theme={null}
const res = await fetch('https://api.ngnmarket.com/v1/market/status', {
headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' },
});
const { data } = await res.json();
console.log(data.is_open, data.reason);
```
```python Python theme={null}
import requests
res = requests.get(
'https://api.ngnmarket.com/v1/market/status',
headers={'Authorization': 'Bearer ngm_live_YOUR_KEY'},
)
data = res.json()['data']
print(data['is_open'], data['reason'])
```
### The `reason` field
| Value | Meaning |
| ------------- | --------------------------------------------------------------------------------------- |
| `open` | The market is currently trading. |
| `pre_market` | Today is a trading day but the 09:00 open has not yet occurred. |
| `after_hours` | Today was a trading day; the 16:00 close has passed. |
| `weekend` | Today is Saturday or Sunday. |
| `holiday` | Today is a public holiday. The `holiday` object will contain the holiday name and date. |
When `is_open` is `false`, the `next_open` object tells you the date, UTC timestamp, and human-readable label for the next opening. For holiday closures, the `holiday` object provides the name of the holiday.
## OpenAPI
````yaml GET /market/status
openapi: 3.1.0
info:
title: NGN Market API
version: '1.0'
description: >
The NGN Market API provides programmatic access to Nigerian Exchange Group
(NGX) market data, including equities, forex rates, company profiles,
indices, bonds, and financial news.
## Base URL
All endpoints are served from:
```
https://api.ngnmarket.com/v1
```
## Authentication
Every request requires a Bearer token in the `Authorization` header:
```
Authorization: Bearer ngm_live_YOUR_KEY
```
Generate and manage your API keys from the [developer
dashboard](https://ngnmarket.com/developer).
## Plans & Quotas
| Plan | Monthly Calls | Requests/min | Price |
| :--- | ---: | ---: | :--- |
| Free | 3,000 | 30 | Free |
| Hobby | 10,000 | 60 | ₦15,000/mo |
| Starter | 100,000 | 120 | ₦50,000/mo |
| Growth | 500,000 | 200 | ₦200,000/mo |
| Business | 2,000,000 | 300 | ₦700,000/mo |
| Enterprise | Unlimited | Unlimited | Custom |
Every response includes a `meta` object showing your current usage and
remaining quota. Exceeding the per-minute rate limit returns `429
RATE_LIMITED`. Exceeding the monthly quota returns `429 QUOTA_EXCEEDED`.
## Response Envelope
All responses use a consistent JSON envelope:
```json
{
"success": true,
"data": { ... },
"meta": {
"plan": "starter",
"calls_used": 4821,
"calls_remaining": 95179,
"reset_at": "2026-05-01T00:00:00.000Z"
}
}
```
contact:
name: NGN Market Support
email: support@ngnmarket.com
url: https://ngnmarket.com
license:
name: Proprietary
servers:
- url: https://api.ngnmarket.com/v1
description: Production
security:
- BearerAuth: []
tags:
- name: Market
description: >-
Daily market snapshots, top trades, movers, market breadth, sectors, and
YTD performers.
- name: Companies
description: >-
Browse, search, and retrieve profiles, price charts, and financial
statements for NGX-listed companies.
- name: Forex
description: Current and historical NGN exchange rates against major currencies.
- name: Indices
description: >-
All NGX market indices, including list, detail with constituents, and
historical chart data.
- name: ETFs
description: >-
NGX-listed Exchange Traded Funds and ETPs — list, full fund detail, and
historical daily price data.
- name: Bonds
description: >-
NGX-listed bond instruments with issuer details, coupon rates, and
maturity dates.
- name: Disclosures
description: >-
Official corporate filings from NGX-listed companies (financial
statements, AGM notices, board meetings, director dealings, earnings
forecasts). Sourced from NGX Group and updated twice daily.
- name: Blog
description: >-
Published NGN Market blog posts. List, search, and filter by category or
company.
- name: Dividends
description: >-
Market-wide NGX dividend calendar. Browse upcoming and recently paid
dividends across all listed companies with optional search and pagination.
- name: Account
description: >-
Quota status, 30-day request analytics, and paginated request logs for the
authenticated user.
paths:
/market/status:
get:
tags:
- Market
summary: NGX market open/close status
description: >
Returns the current open/close status of the Nigerian Exchange (NGX),
computed in the **Africa/Lagos** timezone (WAT, UTC+1).
The response includes the reason the market is closed (weekend, public
holiday, pre-market, or after-hours), the next scheduled open time, and
— when the market is open — the minutes remaining until close.
Public holidays are managed by the NGN Market admin team and reflected
here in real time.
**Plan required:** Free
operationId: getMarketStatus
responses:
'200':
description: Market status retrieved successfully.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/SuccessEnvelope'
- type: object
properties:
data:
type: object
properties:
is_open:
type: boolean
description: Whether the NGX is currently trading.
status:
type: string
enum:
- open
- closed
reason:
type: string
enum:
- open
- weekend
- holiday
- pre_market
- after_hours
description: Why the market is in its current state.
session:
type: object
properties:
open_time:
type: string
example: '09:00'
close_time:
type: string
example: '16:00'
timezone:
type: string
example: Africa/Lagos
holiday:
nullable: true
type: object
description: Present when today is a public holiday.
properties:
name:
type: string
date:
type: string
format: date
next_open:
nullable: true
type: object
description: >-
When the market next opens. Null when the market
is already open.
properties:
date:
type: string
format: date
datetime:
type: string
format: date-time
description: ISO 8601 UTC timestamp for 09:00 WAT.
label:
type: string
example: Tuesday, 13 May at 9:00 AM WAT
closes_in:
nullable: true
type: object
description: >-
Time remaining until close. Non-null only when
`is_open` is true.
properties:
hours:
type: integer
minutes:
type: integer
total_minutes:
type: integer
as_of:
type: string
format: date-time
description: UTC timestamp at which this response was computed.
examples:
marketOpen:
summary: Market is open
value:
success: true
data:
is_open: true
status: open
reason: open
session:
open_time: '09:00'
close_time: '16:00'
timezone: Africa/Lagos
holiday: null
next_open: null
closes_in:
hours: 3
minutes: 22
total_minutes: 202
as_of: '2026-05-13T11:38:00.000Z'
meta:
plan: free
calls_used: 1
calls_remaining: 9999
reset_at: '2026-06-01T00:00:00.000Z'
marketClosedHoliday:
summary: Market closed for a public holiday
value:
success: true
data:
is_open: false
status: closed
reason: holiday
session:
open_time: '09:00'
close_time: '16:00'
timezone: Africa/Lagos
holiday:
name: Workers Day
date: '2026-05-01'
next_open:
date: '2026-05-04'
datetime: '2026-05-04T08:00:00.000Z'
label: Monday, 4 May at 9:00 AM WAT
closes_in: null
as_of: '2026-05-01T10:15:00.000Z'
meta:
plan: free
calls_used: 1
calls_remaining: 9999
reset_at: '2026-06-01T00:00:00.000Z'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/QuotaExceeded'
'500':
$ref: '#/components/responses/ServerError'
components:
schemas:
SuccessEnvelope:
type: object
required:
- success
properties:
success:
type: boolean
const: true
meta:
$ref: '#/components/schemas/Meta'
Meta:
type: object
description: Quota and plan metadata included on every authenticated response.
properties:
plan:
type: string
description: Current plan name.
enum:
- free
- starter
- growth
- business
- enterprise
example: starter
calls_used:
type: integer
description: Total calls made this calendar month across all your keys.
example: 4821
calls_remaining:
type: integer
description: Calls remaining before your quota is exhausted.
example: 95179
reset_at:
type: string
format: date-time
description: ISO 8601 UTC timestamp of your next quota reset (1st of next month).
example: '2026-05-01T00:00:00.000Z'
ErrorEnvelope:
type: object
required:
- success
- error
properties:
success:
type: boolean
const: false
error:
type: object
required:
- code
- message
properties:
code:
type: string
description: Machine-readable error identifier.
example: NOT_FOUND
message:
type: string
description: Human-readable error description.
example: Resource not found.
required_plan:
type: string
description: _(PLAN_REQUIRED only)_ Minimum plan needed.
current_plan:
type: string
description: _(PLAN_REQUIRED only)_ Your current plan.
responses:
Unauthorized:
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
missingKey:
summary: Missing Authorization header
value:
success: false
error:
code: MISSING_API_KEY
message: 'Provide your API key via: Authorization: Bearer '
invalidKey:
summary: Invalid or revoked key
value:
success: false
error:
code: INVALID_API_KEY
message: API key not found or revoked.
QuotaExceeded:
description: Monthly call limit reached.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ErrorEnvelope'
- type: object
properties:
meta:
$ref: '#/components/schemas/Meta'
example:
success: false
error:
code: QUOTA_EXCEEDED
message: >-
Monthly call limit of 100,000 reached. Resets on
2026-05-01T00:00:00.000Z.
meta:
plan: starter
calls_used: 100000
calls_remaining: 0
reset_at: '2026-05-01T00:00:00.000Z'
ServerError:
description: Unexpected server-side failure. Safe to retry with backoff.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
example:
success: false
error:
code: SERVER_ERROR
message: Something went wrong on our end. Please try again.
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: ngm_live_*
description: >
Pass your API key as a Bearer token: `Authorization: Bearer
ngm_live_YOUR_KEY`.
Generate keys at
[ngnmarket.com/dashboard/developer](https://ngnmarket.com/developer).
````