Skip to main content
GET
/
v1
/
market
/
breadth
Trading date activity and breadth
curl --request GET \
  --url https://api.ngnmarket.com/v1/market/breadth \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "count": 3,
    "latest": "2026-04-17",
    "earliest": "2026-04-15",
    "data": [
      {
        "date": "2026-04-17",
        "label": "latest",
        "gainers_count": 48,
        "losers_count": 22,
        "unchanged_count": 14,
        "total_records": 84,
        "formatted_date": "Fri, Apr 17, 2026"
      },
      {
        "date": "2026-04-16",
        "label": "previous",
        "gainers_count": 31,
        "losers_count": 39,
        "unchanged_count": 12,
        "total_records": 82,
        "formatted_date": "Thu, Apr 16, 2026"
      },
      {
        "date": "2026-04-15",
        "label": null,
        "gainers_count": 55,
        "losers_count": 14,
        "unchanged_count": 14,
        "total_records": 83,
        "formatted_date": "Wed, Apr 15, 2026"
      }
    ]
  },
  "meta": {
    "plan": "growth",
    "calls_used": 215,
    "calls_remaining": 499785,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

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.

The breadth endpoint returns a list of NGX trading sessions enriched with market breadth data: the total number of securities that traded, how many advanced, how many declined, and how many closed unchanged on each day. Use from and to to query a specific date range, or limit to get the most recent N sessions. Use this endpoint to identify historically active sessions, power a calendar view of market activity, or filter date ranges before querying snapshot or movers data. This endpoint requires a Growth plan or higher.

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Query Parameters

​
from
string<date>

Start date in YYYY-MM-DD format (inclusive). Use with to for a specific range; overrides limit.

Example:

"2026-01-01"

​
to
string<date>

End date in YYYY-MM-DD format (inclusive). Use with from.

Example:

"2026-04-17"

​
limit
integer
default:90

Maximum number of dates to return (1–365). Dates are returned newest-first. Ignored when from/to are both set.

Required range: 1 <= x <= 365

Response

Trending dates retrieved successfully.

​
success
boolean
required
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object