Fractional Trading

Use cash-value sizing for fractional investing while preserving quote binding, precision, fees, and market eligibility rules.

Fractional investing uses cashValue instead of share quantity. It is supported only where the instrument and market are fractional-enabled.

Do not infer eligibility from an exchange name. Call GET /assets and inspect each instrument's fractionalEligibility object:

{
  "assetId": "stock:SCOM.KE",
  "fractionalEligibility": {
    "fractional": true,
    "minOrderSize": null,
    "quantityIncrement": 0.000001,
    "quantityPrecision": 6,
    "supportedSizingModes": ["QUANTITY", "CASH_VALUE"]
  }
}

fractional is the authoritative yes/no decision for fractional units.
minOrderSize is the minimum quantity or minimum subscription amount published for the instrument; null means no additional instrument-specific minimum is configured.
quantityIncrement is the smallest accepted quantity step.
quantityPrecision is the maximum decimal precision implied by that step.
supportedSizingModes tells you whether to send QUANTITY, CASH_VALUE, or either.

curl 'https://mystocks.africa/api/v1/partner/quote/SCOM.KE?type=BUY&cashValue=25&subAccountId=usr_abc123' \
  -H 'Authorization: Bearer pk_live_<key>'

Pass the same cashValue and returned quoteId to the subsequent trade. Never send both quantity and cashValue; the API rejects mixed sizing modes. Whole-share markets require positive integer quantities.

The API may return fractional quantities at execution precision. Display local-market price, USD wallet impact, fee, and estimated quantity separately. See Local-Currency Trading for FX presentation rules.