API product catalogPan-African Market Data & Intelligence

Market snapshot (quote + daily bar + previous daily bar + intraday sample)

Pan-African Market Data & Intelligence

GET

/market/snapshot

Sandbox availablegetMarketSnapshot

Returns a one-call bundle for one or many symbols: the delayed quote (same shape as /market/quotes, carrying asOf, stale, and dataQuality), today's dailyBar, the prevDailyBar, and the latest coarse intradayBar sample. Replaces the 3–4 round-trips a dashboard would otherwise make. Single mode requires both symbol and exchange; batch mode takes symbols (comma-separated, ≤50), returning a map of symbol → snapshot plus not_found. dailyBar is derived from the latest 15-minute-delayed observation until the end-of-day pass writes today's candle. intradayBar is null until the 3×/day intraday capture has run for the symbol.

Parameters

symbolstringquery

Single-symbol mode. Use together with exchange.

Example: SCOM.KE

exchangestringquery

Exchange code (required in single-symbol mode).

Example: NSE

symbolsstringquery

Batch mode. Comma-separated exchange-qualified tickers (max 50), e.g. SCOM.KE,MTN.ZA.

Example: SCOM.KE,MTN.ZA

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

dataunion

Single mode: one Snapshot object. Batch mode: a map of symbol → Snapshot.

not_foundstring[]

Batch mode only — requested symbols that could not be resolved.

metaobject

Standard response metadata included on every market-data envelope.

meta.request_idstring

Unique identifier for this request. Include in support tickets for tracing.

Example: "4f6e1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b"

meta.timestampstring

ISO 8601 UTC timestamp of when the response was generated.

Example: "2026-06-04T10:23:45.123Z"

meta.exchangestring | null

Exchange code the request was scoped to, when applicable.

Example: "NSE"

meta.symbolstring | null

Ticker symbol the request was scoped to, when applicable.

Example: "SCOM.KE"

Response codes

200Snapshot bundle. Single mode returns one snapshot under `data`; batch mode returns a symbol→snapshot map.

400Validation error (missing params, invalid symbol, batch > 50).

401Unauthorized.

404Single-symbol mode — symbol not found on the specified exchange.

Sandbox playground

Read-only sandbox request

symbol Optional · queryexchange Optional · querysymbols Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/market/snapshot

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "data": {
      "description": "Single mode: one Snapshot object. Batch mode: a map of symbol → Snapshot.\n",
      "oneOf": [
        {
          "type": "object",
          "description": "A one-call market bundle for a symbol.",
          "properties": {
            "symbol": {
              "type": "string",
              "example": "SCOM.KE"
            },
            "quote": {
              "allOf": [
                {
                  "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": {
                      "$ref": "#/components/schemas/QuoteDataQuality"
                    }
                  },
                  "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"
                }
              ],
              "description": "The delayed quote, carrying asOf, stale, and dataQuality."
            },
            "dailyBar": {
              "oneOf": [
                {
                  "type": "object",
                  "description": "A single OHLCV candle. Shared by /market/ohlcv and /market/snapshot.",
                  "properties": {
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "ISO 8601 start timestamp for the candle period.",
                      "example": "2026-07-15T00:00:00.000Z"
                    },
                    "open": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Open price (local currency)."
                    },
                    "high": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "High price (local currency)."
                    },
                    "low": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Low price (local currency)."
                    },
                    "close": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Close price (local currency).",
                      "example": 35.5
                    },
                    "volume": {
                      "type": "integer",
                      "description": "Trading volume for the period. 0 if not recorded.",
                      "example": 45394
                    },
                    "phase": {
                      "type": "string",
                      "description": "Session/intraday bars only — which of the 3 daily samples this is (`open`, `mid`, or `close`). Absent on daily (`1D`) bars.\n",
                      "enum": [
                        "open",
                        "mid",
                        "close"
                      ]
                    }
                  }
                },
                {
                  "type": "null"
                }
              ],
              "description": "Today's daily bar (derived from the latest 15-minute-delayed observation until the EOD candle is written)."
            },
            "prevDailyBar": {
              "oneOf": [
                {
                  "type": "object",
                  "description": "A single OHLCV candle. Shared by /market/ohlcv and /market/snapshot.",
                  "properties": {
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "ISO 8601 start timestamp for the candle period.",
                      "example": "2026-07-15T00:00:00.000Z"
                    },
                    "open": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Open price (local currency)."
                    },
                    "high": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "High price (local currency)."
                    },
                    "low": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Low price (local currency)."
                    },
                    "close": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Close price (local currency).",
                      "example": 35.5
                    },
                    "volume": {
                      "type": "integer",
                      "description": "Trading volume for the period. 0 if not recorded.",
                      "example": 45394
                    },
                    "phase": {
                      "type": "string",
                      "description": "Session/intraday bars only — which of the 3 daily samples this is (`open`, `mid`, or `close`). Absent on daily (`1D`) bars.\n",
                      "enum": [
                        "open",
                        "mid",
                        "close"
                      ]
                    }
                  }
                },
                {
                  "type": "null"
                }
              ],
              "description": "The previous trading day's daily bar."
            },
            "intradayBar": {
              "oneOf": [
                {
                  "type": "object",
                  "description": "A single OHLCV candle. Shared by /market/ohlcv and /market/snapshot.",
                  "properties": {
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "ISO 8601 start timestamp for the candle period.",
                      "example": "2026-07-15T00:00:00.000Z"
                    },
                    "open": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Open price (local currency)."
                    },
                    "high": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "High price (local currency)."
                    },
                    "low": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Low price (local currency)."
                    },
                    "close": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Close price (local currency).",
                      "example": 35.5
                    },
                    "volume": {
                      "type": "integer",
                      "description": "Trading volume for the period. 0 if not recorded.",
                      "example": 45394
                    },
                    "phase": {
                      "type": "string",
                      "description": "Session/intraday bars only — which of the 3 daily samples this is (`open`, `mid`, or `close`). Absent on daily (`1D`) bars.\n",
                      "enum": [
                        "open",
                        "mid",
                        "close"
                      ]
                    }
                  }
                },
                {
                  "type": "null"
                }
              ],
              "description": "The latest coarse intraday sample (open/mid/close). null until capture has run."
            }
          }
        },
        {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/Snapshot"
          }
        }
      ]
    },
    "not_found": {
      "type": "array",
      "description": "Batch mode only — requested symbols that could not be resolved.",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "description": "Standard response metadata included on every market-data envelope.",
      "properties": {
        "request_id": {
          "type": "string",
          "format": "uuid",
          "description": "Unique identifier for this request. Include in support tickets for tracing.",
          "example": "4f6e1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b"
        },
        "timestamp": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 UTC timestamp of when the response was generated.",
          "example": "2026-06-04T10:23:45.123Z"
        },
        "exchange": {
          "type": [
            "string",
            "null"
          ],
          "description": "Exchange code the request was scoped to, when applicable.",
          "example": "NSE"
        },
        "symbol": {
          "type": [
            "string",
            "null"
          ],
          "description": "Ticker symbol the request was scoped to, when applicable.",
          "example": "SCOM.KE"
        }
      }
    }
  }
}

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

GET /market/quotes

GET /price-alerts