API product catalogPan-African Market Data & Intelligence

List ETFs

Pan-African Market Data & Intelligence

GET

/etfs

List ETFs

Sandbox availablelistEtfs

Returns a cursor-paginated list of tradeable ETFs across supported African exchanges. Prices are updated periodically during market hours. Filter by exchange or perform a text search on the ticker or name.

Parameters

exchangestringquery

Filter by exchange code. One of: NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM.

Example: JSE

searchstringquery

Search term matching the ETF ticker symbol or name.

Example: Gold

limitintegerquery

Example: 50

cursorstringquery

Opaque cursor returned by the previous page.

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

etfsobject[]

etfs[].idstring

Unique ETF identifier.

Example: "GLD.ZA"

etfs[].symbolstring

Exchange-qualified ticker symbol.

Example: "GLD.ZA"

etfs[].namestring

Full ETF name.

Example: "1nvest Gold ETF"

etfs[].slugstring | null

URL-safe identifier. Interchangeable with symbol.

Example: "gold-etf"

etfs[].exchangestring

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

Example: "JSE"

etfs[].currencystring

Local trading currency.

Example: "ZAR"

etfs[].sectorstring | null

Example: "Precious Metals"

etfs[].assetTypestring

Example: "ETF"

etfs[].listingStatusACTIVE | SUSPENDED | DELISTED

etfs[].pricenumber | null

Latest price in local currency.

Example: 22000

etfs[].usdPricenumber | null

Latest price converted to USD at live spot rate.

Example: 1180.5

etfs[].changenumber | null

Absolute price change from previous close.

Example: 15

etfs[].changePctnumber | null

Percentage price change from previous close.

Example: 0.68

etfs[].opennumber | null

Session opening price in local currency.

etfs[].dayHighnumber | null

Intraday high in local currency.

etfs[].dayLownumber | null

Intraday low in local currency.

etfs[].volumeinteger | null

Current session trading volume.

etfs[].previousClosenumber | null

Prior session closing price.

etfs[].logoUrlstring | null

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

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

etfs[].lastPriceUpdatestring | null

etfs[].expenseRationumber | null

The ETF annual management fee/expense ratio.

Example: 0.0025

etfs[].indexTrackedstring | null

The underlying index or asset tracked by the ETF.

Example: "Gold Spot Price"

etfs[].inceptionDatestring | null

The inception date of the fund.

Example: "2010-04-12"

etfs[].topHoldingsarray | null

Top constituents or holdings of the ETF.

Example: ["Physical Gold Bullion"]

etfs[].managementStylestring | null

PASSIVE or ACTIVE management style.

Example: "PASSIVE"

etfs[].geographicalFocusstring | null

Geographical focus of the fund's assets.

Example: "Global"

etfs[].riskLevelstring | number | null

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

Example: "Medium-High"

etfs[].distributionFrequencystring | null

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

Example: "Semi-Annually"

etfs[].brandstring | null

Fund sponsor/issuer brand.

Example: "1nvest"

etfs[].structurestring | null

Legal structure of the ETF fund.

Example: "Mutual Fund / Trust"

etfs[].replicationMethodstring | null

Physical or Synthetic replication.

Example: "Physical"

etfs[].dividendTreatmentstring | null

Accumulating or Distributing.

Example: "Accumulating"

etfs[].primaryAdvisorstring | null

Advisor company of the ETF.

Example: "Stanlib Crowd"

etfs[].issuerstring | null

The actual fund manager or issuing house.

Example: "Stanlib"

countinteger

hasMoreboolean

nextCursorstring | null

Response codes

200List of ETFs.

Sandbox playground

Read-only sandbox request

exchange Optional · querysearch Optional · querylimit Optional · querycursor Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/etfs

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "etfs": {
      "type": "array",
      "items": {
        "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."
          }
        }
      }
    },
    "count": {
      "type": "integer"
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}

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

GET /companies/tickers

GET /etfs/{symbol}