Introduction
Valley is your source for the most reliable and accurate stock market data API. It provides programmatic access to real-time and historical market data for every equity listed on the Ghana Stock Exchange (GSE).
It is built for:
- Developers building trading dashboards, portfolio trackers, or market alert bots
- Financial institutions that need reliable GSE data feeds
- Researchers and analysts who want structured, machine-readable price history

What data is available?
| Category | What you get |
|---|---|
| Market | Gainers, losers, most traded, advancing/declining breadth, sector performance |
| Stocks | Real-time quotes, OHLCV history, intraday ticks, company profile |
| News | Curated business news matched to GSE-listed stocks from Ghanaian outlets |
| Search | Full-text search across all active stock symbols and company names |
| WebSocket | Streaming live quotes, ticks, and market snapshots — no polling needed |
Base URL
All endpoints are served from:
https://api.usevalley.xyz/v1
Response format
Every response uses a standard envelope so you always know the data's provenance:
json
1{
2 "data": { ... },
3 "meta": {
4 "timestamp": "2026-03-03T11:00:00Z",
5 "version": "1.2",
6 "exchange": "GSE"
7 }
8}Authentication
All endpoints require an X-API-Key header. See Quickstart to generate your first key.
Rate limiting
Limits are enforced per API key. See Rate limits for tier details.