API product catalogPan-African Market Data & Intelligence

Get ETF detail

Pan-African Market Data & Intelligence

GET

/etfs/{symbol}

Get ETF detail

Sandbox availablegetEtf

Returns full price data, historical range chart data, and rich fund-specific metadata for a single ETF. Accepts exchange-qualified symbols (e.g., GLD.ZA) or bare tickers (e.g., GLD). Gated strictly to ETFs; querying standard stocks returns 404.

Parameters

symbolstringpathRequired

Exchange-qualified ETF symbol (e.g. GLD.ZA) or bare ticker.

Example: GLD.ZA

range1W | 1M | 3M | 6M | 1Y | ALLquery

Time range of legacy price history points to include. Default is 3M.

Example: 3M

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

idstring

Unique ETF identifier.

Example: "GLD.ZA"

symbolstring

Exchange-qualified ticker symbol.

Example: "GLD.ZA"

namestring

Full ETF name.

Example: "1nvest Gold ETF"

slugstring | null

URL-safe identifier. Interchangeable with symbol.

Example: "gold-etf"

exchangestring

Exchange code: NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM.

Example: "JSE"

currencystring

Local trading currency.

Example: "ZAR"

sectorstring | null

Example: "Precious Metals"

assetTypestring

Example: "ETF"

listingStatusACTIVE | SUSPENDED | DELISTED

pricenumber | null

Latest price in local currency.

Example: 22000

usdPricenumber | null

Latest price converted to USD at live spot rate.

Example: 1180.5

changenumber | null

Absolute price change from previous close.

Example: 15

changePctnumber | null

Percentage price change from previous close.

Example: 0.68

opennumber | null

Session opening price in local currency.

dayHighnumber | null

Intraday high in local currency.

dayLownumber | null

Intraday low in local currency.

volumeinteger | null

Current session trading volume.

previousClosenumber | null

Prior session closing price.

logoUrlstring | null

Self-hosted SVG logo. Safe to use as img src.

Example: "https://mystocks.africa/logos/gld-za.svg"

lastPriceUpdatestring | null

expenseRationumber | null

The ETF annual management fee/expense ratio.

Example: 0.0025

indexTrackedstring | null

The underlying index or asset tracked by the ETF.

Example: "Gold Spot Price"

inceptionDatestring | null

The inception date of the fund.

Example: "2010-04-12"

topHoldingsarray | null

Top constituents or holdings of the ETF.

Example: ["Physical Gold Bullion"]

managementStylestring | null

PASSIVE or ACTIVE management style.

Example: "PASSIVE"

geographicalFocusstring | null

Geographical focus of the fund's assets.

Example: "Global"

riskLevelstring | number | null

Source risk rating: text label or numeric rating; null when not supplied.

Example: "Medium-High"

distributionFrequencystring | null

Distribution frequency (e.g. Annually, Semi-Annually, Quarterly, None).

Example: "Semi-Annually"

brandstring | null

Fund sponsor/issuer brand.

Example: "1nvest"

structurestring | null

Legal structure of the ETF fund.

Example: "Mutual Fund / Trust"

replicationMethodstring | null

Physical or Synthetic replication.

Example: "Physical"

dividendTreatmentstring | null

Accumulating or Distributing.

Example: "Accumulating"

primaryAdvisorstring | null

Advisor company of the ETF.

Example: "Stanlib Crowd"

issuerstring | null

The actual fund manager or issuing house.

Example: "Stanlib"

currentPricenumber

Example: 22000

rangestring

Example: "3M"

priceHistoryobject[]

priceHistory[].datestring

priceHistory[].pricenumber

priceHistory[].labelstring

Example: "Live"

countinteger

Response codes

200ETF details and historical price series.

404Symbol not found or security is not an ETF.

Sandbox playground

Read-only sandbox request

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

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

Open in API Tester API Reference

Response schema

