API product catalogPan-African Market Data & Intelligence

ETF price chart

Pan-African Market Data & Intelligence

GET

/etfs/{symbol}/chart

ETF price chart

Sandbox availablegetEtfChart

Returns pre-computed chart data for rendering price charts. Equivalent to /etfs/{symbol}/history but shaped for direct chart rendering with primary prices in local currency. Gated strictly to ETFs; querying standard stocks returns 404.

Parameters

symbolstringpathRequired

Example: GLD.ZA

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

Example: 1m

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

symbolstring

namestring

exchangestring

currencystring

rangestring

periodstring

currentPricenumber

rangeChangenumber

rangeChangePctnumber

priceHistoryobject[]

Per-candle OHLCV objects, same order as labels.

priceHistory[].datestring

priceHistory[].opennumber

Session open. Falls back to close for records pre-dating OHLCV storage.

priceHistory[].highnumber

Session high.

priceHistory[].lownumber

Session low.

priceHistory[].pricenumber

Closing price (alias of close, retained for backward compatibility).

priceHistory[].closenumber

Session closing price in local currency.

priceHistory[].usdPricenumber | null

Closing price converted to USD at live spot rate.

priceHistory[].volumeinteger

Session trading volume.

labelsstring[]

opensnumber[]

Parallel array of open prices (same order as labels).

highsnumber[]

Parallel array of session highs.

lowsnumber[]

Parallel array of session lows.

pricesnumber[]

volumesinteger[]

countinteger

Response codes

200Chart data.

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/chart

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "exchange": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "range": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "currentPrice": {
      "type": "number"
    },
    "rangeChange": {
      "type": "number"
    },
    "rangeChangePct": {
      "type": "number"
    },
    "priceHistory": {
      "type": "array",
      "description": "Per-candle OHLCV objects, same order as labels.",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date-time"
          },
          "open": {
            "type": "number",
            "description": "Session open. Falls back to close for records pre-dating OHLCV storage."
          },
          "high": {
            "type": "number",
            "description": "Session high."
          },
          "low": {
            "type": "number",
            "description": "Session low."
          },
          "price": {
            "type": "number",
            "description": "Closing price (alias of close, retained for backward compatibility)."
          },
          "close": {
            "type": "number",
            "description": "Session closing price in local currency."
          },
          "usdPrice": {
            "type": [
              "number",
              "null"
            ],
            "description": "Closing price converted to USD at live spot rate."
          },
          "volume": {
            "type": "integer",
            "description": "Session trading volume."
          }
        }
      }
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "opens": {
      "type": "array",
      "description": "Parallel array of open prices (same order as labels).",
      "items": {
        "type": "number"
      }
    },
    "highs": {
      "type": "array",
      "description": "Parallel array of session highs.",
      "items": {
        "type": "number"
      }
    },
    "lows": {
      "type": "array",
      "description": "Parallel array of session lows.",
      "items": {
        "type": "number"
      }
    },
    "prices": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "volumes": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "count": {
      "type": "integer"
    }
  }
}

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

GET /etfs/{symbol}

GET /etfs/{symbol}/history