# GSE Ghana Stock Exchange API > Live data from the Ghana Stock Exchange (GSE), with no key. Read the live market snapshot of every listed equity (price in Ghanaian cedis, change and volume); a full company quote with fundamentals (price, market capitalisation, shares outstanding, EPS, dividend per share, sector and industry); the company profile (name, sector, industry, address, website); and the day's top gainers and losers. The Ghana-equities / fundamentals / company-profile layer for trading dashboards, screeners and research — distinct from other exchange readers, this is GSE data. Live from the public kwayisi feed; short cache only. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/gse-api/..." ``` ## Pricing - **Free** (Free) — 13,500 calls/Mo, 3 req/s - **Starter** ($16/Mo) — 265,000 calls/Mo, 8 req/s - **Pro** ($45/Mo) — 1,620,000 calls/Mo, 20 req/s - **Enterprise** ($109/Mo) — 8,350,000 calls/Mo, 60 req/s ## Endpoints ### Stocks #### `GET /v1/company` — Company profile **Parameters:** - `ticker` (query, required, string) — GSE ticker, e.g. GCB, MTNGH Example: `GCB` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gse-api/v1/company?ticker=GCB" ``` **Response:** ```json { "data": { "name": "GCB Bank Limited", "note": "The company profile for one GSE-listed equity — registered name, sector, industry, address and contact details. Pass ticker (e.g. MTNGH for Scancom/MTN Ghana).", "email": "corporateaffairs@gcb.com.gh", "sector": "Financials", "source": "GSE", "ticker": "GCB", "address": "GCB Building, Thorpe Road/High Street, PO Box GP 134, Accra, Ghana", "website": "www.gcbbank.com.gh", "industry": "Banking", "telephone": "+233-302-663-964, +233-302-672-852, +233-302-664-914" }, "meta": { "timestamp": "2026-06-15T02:10:58.585Z", "request_id": "ddfabf9d-ab24-49cb-8329-0babb422d193" }, "status": "ok", "message": "Company retrieved successfully", "success": true } ``` #### `GET /v1/movers` — Top gainers or losers **Parameters:** - `direction` (query, optional, string) — gainers or losers (default gainers) Example: `gainers` - `limit` (query, optional, string) — Results (1-38, default 15) Example: `15` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gse-api/v1/movers?direction=gainers&limit=15" ``` **Response:** ```json { "data": { "note": "The day's top gainers or losers on the GSE — each with its price, change and volume. Pass direction (gainers or losers) and limit. Computed across the whole Ghana market.", "count": 15, "source": "GSE", "stocks": [ { "price": 29, "change": 1.4, "ticker": "ACCESS", "volume": 1953 }, { "price": 4.93, "change": 0.44, "ticker": "SIC", "volume": 68218 }, { "price": 36.3, "change": 0.3, "ticker": "TOTAL", "volume": 2691 }, { "price": 2.45, "change": 0.21, "ticker": "CLYD", "volume": 14986 }, { "price": 6.8, "change": 0.19, "ticker": "SOGEGH", "volume": 34614 }, { "price": 2.09, "change": 0.18, "ticker": "ETI", "volume": 375323 }, { "price": 13.34, "change": 0.03, "ticker": "FML", "volume": 8646 }, { "price": 0.13, "change": 0.01, "ticker": "CPC", …(truncated, see openapi.json for full schema) ``` #### `GET /v1/quote` — Company quote with fundamentals **Parameters:** - `ticker` (query, required, string) — GSE ticker, e.g. MTNGH (MTN Ghana), GCB, ACCESS Example: `MTNGH` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gse-api/v1/quote?ticker=MTNGH" ``` **Response:** ```json { "data": { "eps": null, "note": "A full company quote for one GSE-listed equity — price (GHS), market capitalisation, shares outstanding, earnings per share, dividend per share, sector and industry. Pass ticker (e.g. MTNGH, GCB, ACCESS).", "price": 6.42, "sector": "Telecommunications", "source": "GSE", "ticker": "MTNGH", "company": "Scancom Plc", "industry": "Mobile Telecommunications", "market_cap": 84976243821, "dividend_per_share": null, "shares_outstanding": 13236175050 }, "meta": { "timestamp": "2026-06-15T02:10:59.128Z", "request_id": "80f36daf-8541-402a-a47e-0e1d6f26c86f" }, "status": "ok", "message": "Quote retrieved successfully", "success": true } ``` #### `GET /v1/stocks` — Live market snapshot **Parameters:** - `sort` (query, optional, string) — ticker (default), change, volume or price Example: `change` - `limit` (query, optional, string) — Results (1-200, default 50) Example: `50` - `offset` (query, optional, string) — Pagination offset Example: `0` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gse-api/v1/stocks?sort=change&limit=50&offset=0" ``` **Response:** ```json { "data": { "note": "The live market snapshot of every GSE-listed equity — each with its price (GHS), change and volume. Sort by ticker (default), change, volume or price; page with offset and limit. The full Ghana market tape.", "sort": "change", "count": 38, "total": 38, "offset": 0, "source": "GSE", "stocks": [ { "price": 29, "change": 1.4, "ticker": "ACCESS", "volume": 1953 }, { "price": 4.93, "change": 0.44, "ticker": "SIC", "volume": 68218 }, { "price": 36.3, "change": 0.3, "ticker": "TOTAL", "volume": 2691 }, { "price": 2.45, "change": 0.21, "ticker": "CLYD", "volume": 14986 }, { "price": 6.8, "change": 0.19, "ticker": "SOGEGH", "volume": 34614 }, { "price": 2.09, "change": 0.18, "ticker": "ETI", "volume": 375323 }, { "price": 13.34, "change": 0.03, "ticker": "FML", "volume": 8646 }, { …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Endpoints & source **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gse-api/v1/meta" ``` **Response:** ```json { "data": { "sample": { "mtngh_price": 6.42 }, "source": "public kwayisi GSE feed (dev.kwayisi.org/apis/gse), keyless", "service": "gse-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/quote": "Full company quote with fundamentals (ticker).", "GET /v1/movers": "Top gainers or losers (direction, limit).", "GET /v1/stocks": "Live market snapshot (sort, limit).", "GET /v1/company": "Company profile (ticker)." }, "description": "Live data from the Ghana Stock Exchange (GSE) with no key: the live market snapshot of every listed equity (price in GHS, change, volume), a full company quote with fundamentals (market cap, shares, EPS, dividend per share, sector, industry), the company profile, and the day's top gainers and losers. The Ghana-equities / fundamentals / company-profile layer for trading dashboards and screeners. Distinct from other exchange readers — GSE data. Live, short cache only.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-15T02:10:59.327Z", "request_id": "dacd023a-2b3e-4ade-b851-296f28a38bd2" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/gse-api OpenAPI spec: https://www.oanor.com/api/gse-api/openapi.json