{"openapi":"3.1.0","info":{"title":"GSE Ghana Stock Exchange API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/gse-api","description":"oanor gateway"}],"tags":[{"name":"Stocks"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/company":{"get":{"operationId":"get_v1_company","tags":["Stocks"],"summary":"Company profile","description":"","parameters":[{"name":"ticker","in":"query","required":true,"description":"GSE ticker, e.g. GCB, MTNGH","schema":{"type":"string"},"example":"GCB"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/movers":{"get":{"operationId":"get_v1_movers","tags":["Stocks"],"summary":"Top gainers or losers","description":"","parameters":[{"name":"direction","in":"query","required":false,"description":"gainers or losers (default gainers)","schema":{"type":"string"},"example":"gainers"},{"name":"limit","in":"query","required":false,"description":"Results (1-38, default 15)","schema":{"type":"string"},"example":"15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","volume":160000},{"price":0.42,"change":0,"ticker":"AADS","volume":0},{"price":5.3,"change":0,"ticker":"ADB","volume":0},{"price":37,"change":0,"ticker":"AGA","volume":0},{"price":8.46,"change":0,"ticker":"ALLGH","volume":12177},{"price":8.89,"change":0,"ticker":"ASG","volume":1},{"price":80,"change":0,"ticker":"BOPP","volume":1051},{"price":0.14,"change":0,"ticker":"CMLT","volume":0}],"direction":"gainers"},"meta":{"timestamp":"2026-06-15T02:10:58.860Z","request_id":"cca2194d-b5c3-4133-9bcd-b618c5819dbc"},"status":"ok","message":"Movers retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/quote":{"get":{"operationId":"get_v1_quote","tags":["Stocks"],"summary":"Company quote with fundamentals","description":"","parameters":[{"name":"ticker","in":"query","required":true,"description":"GSE ticker, e.g. MTNGH (MTN Ghana), GCB, ACCESS","schema":{"type":"string"},"example":"MTNGH"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"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,"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stocks":{"get":{"operationId":"get_v1_stocks","tags":["Stocks"],"summary":"Live market snapshot","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"ticker (default), change, volume or price","schema":{"type":"string"},"example":"change"},{"name":"limit","in":"query","required":false,"description":"Results (1-200, default 50)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"price":0.13,"change":0.01,"ticker":"CPC","volume":160000},{"price":0.77,"change":-0.01,"ticker":"CAL","volume":1420857},{"price":6.42,"change":-0.05,"ticker":"MTNGH","volume":4912881},{"price":41,"change":-0.7,"ticker":"EGH","volume":1422},{"price":12.99,"change":-1.26,"ticker":"GGBL","volume":3127},{"price":462.03,"change":-11.45,"ticker":"GLD","volume":17847},{"price":0.42,"change":0,"ticker":"AADS","volume":0},{"price":5.3,"change":0,"ticker":"ADB","volume":0},{"price":37,"change":0,"ticker":"AGA","volume":0},{"price":8.46,"change":0,"ticker":"ALLGH","volume":12177},{"price":8.89,"change":0,"ticker":"ASG","volume":1},{"price":80,"change":0,"ticker":"BOPP","volume":1051},{"price":0.14,"change":0,"ticker":"CMLT","volume":0},{"price":0.41,"change":0,"ticker":"DASPHARMA","volume":0},{"price":0.09,"change":0,"ticker":"DIGICUT","volume":0},{"price":10.05,"change":0,"ticker":"EGL","volume":73226},{"price":7.97,"change":0,"ticker":"FAB","volume":0},{"price":36,"change":0,"ticker":"GCB","volume":1521998},{"price":7.5,"change":0,"ticker":"GOIL","volume":48000},{"price":0.11,"change":0,"ticker":"HORDS","volume":710},{"price":0.08,"change":0,"ticker":"IIL","volume":1788},{"price":5.2,"change":0,"ticker":"MAC","volume":0},{"price":0.1,"change":0,"ticker":"MMH","volume":32},{"price":5,"change":0,"ticker":"RBGH","volume":11552},{"price":0.55,"change":0,"ticker":"SAMBA","volume":0},{"price":71.38,"change":0,"ticker":"SCB","volume":278},{"price":0.9,"change":0,"ticker":"SCBPREF","volume":0},{"price":1.2,"change":0,"ticker":"TBL","volume":0},{"price":11.92,"change":0,"ticker":"TLW","volume":29},{"price":29.5,"change":0,"ticker":"UNIL","volume":579},{"price":10,"change":0,"ticker":"ZEN","volume":30296}]},"meta":{"timestamp":"2026-06-15T02:10:59.238Z","request_id":"e97f11aa-c18a-47a3-a42b-f60f43544adb"},"status":"ok","message":"Stocks retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoints & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":13500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1590,"monthly_call_quota":265000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4480,"monthly_call_quota":1620000,"rps_limit":20,"hard_limit":true},{"slug":"enterprise","name":"Enterprise","price_cents_month":10850,"monthly_call_quota":8350000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/gse-api"}