Skip to main content
With the wallet funded, place trades. Buy by share quantity or by dollar amount (notional, for fractional shares), then track the order to a fill. You need the INVESTOR_ID and a completed deposit from Fund the wallet.
Order lifecycle

​
Buy by quantity

Buy 10 shares of AAPL at market. 
curl -X POST "$BASE_URL/investors/$INVESTOR_ID/orders" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "AAPL",
    "side": "buy",
    "type": "market",
    "time_in_force": "day",
    "quantity": "10"
  }'

​
Buy by notional (fractional shares)

Invest exactly $1,000 of GOOGL — Bluum computes the fractional quantity. notional is market-only. 
curl -X POST "$BASE_URL/investors/$INVESTOR_ID/orders" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "GOOGL",
    "side": "buy",
    "type": "market",
    "time_in_force": "day",
    "notional": "1000.00"
  }'
Provide either quantity or notional, not both. Sell orders require quantity. Use quantity for limit, stop, stop_limit, and trailing_stop types.

​
Response

{
  "id": "ord_x9y8z7a6b5c4d3e2",
  "object": "order",
  "symbol": "AAPL",
  "side": "buy",
  "type": "market",
  "time_in_force": "day",
  "quantity": "10",
  "status": "pending",
  "filled_quantity": "0",
  "remaining_quantity": "10",
  "average_price": "0.00",
  "submitted_at": "2026-07-01T14:30:00Z"
}
Store the order ID: 
ORDER_ID="ord_x9y8z7a6b5c4d3e2"
Order status progresses pending → filled (or partial, cancelled, failed). On a fill, filled_quantity, average_price, and filled_at populate; a rejection sets failure_reason.

​
Get order status

curl -X GET "$BASE_URL/investors/$INVESTOR_ID/orders/$ORDER_ID" \
  -H "Authorization: Basic $AUTH"

​
Cancel an open order

Cancel an order that has not fully filled: 
curl -X POST "$BASE_URL/investors/$INVESTOR_ID/orders/$ORDER_ID/cancel" \
  -H "Authorization: Basic $AUTH"
In sandbox, market orders fill almost instantly, so there’s a narrow window to cancel. Use a limit order priced away from the market to test cancellation.
For limit, stop, trailing-stop orders, time-in-force, and pre-trade estimates, see Trading and the API reference.
Next → Track positions.