Valley LogoBETA
News APIMarket News

Market News

Returns the latest business news from Ghanaian outlets across all GSE-listed stocks. Optionally filter by source.

Request

bash
1curl -X GET "https://api.usevalley.xyz/v1/news?limit=20&source=MyJoyOnline" \
2  -H "X-API-Key: live_your_key_here"

Query parameters

ParameterTypeDefaultMaxDescription
limitinteger20100Maximum number of articles to return
sourcestringFilter by outlet name (see list below)

Valid source values

ValueOutlet
MyJoyOnlinemyjoyonline.com
3News3news.com
Citi Newsroomcitinewsroom.com

Response

json
1{
2  "data": [
3    {
4      "id": "uuid",
5      "symbol": "GCB",
6      "title": "GCB Bank posts record profit for FY 2025",
7      "source": "Citi Newsroom",
8      "url": "https://citinewsroom.com/...",
9      "published_at": "2026-03-02T10:15:00Z",
10      "summary": "GCB Bank has announced a record annual profit of GHS 1.2 billion..."
11    },
12    {
13      "id": "uuid",
14      "symbol": "MTNGH",
15      "title": "MTN Ghana 5G rollout ahead of schedule",
16      "source": "MyJoyOnline",
17      "url": "https://myjoyonline.com/...",
18      "published_at": "2026-03-01T08:30:00Z",
19      "summary": null
20    }
21  ],
22  "meta": {
23    "timestamp": "2026-03-03T11:22:22Z",
24    "version": "1.0",
25    "exchange": "GSE"
26  }
27}

Notes

  • Results are sorted by published_at descending (newest first).
  • symbol indicates which GSE stock the article was matched to.
  • summary may be null if no summary was extracted from the article.