# 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:

```json
{
  "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.

```bash
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](/partners/docs/local-currency-trading) for FX presentation rules.