Search Stock

Searches active GSE stocks by symbol or company name. Useful for autocomplete and stock pickers.

Request

bash

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

Query parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query — matched case-insensitively against `symbol` and `company_name`

Response

json

1{
2  "data": [
3    {
4      "symbol": "MTNGH",
5      "company_name": "Scancom PLC (MTN Ghana)",
6      "display_price": 2.10,
7      "total_trade_volume": 1250000
8    }
9  ],
10  "meta": {
11    "timestamp": "2026-03-03T11:22:22Z",
12    "version": "1.0",
13    "exchange": "GSE"
14  }
15}

Notes

An empty q returns an empty data array.
The search runs against the same stock list as GET /v1/stocks (active stocks only).
Response shape per item is identical to the GET /v1/stocks list for easy integration.