API product catalogPan-African Market Data & Intelligence

Historical stock candles

Pan-African Market Data & Intelligence

GET

/stocks/{symbol}/candles

Sandbox availablegetStockCandles

Returns chart-ready OHLCV candles in the listing currency, sorted oldest-first. from and to define an inclusive date window; interval selects intraday bucket sizes or daily/weekly/monthly aggregation. African equity observations are exchange-supplied and 15-minute delayed. The API refresh target is 900 seconds during the published coverage window. This is pull-based market data—not a real-time or tick feed. Every listed African equity has EOD data for a line chart; complete reported OHLCV is instrument-dependent. Intraday candles are built only from observations captured after the intraday rollout; missing observations are never interpolated. The current delayed capture can be materially coarser than the requested 15m or 1h bucket, so inspect SPARSE_INTRADAY_COVERAGE, samplingCadenceSeconds, and intradayObservationCount before rendering an intraday chart. Older daily source rows may contain only close, or omit volume. Use each candle's volumeAvailable and the series coverage metadata before enabling volume-dependent indicators. Prices are raw and unadjusted for splits and dividends. MyStocks holds market-data rights for every supported exchange, so endpoint availability is not gated by missing exchange licences. Authenticated partners may display these candles to their end-users under their Partner Agreement. Raw-feed redistribution, bulk export, and standalone data products remain governed by that agreement and applicable downstream-use terms.

Parameters

symbolstringpathRequired

Exchange-qualified ticker (recommended) or an unambiguous bare ticker.

Example: SCOM.KE

interval15m | 1h | 1d | 1w | 1moquery

Candle bucket interval. 15m and 1h never interpolate missing observations and may be sparse on the delayed capture; 1mo means one calendar month. 1m is not supported.

Example: 1d

fromstringquery

Inclusive start date. Defaults to 30 calendar days ago.

Example: 2026-01-01

tostringquery

Inclusive end date. Defaults to today.

Example: 2026-08-10

adjustmentrawquery

Price-adjustment mode. Only raw, unadjusted exchange prices are currently available.

Example: raw

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

symbolstringRequired

Example: "SCOM.KE"

namestring | nullRequired

Example: "Safaricom PLC"

exchangestring | nullRequired

Example: "NSE"

currencystringRequired

Example: "KES"

interval15m | 1h | 1d | 1w | 1moRequired

adjustmentrawRequired

candlesobject[]Required

candles[].timestampstringRequired

UTC start of the 15-minute, hourly, daily, ISO-week, or calendar-month bucket.

Example: "2026-08-03T00:00:00.000Z"

candles[].opennumberRequired

Example: 16.2

candles[].highnumberRequired

Example: 16.75

candles[].lownumberRequired

Example: 16.1

candles[].closenumberRequired

Example: 16.5

candles[].volumeintegerRequired

Reported or sampled volume in the candle bucket. Check volumeAvailable before using it.

Example: 2450000

candles[].ohlcAvailablebooleanRequired

True when OHLC was reported or sampled; false when open/high/low are close-derived fallbacks.

candles[].volumeAvailablebooleanRequired

True when the source supplied volume for every observation in this candle.

metaobjectRequired

meta.request_idstring

Unique identifier for this request. Include in support tickets for tracing.

Example: "4f6e1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b"

meta.timestampstring

ISO 8601 UTC timestamp of when the response was generated.

Example: "2026-06-04T10:23:45.123Z"

meta.exchangestring | null

Exchange code the request was scoped to, when applicable.

Example: "NSE"

meta.symbolstring | null

Ticker symbol the request was scoped to, when applicable.

Example: "SCOM.KE"

meta.fromstringRequired

meta.tostringRequired

meta.countintegerRequired

meta.sourcedelayed_eod | delayed_intradayRequired

meta.asOfstring | nullRequired

Timestamp of the latest returned candle, or null when the range is empty.

meta.ohlcQualityreported | mixed | close_derived | sampledRequired

meta.ohlcAvailablebooleanRequired

meta.ohlcCoveragePctnumberRequired

meta.flatCandlePctnumberRequired

meta.volumeAvailablebooleanRequired

meta.volumeCoveragePctnumberRequired

meta.volumeStatusunavailable | partial | completeRequired

meta.zeroVolumePctnumberRequired

meta.qualityStatuscomplete | partial | degraded | unavailableRequired

meta.qualityIssuesstring[]Required

meta.recommendedChartTypecandlestick | line | noneRequired

Server recommendation derived from price quality. Any missing OHLC, a flat-candle rate of 25% or more, or sparse intraday observations produces line; incomplete volume alone does not prevent candlesticks.

meta.samplingCadenceSecondsinteger | null

Median observed same-session gap between source snapshots, not a promised target cadence.

Example: 14400

meta.intradayObservationCountinteger | null

Source observations available for the requested intraday window before bucketing.

meta.coverageStartsAtstring | null

meta.adjustedfalseRequired

meta.sandboxboolean

Response codes

200Historical candles and data-quality metadata.

400Invalid date, interval, adjustment, or interval-specific date range.

401Unauthorized.

404Symbol not found or ambiguous.

Sandbox playground

Read-only sandbox request

