Skip to main content

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 sectors endpoint aggregates price performance across all companies in each NGX sector, giving you a single call that shows which sectors are leading or lagging the market. Endpoint: GET /v1/market/sectors (Growth plan)

​
Fetch all sectors

curl "https://api.ngnmarket.com/v1/market/sectors" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

​
Sample response (trimmed)

{
  "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.10,
        "change_7d": 5.40,
        "change_52w": 31.20,
        "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.10,
        "change_52w": 44.70,
        "breadth": {
          "advancers": 9,
          "decliners": 3,
          "unchanged": 2
        }
      }
    ]
  }
}

​
Sort or filter in your code

The response is already sorted by change_1d descending. If you want a different sort (by 52-week performance or market cap, for example) do it client-side:
JavaScript
// Top sectors by 52-week change
const byYearly = [...data.sectors].sort((a, b) => b.change_52w - a.change_52w);

// Sectors where more stocks declined than advanced (bearish breadth)
const bearish = data.sectors.filter(
  (s) => s.breadth.decliners > s.breadth.advancers
);

Sectors reference

Full response schema for GET /v1/market/sectors