API product catalogPan-African Market Data & Intelligence

Get quotes — single symbol or batch (NSE, NGX, JSE, GSE, etc.)

Pan-African Market Data & Intelligence

GET

/market/quotes

Sandbox availablegetBatchQuotes

Returns delayed price quotes for one or many stock/ETF symbols. Operates in two modes: Single-symbol mode (?symbol=X&exchange=Y) Both symbol and exchange are required. Returns a single data object. Batch mode (?symbols=X,Y,Z) Comma-separated list of exchange-qualified tickers (up to 50). exchange is optional as a filter. Returns data array and a not_found array for any symbols that could not be resolved. Also available at GET /market-data/quotes (identical handler).

Parameters

symbolstringquery

Single ticker symbol — exchange-qualified (e.g. SCOM.KE) or bare. Requires exchange. Use this or symbols, not both.

Example: SCOM.KE

symbolsstringquery

Comma-separated batch of up to 50 exchange-qualified ticker symbols (e.g. SCOM.KE,GLD.ZA,BAT.KE). Use this or symbol, not both.

Example: SCOM.KE,GLD.ZA

exchangestringquery

Exchange code (NSE, NGX, JSE, GSE, BRVM, ZSE, BSE, LUSE, EGX, DSE, USE, MSE, CSE, SEM). Required in single-symbol mode; optional filter in batch mode.

Example: NSE

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

See the response format and API Reference for this endpoint.

Response codes

200Quote response. Shape varies by mode: - **Single-symbol**: `data` is a single StockSummary object. - **Batch**: `data` is an array of StockSummary objects; `not_found` lists unresolvable symbols. Both modes include a `meta` block with `request_id` and `timestamp`.

400Validation error (missing required params, invalid symbol format, batch limit exceeded).

401Unauthorized.

404Symbol not found (single-symbol mode only).

429Rate limited.

Sandbox playground

Read-only sandbox request

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

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

Open in API Tester API Reference

Response schema

{
  "oneOf": [
    {
      "title": "Single-symbol response",
      "type": "object",
      "properties": {
        "data": {
          "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"
        },
        "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"
            }
          }
        }
      }
    },
    {
      "title": "Batch response",
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "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"
          }
        },
        "not_found": {
          "type": "array",
          "description": "Symbols that could not be resolved (unknown ticker or exchange mismatch).",
          "items": {
            "type": "string"
          },
          "example": [
            "UNKNOWN.NG"
          ]
        },
        "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/quotes' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

GET /market/ohlcv

GET /market/snapshot