symbol Required · pathinterval Optional · queryfrom Optional · queryto Optional · queryadjustment Optional · querySandbox API keyYour key stays in this page’s memory.

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

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "required": [
    "symbol",
    "name",
    "exchange",
    "currency",
    "interval",
    "adjustment",
    "candles",
    "meta"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "example": "SCOM.KE"
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "example": "Safaricom PLC"
    },
    "exchange": {
      "type": [
        "string",
        "null"
      ],
      "example": "NSE"
    },
    "currency": {
      "type": "string",
      "example": "KES"
    },
    "interval": {
      "type": "string",
      "enum": [
        "15m",
        "1h",
        "1d",
        "1w",
        "1mo"
      ]
    },
    "adjustment": {
      "type": "string",
      "enum": [
        "raw"
      ]
    },
    "candles": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "A chart-ready OHLCV candle in the instrument's listing currency.",
        "required": [
          "timestamp",
          "open",
          "high",
          "low",
          "close",
          "volume",
          "ohlcAvailable",
          "volumeAvailable"
        ],
        "properties": {
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "UTC start of the 15-minute, hourly, daily, ISO-week, or calendar-month bucket.",
            "example": "2026-08-03T00:00:00.000Z"
          },
          "open": {
            "type": "number",
            "example": 16.2
          },
          "high": {
            "type": "number",
            "example": 16.75
          },
          "low": {
            "type": "number",
            "example": 16.1
          },
          "close": {
            "type": "number",
            "example": 16.5
          },
          "volume": {
            "type": "integer",
            "description": "Reported or sampled volume in the candle bucket. Check volumeAvailable before using it.",
            "example": 2450000
          },
          "ohlcAvailable": {
            "type": "boolean",
            "description": "True when OHLC was reported or sampled; false when open/high/low are close-derived fallbacks."
          },
          "volumeAvailable": {
            "type": "boolean",
            "description": "True when the source supplied volume for every observation in this candle."
          }
        }
      }
    },
    "meta": {
      "allOf": [
        {
          "type": "object",
          "description": "Standard response metadata included on every market-data envelope.",
          "properties": {
            "request_id": {
              "type": "string",
              "format": "uuid",
              "description": "Unique identifier for this request. Include in support tickets for tracing.",
              "example": "4f6e1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b"
            },
            "timestamp": {
              "type": "string",
              "format": "date-time",
              "description": "ISO 8601 UTC timestamp of when the response was generated.",
              "example": "2026-06-04T10:23:45.123Z"
            },
            "exchange": {
              "type": [
                "string",
                "null"
              ],
              "description": "Exchange code the request was scoped to, when applicable.",
              "example": "NSE"
            },
            "symbol": {
              "type": [
                "string",
                "null"
              ],
              "description": "Ticker symbol the request was scoped to, when applicable.",
              "example": "SCOM.KE"
            }
          }
        },
        {
          "type": "object",
          "required": [
            "from",
            "to",
            "count",
            "source",
            "asOf",
            "ohlcQuality",
            "ohlcAvailable",
            "ohlcCoveragePct",
            "flatCandlePct",
            "volumeAvailable",
            "volumeCoveragePct",
            "volumeStatus",
            "zeroVolumePct",
            "qualityStatus",
            "qualityIssues",
            "recommendedChartType",
            "adjusted"
          ],
          "properties": {
            "from": {
              "type": "string",
              "format": "date"
            },
            "to": {
              "type": "string",
              "format": "date"
            },
            "count": {
              "type": "integer"
            },
            "source": {
              "type": "string",
              "enum": [
                "delayed_eod",
                "delayed_intraday"
              ]
            },
            "asOf": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time",
              "description": "Timestamp of the latest returned candle, or null when the range is empty."
            },
            "ohlcQuality": {
              "type": "string",
              "enum": [
                "reported",
                "mixed",
                "close_derived",
                "sampled"
              ]
            },
            "ohlcAvailable": {
              "type": "boolean"
            },
            "ohlcCoveragePct": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "flatCandlePct": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "volumeAvailable": {
              "type": "boolean"
            },
            "volumeCoveragePct": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "volumeStatus": {
              "type": "string",
              "enum": [
                "unavailable",
                "partial",
                "complete"
              ]
            },
            "zeroVolumePct": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "qualityStatus": {
              "type": "string",
              "enum": [
                "complete",
                "partial",
                "degraded",
                "unavailable"
              ]
            },
            "qualityIssues": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "NO_CHART_DATA",
                  "OHLC_UNAVAILABLE",
                  "OHLC_PARTIAL",
                  "FLAT_SERIES",
                  "HIGH_FLAT_CANDLE_RATE",
                  "VOLUME_UNAVAILABLE",
                  "VOLUME_PARTIAL",
                  "HIGH_ZERO_VOLUME_RATE",
                  "SPARSE_INTRADAY_COVERAGE"
                ]
              }
            },
            "recommendedChartType": {
              "type": "string",
              "enum": [
                "candlestick",
                "line",
                "none"
              ],
              "description": "Server recommendation derived from price quality. Any missing OHLC, a flat-candle rate of 25% or more, or sparse intraday observations produces `line`; incomplete volume alone does not prevent candlesticks."
            },
            "samplingCadenceSeconds": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Median observed same-session gap between source snapshots, not a promised target cadence.",
              "example": 14400
            },
            "intradayObservationCount": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Source observations available for the requested intraday window before bucketing."
            },
            "coverageStartsAt": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            },
            "adjusted": {
              "type": "boolean",
              "enum": [
                false
              ]
            },
            "sandbox": {
              "type": "boolean"
            }
          }
        }
      ]
    }
  }
}

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

GET /stocks/{symbol}

GET /stocks/{symbol}/chart