Valley LogoBETA
Market APIMarket Sectors

Market Sectors

Returns all GSE sectors, each with their constituent stocks and the average percentage change across those stocks for the current session.

Request

bash
1curl -X GET "https://api.usevalley.xyz/v1/market/sectors" \
2  -H "X-API-Key: live_your_key_here"

No query parameters.

Response

json
1{
2  "data": [
3    {
4      "sector": "Telecommunications",
5      "stock_count": 1,
6      "avg_change_pct": 2.44,
7      "stocks": [
8        { "symbol": "MTNGH", "company_name": "Scancom PLC (MTN Ghana)", "display_price": 2.10 }
9      ]
10    },
11    {
12      "sector": "Finance",
13      "stock_count": 8,
14      "avg_change_pct": 0.83,
15      "stocks": [
16        { "symbol": "GCB", "company_name": "GCB Bank", "display_price": 5.80 },
17        { "symbol": "SCB", "company_name": "Standard Chartered Bank Ghana", "display_price": 22.50 }
18      ]
19    }
20  ],
21  "meta": {
22    "timestamp": "2026-03-03T11:22:22Z",
23    "version": "1.0",
24    "exchange": "GSE"
25  }
26}

Notes

  • Results are sorted by avg_change_pct descending (best-performing sector first).
  • avg_change_pct is the simple mean of each constituent stock's intraday percentage change.