Market Snapshot

Returns a snapshot of the current GSE session: top gainers, top losers, most actively traded stocks, and market breadth (advancing/declining/unchanged counts).

Request

bash

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

No query parameters.

Response

json

1{
2  "data": {
3    "gainers": [
4      { "symbol": "MTNGH", "company_name": "Scancom PLC", "display_price": 2.10, "change_pct": 2.44 },
5      { "symbol": "GCB", "company_name": "GCB Bank", "display_price": 5.80, "change_pct": 1.75 }
6    ],
7    "losers": [
8      { "symbol": "TOTAL", "company_name": "TotalEnergies Ghana", "display_price": 4.12, "change_pct": -0.48 }
9    ],
10    "most_traded": [
11      { "symbol": "MTNGH", "company_name": "Scancom PLC", "display_price": 2.10, "total_trade_volume": 1250000 }
12    ],
13    "breadth": {
14      "advancing": 18,
15      "declining": 4,
16      "unchanged": 5,
17      "total": 27
18    }
19  },
20  "meta": {
21    "timestamp": "2026-03-03T11:22:22Z",
22    "version": "1.0",
23    "exchange": "GSE"
24  }
25}

Notes

gainers and losers return the top 5 by percentage change.
most_traded returns the top 5 by total_trade_volume for the current session.