Preview asset buy or sell
Get a preview of a single asset buy or sell transaction showing execution options, fees, and estimated orders
Authorizations
Auth0-issued access token that includes the scopes listed for the endpoint.
Headers
User identifier for the M2M client to specify which user's data to access.
^[a-f0-9]{24}$Body
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
Asset preview request. orderType defaults to Market when omitted. Limit orders are always
express (no smart/aggregate leg). Buy orders specify either amount or quantity, never both.
- Market amount-buy —
side: buy,amountrequired;orderTypeomitted orMarket;limitPriceis not allowed. - Market quantity-buy —
side: buy,quantityrequired; same market rules as amount-buy. - Market sell —
side: sell,quantityrequired; same market rules as buy. - Limit amount-buy —
side: buy,orderType: Limit,amount, andlimitPricerequired. - Limit quantity-buy —
side: buy,orderType: Limit,quantity, andlimitPricerequired. - Limit sell —
side: sell,orderType: Limit,quantity, andlimitPricerequired.
buy ISIN of the asset to trade
^[A-Z]{2}[A-Z0-9]{9}[0-9]$Required for amount-based buy orders. Whole-currency amount to invest.
x >= 0.01Order type. Omit to default to market.
Market Response
Asset transaction preview retrieved successfully
Preview of a transaction showing execution options, fees, and estimated orders
Execution window for both express and smart execution scenarios
Wealthyhood fee breakdown for express vs smart execution (commission and FX only on preview)
Partner (ETE/NBG) countervalue fees per execution mode; omitted for retail Wealthyhood users.
Orders preview for both express and smart execution scenarios
Total cash a quantity-based buy will hold (estimated notional + slippage buffer + estimated fees). Uses the smart hold when both execution legs are offered. Omitted for amount-based buys and sells.
Foreign currency exchange rates keyed by ISIN
Whether orders will be skipped due to low amounts
Whether the transaction will result in a low quantity holding
Whether the transaction includes ETF orders