> ## 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. # Sectors > Retrieve sector-level performance. The sectors endpoint shows you which parts of the NGX market are gaining traction and which are pulling back. For every sector it calculates the average price change across all constituent companies over three windows (one day, seven days, and 52 weeks) along with aggregate market capitalisation, value traded, total share volume, and a breadth count of advancers, decliners, and unchanged stocks. Use this data to identify rotational flows between sectors or to build sector-performance heat maps. ## OpenAPI ````yaml GET /market/sectors 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/sectors: get: tags: - Market summary: Sector-level performance breakdown description: > 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. **Plan required:** Growth operationId: getMarketSectors responses: '200': description: Sector rotation data retrieved successfully. content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object properties: data: $ref: '#/components/schemas/SectorRotation' examples: sectors: summary: Sector performance breakdown value: success: true data: summary: top_sector_1d: Oil & Gas top_sector_7d: Banking sectors: - sector: Oil & Gas company_count: 8 total_market_cap: 4829104730200 total_value_traded: 821093847 total_volume: 48291030 change_1d: 2.1 change_7d: 5.4 change_52w: 31.2 breadth: advancers: 6 decliners: 1 unchanged: 1 - sector: Banking company_count: 14 total_market_cap: 7102948201000 total_value_traded: 1204817293 total_volume: 102847291 change_1d: 0.84 change_7d: 6.1 change_52w: 44.7 breadth: advancers: 9 decliners: 3 unchanged: 2 meta: plan: growth calls_used: 211 calls_remaining: 499789 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' SectorRotation: type: object properties: summary: type: object properties: top_sector_1d: type: string nullable: true top_sector_7d: type: string nullable: true sectors: type: array items: type: object properties: sector: type: string company_count: type: integer total_market_cap: type: number total_value_traded: type: number total_volume: type: integer change_1d: type: number change_7d: type: number change_52w: type: number breadth: type: object properties: advancers: type: integer decliners: type: integer unchanged: type: integer 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). ````