API product catalogPan-African Market Data & Intelligence

Stock price history

Pan-African Market Data & Intelligence

GET

/stocks/{symbol}/history

Stock price history

Sandbox availableDeprecatedlistHistory

Legacy period-based history for the given symbol. Supported periods: 1d, 1w, 1m, 3m, 6m, 1y, 3y, 5y, and max. This endpoint returns available daily records; it does not aggregate weekly or monthly bars. New chart integrations should use GET /stocks/{symbol}/candles, which has explicit date bounds, aggregation intervals, data-quality metadata, and a stable candle schema. This route is deprecated and scheduled for removal on 2026-10-01.

Parameters

symbolstringpathRequired

Example: SCOM.KE

period1d | 1w | 1m | 3m | 6m | 1y | 3y | 5y | maxquery

Time range. Default: 1m.

Example: 1m

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

symbolstring

periodstring

candlesobject[]

candles[].datestring

candles[].opennumber

candles[].highnumber

candles[].lownumber

candles[].closenumber

candles[].volumeinteger

Response codes

200Price history candles.

Sandbox playground

Read-only sandbox request

symbol Required · pathperiod Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/stocks/%7Bsymbol%7D/history

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "candles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "open": {
            "type": "number"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          },
          "close": {
            "type": "number"
          },
          "volume": {
            "type": "integer"
          }
        }
      }
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/stocks/%7Bsymbol%7D/history' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

GET /stocks/{symbol}/chart

GET /stocks/{symbol}/pulse