Skip to content
Partner API Docs

FX & Currency

MyStocks' split-responsibility FX model — partners own the foreign-exchange relationship with end-users on deposits and withdrawals; MyStocks applies the live spot rate at equity execution and dividend conversion. All wallets are USD.

MyStocks operates a split-responsibility FX model. You own the foreign-exchange relationship with your end-users; MyStocks handles FX only at the point of equity execution.

FlowWho handles FX?What you provideWhat MyStocks does
Funding (deposit)Partneramount + localAmount + fxRateRecords for audit trail; credits USD wallet
Equity tradingMyStocksApplies live spot rate at execution; settles in local market currency
DividendsMyStocksConverts declared dividend to USD at spot; credits sub-account wallet
WithdrawalPartneramount + fxRate appliedDebits USD wallet; partner pays user in local currency

Deposit — partner-handled FX

Your user pays KES 655,000 via M-Pesa. You apply your exchange rate (1 USD = 1,310 KES) and report the USD equivalent to MyStocks. MyStocks credits the sub-account wallet with $500 USD and stores the fxRate for audit purposes.

// Deposit request body
{
  "amount":        500,
  "localAmount":   655000,
  "localCurrency": "KES",
  "fxRate":        1310,       // KES per USD — your applied rate
  "note":          "mpesa_QHJ29SK"
}

Trading — MyStocks-handled FX

When a BUY order executes on the NSE, MyStocks converts the USD amount to KES at the live interbank spot rate at the moment of execution. The fillPrice in the order response is always expressed in the stock's native currency (e.g. KES for NSE). MyStocks debits the sub-account USD wallet using the spot rate applied.

FX risk. Sub-account wallets are denominated in USD. Exchange-rate movements between deposit and trade execution are borne by the end-user. MyStocks does not offer hedging — ensure your product disclosures reflect this.

On this page