{
  "allOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "example": "GLD.ZA",
          "description": "Unique ETF identifier."
        },
        "symbol": {
          "type": "string",
          "example": "GLD.ZA",
          "description": "Exchange-qualified ticker symbol."
        },
        "name": {
          "type": "string",
          "example": "1nvest Gold ETF",
          "description": "Full ETF name."
        },
        "slug": {
          "type": [
            "string",
            "null"
          ],
          "example": "gold-etf",
          "description": "URL-safe identifier. Interchangeable with symbol."
        },
        "exchange": {
          "type": "string",
          "example": "JSE",
          "description": "Exchange code: NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM."
        },
        "currency": {
          "type": "string",
          "example": "ZAR",
          "description": "Local trading currency."
        },
        "sector": {
          "type": [
            "string",
            "null"
          ],
          "example": "Precious Metals"
        },
        "assetType": {
          "type": "string",
          "example": "ETF"
        },
        "listingStatus": {
          "type": "string",
          "enum": [
            "ACTIVE",
            "SUSPENDED",
            "DELISTED"
          ]
        },
        "price": {
          "type": [
            "number",
            "null"
          ],
          "example": 22000,
          "description": "Latest price in local currency."
        },
        "usdPrice": {
          "type": [
            "number",
            "null"
          ],
          "example": 1180.5,
          "description": "Latest price converted to USD at live spot rate."
        },
        "change": {
          "type": [
            "number",
            "null"
          ],
          "example": 15,
          "description": "Absolute price change from previous close."
        },
        "changePct": {
          "type": [
            "number",
            "null"
          ],
          "example": 0.68,
          "description": "Percentage price change from previous close."
        },
        "open": {
          "type": [
            "number",
            "null"
          ],
          "description": "Session opening price in local currency."
        },
        "dayHigh": {
          "type": [
            "number",
            "null"
          ],
          "description": "Intraday high in local currency."
        },
        "dayLow": {
          "type": [
            "number",
            "null"
          ],
          "description": "Intraday low in local currency."
        },
        "volume": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Current session trading volume."
        },
        "previousClose": {
          "type": [
            "number",
            "null"
          ],
          "description": "Prior session closing price."
        },
        "logoUrl": {
          "type": [
            "string",
            "null"
          ],
          "example": "https://mystocks.africa/logos/gld-za.svg",
          "description": "Self-hosted SVG logo. Safe to use as img src."
        },
        "lastPriceUpdate": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "expenseRatio": {
          "type": [
            "number",
            "null"
          ],
          "example": 0.0025,
          "description": "The ETF annual management fee/expense ratio."
        },
        "indexTracked": {
          "type": [
            "string",
            "null"
          ],
          "example": "Gold Spot Price",
          "description": "The underlying index or asset tracked by the ETF."
        },
        "inceptionDate": {
          "type": [
            "string",
            "null"
          ],
          "example": "2010-04-12",
          "description": "The inception date of the fund."
        },
        "topHoldings": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          },
          "example": [
            "Physical Gold Bullion"
          ],
          "description": "Top constituents or holdings of the ETF."
        },
        "managementStyle": {
          "type": [
            "string",
            "null"
          ],
          "example": "PASSIVE",
          "description": "PASSIVE or ACTIVE management style."
        },
        "geographicalFocus": {
          "type": [
            "string",
            "null"
          ],
          "example": "Global",
          "description": "Geographical focus of the fund's assets."
        },
        "riskLevel": {
          "type": [
            "string",
            "number",
            "null"
          ],
          "example": "Medium-High",
          "description": "Source risk rating: text label or numeric rating; null when not supplied."
        },
        "distributionFrequency": {
          "type": [
            "string",
            "null"
          ],
          "example": "Semi-Annually",
          "description": "Distribution frequency (e.g. Annually, Semi-Annually, Quarterly, None)."
        },
        "brand": {
          "type": [
            "string",
            "null"
          ],
          "example": "1nvest",
          "description": "Fund sponsor/issuer brand."
        },
        "structure": {
          "type": [
            "string",
            "null"
          ],
          "example": "Mutual Fund / Trust",
          "description": "Legal structure of the ETF fund."
        },
        "replicationMethod": {
          "type": [
            "string",
            "null"
          ],
          "example": "Physical",
          "description": "Physical or Synthetic replication."
        },
        "dividendTreatment": {
          "type": [
            "string",
            "null"
          ],
          "example": "Accumulating",
          "description": "Accumulating or Distributing."
        },
        "primaryAdvisor": {
          "type": [
            "string",
            "null"
          ],
          "example": "Stanlib Crowd",
          "description": "Advisor company of the ETF."
        },
        "issuer": {
          "type": [
            "string",
            "null"
          ],
          "example": "Stanlib",
          "description": "The actual fund manager or issuing house."
        }
      }
    },
    {
      "type": "object",
      "properties": {
        "currentPrice": {
          "type": "number",
          "example": 22000
        },
        "range": {
          "type": "string",
          "example": "3M"
        },
        "priceHistory": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string",
                "format": "date-time"
              },
              "price": {
                "type": "number"
              },
              "label": {
                "type": "string",
                "example": "Live"
              }
            }
          }
        },
        "count": {
          "type": "integer"
        }
      }
    }
  ]
}

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

GET /etfs

GET /etfs/{symbol}/chart