Valley LogoBETA
Get startedIntroduction

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

Valley heartmap chart

What data is available?

CategoryWhat you get
MarketGainers, losers, most traded, advancing/declining breadth, sector performance
StocksReal-time quotes, OHLCV history, intraday ticks, company profile
NewsCurated business news matched to GSE-listed stocks from Ghanaian outlets
SearchFull-text search across all active stock symbols and company names
WebSocketStreaming 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.