API product catalogPan-African Market Data & Intelligence

ETF price history (candles)

Pan-African Market Data & Intelligence

GET

/etfs/{symbol}/history

Sandbox availablegetEtfHistory

Returns OHLCV candles for the given ETF symbol. Gated strictly to ETFs; querying standard stocks returns 404. Supported periods: 1d, 1w, 1m, 3m, 6m, 1y, 3y, 5y, max. Candle interval is auto-selected based on period.

Parameters

symbolstringpathRequired

Example: GLD.ZA

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

candles[].ohlcAvailableboolean

candles[].volumeAvailableboolean

Response codes

200Price history candles.

404Symbol not found or security is not an ETF.

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/etfs/%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"
          },
          "ohlcAvailable": {
            "type": "boolean"
          },
          "volumeAvailable": {
            "type": "boolean"
          }
        }
      }
    }
  }
}

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

GET /etfs/{symbol}/chart

GET /fx/rates