Skip to content
Partner API Docs

Local-Currency Trading

Understand how partner-supplied funding FX, MyStocks execution FX, local-market prices, and USD wallets work together.

MyStocks presents a USD-denominated wallet while instruments trade in their exchange currency. The FX responsibility depends on the flow.

FlowFX responsibilityAPI behavior
DepositPartnerSend the USD amount, local amount, local currency, and applied rate for audit.
Quote and tradeMyStocksQuote and execution use the live market conversion at the relevant point in the order flow.
DividendMyStocksDeclared local-currency dividends are converted and credited to the USD wallet.
WithdrawalPartnerMyStocks debits USD; your payout rail handles local-currency delivery.

Implementation rules

  • Preserve localAmount, localCurrency, and fxRate exactly as submitted for deposits.
  • Show the quote currency and wallet currency separately in your UI.
  • Never calculate a trade’s final USD debit from a stale display price.
  • Treat FX rate, timestamp, spread, and rounding as customer-disclosure data.
  • Reconcile local-market fills and USD ledger movements together.

See the detailed FX & Currency model, Trading API, and Statements and Confirms.

Wallet balances are USD ledger balances. MyStocks does not provide an end-user FX hedge. Your product must disclose exchange-rate movement between funding, execution, dividend conversion, and withdrawal.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Last updated on

On this page