Stocks

Returns all active GSE-listed equities with their current display price and price change for the requested period.

Request

bash

1curl -X GET "https://api.usevalley.xyz/v1/stocks?period=today" \
2  -H "X-API-Key: live_your_key_here"

Query parameters

Parameter	Type	Default	Description
`period`	string	`today`	Comparison period: `today`, `7d`, `1m`, `3m`, `6m`, `1yr`, `ytd`, `all`

Response

json

1{
2  "data": [
3    {
4      "symbol": "MTNGH",
5      "company_name": "Scancom PLC (MTN Ghana)",
6      "display_price": 2.10,
7      "initial_price": 2.05,
8      "open_price": 2.05,
9      "high_price": 2.12,
10      "low_price": 2.03,
11      "close_price": 2.10,
12      "total_trade_volume": 1250000,
13      "last_known_price": 2.10
14    },
15    {
16      "symbol": "GCB",
17      "company_name": "GCB Bank",
18      "display_price": 5.80,
19      "initial_price": 5.70,
20      "total_trade_volume": 450000,
21      "last_known_price": 5.80
22    }
23  ],
24  "meta": {
25    "timestamp": "2026-03-03T11:22:22Z",
26    "version": "1.0",
27    "exchange": "GSE"
28  }
29}

Notes

display_price is the most recent known price for the session.
initial_price is the price at the start of the requested period — use it to compute change_pct yourself: (display_price - initial_price) / initial_price * 100.