API product catalogPan-African Market Data & Intelligence

Top gainers & losers (deprecated alias)

Pan-African Market Data & Intelligence

GET

/market-data/movers

Sandbox availableDeprecatedgetMarketDataMovers

Deprecated alias of GET /market/movers. Identical handler and response shape. Existing integrations keep working; use /market/movers in new code.

Parameters

exchangestringqueryRequired

Example: NSE

directiongainers | losersquery

Example: gainers

limitintegerquery

Example: 10

pageintegerquery

Example: 1

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

idstring

Unique stock identifier.

Example: "SCOM.KE"

symbolstring

Exchange-qualified ticker symbol.

Example: "SCOM.KE"

namestring

Full company name.

Example: "Safaricom PLC"

slugstring | null

URL-safe identifier. Interchangeable with symbol.

Example: "safaricom"

exchangestring

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

Example: "NSE"

exchangeMicstring | null

ISO 10383 operating Market Identifier Code for the listing exchange.

Example: "XNAI"

currencystring

Local trading currency.

Example: "KES"

sectorstring | null

Example: "Telecommunications"

assetTypeSTOCK | ETF

listingStatusACTIVE | SUSPENDED | DELISTED

pricenumber | null

Latest price in local currency.

Example: 16.5

usdPricenumber | null

Latest price converted to USD at live spot rate.

Example: 0.1274

changenumber | null

Absolute price change from previous close.

Example: 0.25

changePctnumber | null

Percentage price change from previous close.

Example: 1.54

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/scom-ke.svg"

lastPriceUpdatestring | null

marketStatusstring

Exchange state at quote time: OPEN or CLOSED. Present on /market/quotes and /market/movers responses.

bidnumber | null

Best bid. Currently always null (no order-book depth in the data source).

asknumber | null

Best ask. Currently always null (no order-book depth in the data source).

dataFreshnessSecondsinteger | null

Seconds since the last price update. Present on /market/quotes and /market/movers responses.

asOfstring | null

Timestamp of the exchange observation — NOT when the API answered. African equity data is 15-minute delayed and the API refresh target is 900 seconds, so display and evaluate freshness against this value.

staleboolean

True when the price is older than two refresh intervals (30 minutes). The feed for this symbol is genuinely behind — do not trust the price for pricing a trade.

dataQualityobject

The published market-data freshness contract. African equity quotes are supplied by the exchanges on a 15-minute-delayed basis, not in real time. MyStocks holds full exchange data rights. The API refresh target is 900 seconds during the published coverage window, with an end-of-day pass after market close.

dataQuality.asOfstring | nullRequired

Timestamp of the exchange observation, not the time the API response was generated.

dataQuality.ageSecondsinteger | nullRequired

Age of the price in seconds (now − asOf).

dataQuality.stalebooleanRequired

True when the price is older than two refresh intervals.

dataQuality.delayModeDELAYED | END_OF_DAYRequired

DELAYED — exchange-supplied data in the 15-minute-delayed latency class. END_OF_DAY — outside the window; this is the most recent close, not a live quote.

dataQuality.delayMinutesintegerRequired

Exchange feed latency class in minutes. This is distinct from the API refresh target.

Example: 15

dataQuality.refreshIntervalSecondsintegerRequired

Target interval between API ingestion refreshes during the published coverage window.

Example: 900

dataQuality.providermstocks | mansaRequired

MyStocks ingestion connector for this exchange feed. This field does not describe exchange licensing or partner entitlement.

dataQuality.disclaimerstringRequired

Plain-English statement of what this price is and is not.

Response codes

200See `GET /market/movers`.

Sandbox playground

Read-only sandbox request

exchange Required · querydirection Optional · querylimit Optional · querypage Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/market-data/movers

API Reference

