What African stock exchanges does the MyStocks API cover?

The Partner API covers NSE Kenya, NGX Nigeria, JSE South Africa, GSE Ghana, BRVM, ZSE Zimbabwe, BSE Botswana, LuSE Zambia, EGX Egypt, DSE Tanzania, USE Uganda, MSE Malawi, CSE Morocco and SEM Mauritius, plus platform-supported bonds, funds and private market instruments.

Can I embed African stock trading into my fintech app using an API?

Yes. Partners can create sub-accounts, fund wallets, place buy and sell orders, reconcile positions, and receive webhook events through one REST API integration.

Does the API support bonds, funds and private market opportunities?

Yes. The docs include partner endpoints for bonds, funds, ETFs, private credit, pre-IPO opportunities, subscriptions, redemptions and reporting.

How do partners handle KYC for their users?

Partners can run their own KYC and assert the verified status through the KYC endpoint before enabling investment activity for a sub-account.

Is there a sandbox environment for testing?

Yes. Sandbox API keys begin with sk_sandbox_ and provide an isolated test environment with virtual funds. Sandbox trades do not hit real markets.

Choose your API

MyStocks Partner API

Choose the right MyStocks API surface: Broker API for embedded investing infrastructure, Trading API for orders and portfolios, and Market Data API for prices, charts, companies, and market intelligence.

Integration guides Get a sandbox key

Explore endpoints

209 of 209

GET

/assets

Unified asset catalog

Full endpoint documentation

Sandbox availablelistAssets

Returns stocks, ETFs, bonds, and funds in one normalized catalog. Instruments that exist but cannot currently be transacted remain discoverable with tradable: false, a status, and capability flags. Unknown exchange order constraints are returned as null rather than inferred.

Parameters

assetClassSTOCK | ETF | BOND | FUNDquery

exchangestringquery

statusstringquery

tradablebooleanquery

searchstringquery

limitintegerquery

Example: 100

cursorstringquery

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

dataobject[]Required

data[].assetIdstringRequired

Example: "stock:SCOM.KE"

data[].sourceIdstringRequired

data[].symbolstring | null

data[].namestring | null

data[].assetClassSTOCK | ETF | BOND | FUNDRequired

data[].exchangestring | null

data[].exchangeMicstring | null

data[].currencystringRequired

data[].statusstringRequired

data[].statusReasonstring | null

data[].tradablebooleanRequired

data[].fractionablebooleanRequired

data[].shortablebooleanRequired

data[].marginablebooleanRequired

data[].minOrderSizenumber | null

data[].lotSizenumber | null

data[].tickSizenumber | null

data[].settlementCyclestring | null

data[].capabilitiesobjectRequired

data[].fractionalEligibilityobjectRequired

data[].orderRulesobjectRequired

data[].settlementunion

countintegerRequired

hasMorebooleanRequired

nextCursorstring | null

Response codes

200Normalized asset page.

Sandbox playground

Read-only sandbox request

assetClass Optional · queryexchange Optional · querystatus Optional · querytradable Optional · querysearch Optional · querylimit Optional · querycursor Optional · querySandbox API keyYour key stays in this page’s memory.

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

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "required": [
    "data",
    "count",
    "hasMore"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "assetId",
          "sourceId",
          "assetClass",
          "currency",
          "status",
          "tradable",
          "fractionable",
          "shortable",
          "marginable",
          "capabilities",
          "fractionalEligibility",
          "orderRules"
        ],
        "properties": {
          "assetId": {
            "type": "string",
            "example": "stock:SCOM.KE"
          },
          "sourceId": {
            "type": "string"
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "assetClass": {
            "type": "string",
            "enum": [
              "STOCK",
              "ETF",
              "BOND",
              "FUND"
            ]
          },
          "exchange": {
            "type": [
              "string",
              "null"
            ]
          },
          "exchangeMic": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "statusReason": {
            "type": [
              "string",
              "null"
            ]
          },
          "tradable": {
            "type": "boolean"
          },
          "fractionable": {
            "type": "boolean"
          },
          "shortable": {
            "type": "boolean",
            "const": false
          },
          "marginable": {
            "type": "boolean",
            "const": false
          },
          "minOrderSize": {
            "type": [
              "number",
              "null"
            ]
          },
          "lotSize": {
            "type": [
              "number",
              "null"
            ]
          },
          "tickSize": {
            "type": [
              "number",
              "null"
            ]
          },
          "settlementCycle": {
            "type": [
              "string",
              "null"
            ]
          },
          "capabilities": {
            "type": "object",
            "required": [
              "buy",
              "sell",
              "subscribe",
              "redeem",
              "fractional",
              "short",
              "margin"
            ],
            "properties": {
              "buy": {
                "type": "boolean"
              },
              "sell": {
                "type": "boolean"
              },
              "subscribe": {
                "type": "boolean"
              },
              "redeem": {
                "type": "boolean"
              },
              "fractional": {
                "type": "boolean"
              },
              "short": {
                "type": "boolean"
              },
              "margin": {
                "type": "boolean"
              }
            }
          },
          "fractionalEligibility": {
            "type": "object",
            "required": [
              "fractional",
              "minOrderSize",
              "quantityIncrement",
              "quantityPrecision",
              "supportedSizingModes"
            ],
            "properties": {
              "fractional": {
                "type": "boolean",
                "description": "Whether the instrument supports fractional units."
              },
              "minOrderSize": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Minimum quantity or subscription amount configured for this instrument."
              },
              "quantityIncrement": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Smallest accepted quantity step."
              },
              "quantityPrecision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 6,
                "description": "Maximum decimal places implied by quantityIncrement."
              },
              "supportedSizingModes": {
                "type": "array",
                "minItems": 1,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "enum": [
                    "QUANTITY",
                    "CASH_VALUE"
                  ]
                }
              }
            }
          },
          "orderRules": {
            "type": "object",
            "properties": {
              "minQuantity": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "minNotional": {
                "oneOf": [
                  {
                    "type": "object",
                    "required": [
                      "amount",
                      "currency"
                    ],
                    "properties": {
                      "amount": {
                        "type": "number"
                      },
                      "currency": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "quantityIncrement": {
                "type": "number"
              },
              "quantityPrecision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 6
              },
              "lotSize": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "tickSize": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          },
          "settlement": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "cycle",
                  "cycleDays"
                ],
                "properties": {
                  "cycle": {
                    "type": "string"
                  },
                  "cycleDays": {
                    "type": "integer"
                  }
                }
              },
              {
                "type": "null"
              }
            ]
          }
        }
      }
    },
    "count": {
      "type": "integer"
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}

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

