Skip to main content
Trading lets your users buy and sell securities. You submit an order, Bluum routes it to the right exchange through its custodian network, and you track status as it executes. Orders are created against an investor and carry a prefixed ord_ id.

​
Order types

TypeDescriptionRequires
marketExecutes immediately at the current pricequantity or notional
limitExecutes only at the limit price or betterquantity, limit_price
stopTriggers a market order when price hits the stopquantity, stop_price
stop_limitTriggers a limit order when price hits the stopquantity, stop_price, limit_price
trailing_stopStop that trails the market by an offsetquantity, trail_price or trail_percent

​
Sizing: quantity vs notional

  • quantity — number of shares (e.g. "10"). The field is quantity, not qty.
  • notional — a cash amount to invest (e.g. "1000.00"), market orders only.
Notional orders buy fractional shares when the amount doesn’t divide evenly. Sell orders must use quantity.

​
Time in force

ValueMeaning
dayValid for the current session; canceled at close if unfilled
gtcGood ‘til canceled
opgAt the opening auction
clsAt the closing auction
iocImmediate or cancel — fill what’s available now, cancel the rest
fokFill or kill — fill entirely at once or cancel

​
Wallet currency

Pass wallet_currency (USD, NGN, GBP, EUR, KES) to settle the trade from a specific wallet. When omitted it defaults to USD.

​
Order lifecycle

Order lifecycle
StatusMeaning
openResting at the custodian, awaiting execution
pendingAccepted and queued
partialSome shares filled, remainder active
filledFully executed
cancelledCanceled by user or system
failedRejected (insufficient funds, invalid symbol, market closed)
Track fills with filled_quantity, remaining_quantity, average_price, and the submitted_at / filled_at / cancelled_at timestamps. Fetch a single order at /v1/investors/{investor_id}/orders/{order_id}.
For placing, estimating, and canceling orders step by step, see the journey guide: Place orders. Order schemas are in the API reference.