Response schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "example": "SCOM.KE",
      "description": "Unique stock identifier."
    },
    "symbol": {
      "type": "string",
      "example": "SCOM.KE",
      "description": "Exchange-qualified ticker symbol."
    },
    "name": {
      "type": "string",
      "example": "Safaricom PLC",
      "description": "Full company name."
    },
    "slug": {
      "type": [
        "string",
        "null"
      ],
      "example": "safaricom",
      "description": "URL-safe identifier. Interchangeable with symbol."
    },
    "exchange": {
      "type": "string",
      "example": "NSE",
      "description": "Exchange code: NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM."
    },
    "exchangeMic": {
      "type": [
        "string",
        "null"
      ],
      "example": "XNAI",
      "description": "ISO 10383 operating Market Identifier Code for the listing exchange."
    },
    "currency": {
      "type": "string",
      "example": "KES",
      "description": "Local trading currency."
    },
    "sector": {
      "type": [
        "string",
        "null"
      ],
      "example": "Telecommunications"
    },
    "assetType": {
      "type": "string",
      "enum": [
        "STOCK",
        "ETF"
      ]
    },
    "listingStatus": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "SUSPENDED",
        "DELISTED"
      ]
    },
    "price": {
      "type": [
        "number",
        "null"
      ],
      "example": 16.5,
      "description": "Latest price in local currency."
    },
    "usdPrice": {
      "type": [
        "number",
        "null"
      ],
      "example": 0.1274,
      "description": "Latest price converted to USD at live spot rate."
    },
    "change": {
      "type": [
        "number",
        "null"
      ],
      "example": 0.25,
      "description": "Absolute price change from previous close."
    },
    "changePct": {
      "type": [
        "number",
        "null"
      ],
      "example": 1.54,
      "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/scom-ke.svg",
      "description": "Self-hosted SVG logo. Safe to use as img src."
    },
    "lastPriceUpdate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "marketStatus": {
      "type": "string",
      "description": "Exchange state at quote time: OPEN or CLOSED. Present on /market/quotes and /market/movers responses."
    },
    "bid": {
      "type": [
        "number",
        "null"
      ],
      "description": "Best bid. Currently always null (no order-book depth in the data source)."
    },
    "ask": {
      "type": [
        "number",
        "null"
      ],
      "description": "Best ask. Currently always null (no order-book depth in the data source)."
    },
    "dataFreshnessSeconds": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Seconds since the last price update. Present on /market/quotes and /market/movers responses."
    },
    "asOf": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Timestamp of the exchange observation — NOT when the API answered. African equity data is 15-minute delayed and the API refresh target is 900 seconds, so display and evaluate freshness against this value.\n"
    },
    "stale": {
      "type": "boolean",
      "description": "True when the price is older than two refresh intervals (30 minutes). The feed for this symbol is genuinely behind — do not trust the price for pricing a trade.\n"
    },
    "dataQuality": {
      "type": "object",
      "description": "The published market-data freshness contract. African equity quotes are supplied by the exchanges on a 15-minute-delayed basis, not in real time. MyStocks holds full exchange data rights. The API refresh target is 900 seconds during the published coverage window, with an end-of-day pass after market close.\n",
      "required": [
        "asOf",
        "ageSeconds",
        "stale",
        "delayMode",
        "delayMinutes",
        "refreshIntervalSeconds",
        "provider",
        "disclaimer"
      ],
      "properties": {
        "asOf": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "Timestamp of the exchange observation, not the time the API response was generated."
        },
        "ageSeconds": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Age of the price in seconds (now − asOf)."
        },
        "stale": {
          "type": "boolean",
          "description": "True when the price is older than two refresh intervals."
        },
        "delayMode": {
          "type": "string",
          "enum": [
            "DELAYED",
            "END_OF_DAY"
          ],
          "description": "DELAYED — exchange-supplied data in the 15-minute-delayed latency class. END_OF_DAY — outside the window; this is the most recent close, not a live quote.\n"
        },
        "delayMinutes": {
          "type": "integer",
          "example": 15,
          "description": "Exchange feed latency class in minutes. This is distinct from the API refresh target."
        },
        "refreshIntervalSeconds": {
          "type": "integer",
          "example": 900,
          "description": "Target interval between API ingestion refreshes during the published coverage window."
        },
        "provider": {
          "type": "string",
          "enum": [
            "mstocks",
            "mansa"
          ],
          "description": "MyStocks ingestion connector for this exchange feed. This field does not describe exchange licensing or partner entitlement."
        },
        "disclaimer": {
          "type": "string",
          "description": "Plain-English statement of what this price is and is not."
        }
      }
    }
  },
  "description": "Canonical stock/quote shape returned by /stocks, /stocks/{symbol}, /market/quotes, and /market/movers. NOTE: /market/quotes and /market/movers also emit DEPRECATED snake_case aliases (usd_price, prev_close, change_pct, asset_type, listing_status, high, low, market_status, timestamp, data_freshness_seconds, logo) for backward compatibility — these are scheduled for removal on 2026-10-01. Use the camelCase fields above.\n"
}

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

GET /market-data/exchanges

GET /market-data/ohlcv