MyStocks Partner API

Build investing products for African markets.

One API for customer accounts, trading, portfolios, delayed market data, reporting, and production operations across 12 publicly approved exchanges.

Make your first request Explore the API

12 exchangesSandbox simulated executionOpenAPI 3.1 contract

First market request200 OK

curl 'https://mystocks.africa/api/sandbox/v1/partner/stocks?search=SCOM.KE&limit=1' \
  -H "Authorization: Bearer $KEY"

Choose a path

Start with what you are building

Browse implementation recipes

01Broker API

Create customer accounts, manage wallets, assert KYC, reconcile cash, and operate the embedded product.

02Trading API

Request quotes and place, supervise, cancel, and reconcile customer or master-account orders.

03Market Data API

Build discovery, company, quote, chart, movers, market-status, and intelligence experiences.

Start in the sandbox

Sign in to the sandbox console, create an API key, and choose an integration guide. The sandbox uses virtual funds so you can test before requesting production access.

Choose where to run

Use the hosted API from your own application, install the partner interface on your infrastructure, or use both. Read Deployment options to compare these choices, then use the Partner workspace to manage access and credentials. Production access and on-prem installation licenses have separate approval and credential steps.

Looking for a specific capability? Open the Partner capability index for direct links to batch quotes, order replacement, market calendars, KYC webhooks, portfolio performance, fractional eligibility, and deterministic sandbox scenarios.

September 2026 Partner API specification

Explore the eight API products, with all 203 operations across 156 route paths, request and response contracts, and integration guides. Read the specification companion for current integration guidance, or download the complete PartnerAPI.pdf.

Shared foundations

Authentication

API keys, data keys, OAuth client credentials, Firebase-token endpoints, and idempotency rules.

API Reference

Explore the OpenAPI reference, generated schemas, request examples, and response shapes.

API Tester

Run live sandbox and production requests from the browser using your partner API key.

Capability Index

Find production endpoints, webhook events, sandbox scenarios, and eligibility fields by workflow.

New here? Read About MyStocks, then choose a Broker API, Trading API, or Market Data API getting-started path.

Sandbox

The sandbox mirrors production response shapes and starts every partner account with $100,000 USD in virtual funds. Eligible market orders use accelerated simulated settlement in Sandbox; limit orders can remain open and deterministic scenarios include partial fills and settlement failures. See Sandbox execution to test the supported embedded-investing flow without financial risk.

Available markets

Public coverage is approved for 12 exchanges: NSE, NGX, JSE, GSE, BRVM, BSE, LuSE, EGX, DSE, USE, CSE and SEM. Directory and calendar responses may include other configured markets; that does not confer trading entitlement. Sandbox instrument eligibility, available prices and FX still apply. Use GET /stocks to discover exact symbols, then inspect eligibility before trading. Prices use the delayed production catalogue.

Symbol	Name	Exchange	Currency
`SCOM.KE`	Safaricom PLC	NSE	KES
`EQTY.KE`	Equity Group Holdings	NSE	KES
`DANGCEM.NG`	Dangote Cement	NGX	NGN
`ZENITH.NG`	Zenith Bank	NGX	NGN
`MTN.ZA`	MTN Group	JSE	ZAR
`GCB.GH`	GCB Bank	GSE	GHS
`SNTS.CI`	Sonatel	BRVM	XOF
`ZANACO.ZM`	Zambia National Commercial Bank	LUSE	ZMW

This is a sample. Hundreds more stocks are available through GET /stocks.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Send note

Last updated on

Partner API Products