> ## 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. # Trading date activity and breadth > 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. **Plan required:** Growth ## OpenAPI ````yaml get /market/breadth 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/breadth: get: tags: - Market summary: Trading date activity and breadth description: > 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. **Plan required:** Growth operationId: getMarketBreadth parameters: - name: from in: query description: >- Start date in `YYYY-MM-DD` format (inclusive). Use with `to` for a specific range; overrides `limit`. required: false schema: type: string format: date example: '2026-01-01' - name: to in: query description: End date in `YYYY-MM-DD` format (inclusive). Use with `from`. required: false schema: type: string format: date example: '2026-04-17' - name: limit in: query description: >- Maximum number of dates to return (1–365). Dates are returned newest-first. Ignored when `from`/`to` are both set. required: false schema: type: integer minimum: 1 maximum: 365 default: 90 responses: '200': description: Trending dates retrieved successfully. content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object properties: data: $ref: '#/components/schemas/TrendingDates' examples: recentDates: summary: Recent trading dates with breadth data value: 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' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/PlanRequired' '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' TrendingDates: type: object properties: count: type: integer latest: type: string format: date earliest: type: string format: date data: type: array items: type: object properties: date: type: string format: date label: type: string nullable: true gainers_count: type: integer losers_count: type: integer unchanged_count: type: integer description: Number of securities that closed unchanged. total_records: type: integer formatted_date: type: string 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. PlanRequired: description: Endpoint requires a higher plan. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: success: false error: code: PLAN_REQUIRED message: This endpoint requires a starter plan or higher. required_plan: starter current_plan: free 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). ````