Stock Detail

Returns a comprehensive snapshot for a single equity: the latest session data, yearly metrics, and company profile all in one request.

Request

bash

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

Path parameters

Parameter	Description
`symbol`	GSE ticker symbol (case-insensitive, e.g. `MTNGH`, `gcb`, `EGL`)

Response

json

1{
2  "data": {
3    "latest": {
4      "symbol": "MTNGH",
5      "display_price": 2.1,
6      "open_price": 2.05,
7      "high_price": 2.12,
8      "low_price": 2.03,
9      "close_price": 2.1,
10      "total_trade_volume": 1250000,
11      "last_known_price": 2.1
12    },
13    "metrics": {
14      "yearHigh": 2.45,
15      "yearLow": 1.72,
16      "avgVolume30d": 980000,
17      "previousClose": 2.05,
18      "marketCap": 83784988066.5,
19      "shares": 13236175050,
20      "floatingShares": 3236175050
21    },
22    "company": {
23      "symbol": "MTNGH",
24      "company_name": "Scancom PLC (MTN Ghana)",
25      "sector": "Telecommunications",
26      "industry": "Mobile Telecommunications",
27      "exchange": "GSE",
28      "description": "MTN Ghana is the leading telecoms operator in Ghana...",
29      "ceo": "Selorm Adadevoh",
30      "founded_year": 1994,
31      "website": "https://mtn.com.gh",
32      "employees": 1200,
33      "address": "MTN House, West Ridge, Accra",
34      "email": "customercare@mtn.com.gh",
35      "telephone": "+233-24-430-0000"
36    }
37  },
38  "meta": {
39    "timestamp": "2026-03-03T11:22:22Z",
40    "version": "1.2",
41    "exchange": "GSE"
42  }
43}

Error response

Returns 404 Not Found if the symbol does not exist.

json

1{ "statusCode": 404, "message": "Stock XXXX not found" }