INinvestbamboo
US Stock Trading

Place Order

This is used to place an order using results from calculate order endpoint after confirming the user is eligible to make trades.

Placing an Extended Hours Order

To specify that an order should be executed during Extended Hours, include the following field in your request payload:

"extended_hours_order": true

Set this to false to restrict the order to core market hours only.

Supported Order Types

Every stock has a status during Extended Hours that determines which order types are supported. Each stock’s status is specified in the extended_hours_status field on the <a href="#tag/US-Securities/operation/Web.Api.StockDataController.details">stock details endpoint</a>.

As a tenant, ensure your UI reflects this to prevent invalid order attempts. Also, before placing an order, you should check the stock’s current status and ensure the order type selected is permitted.

See the Stock Status section below for details.

Stock StatusPermitted Order TypesRestrictions
ActiveMarket & LimitFractional and notional orders supported
InactiveLimit onlyWhole shares only — no fractional or notional
Close OnlyLimit or Market (sell side only)No buy orders permitted

Critical Requirements

  • Use order_price from calculate-order response as your total_price when placing your order
  • Reuse fee, quantity, and price_per_share from the calculate order response
  • For LIMIT/STOP orders, include the requested execution price
post/api/order

Request

  • Base URL
    https://powered-by-bamboo-sandbox.investbamboo.com
  • Auth
    none declared. Required headers: content-type, accept-language, x-user-id, x-subject-type, x-client-token, x-request-source

Headers

content-typestring required

Advertises which content type is acceptable.

accept-languagestring required

Advertises which languages the tenant is able to understand. For example, 'en' for English Language.

x-user-idstring required

Required for user authentication

x-subject-typestring required

For user request -> 'tenant'.

x-client-tokenstring required

API Consumer Authorisation Token

x-request-sourcestring required

The tenant's username

currencystring

USD

Request body

OR
OR

Example request

{
  "fee": 150,
  "order_type": "MARKET",
  "quantity": 38.22748653,
  "total_price": 9850,
  "price_per_share": 257.668,
  "side": "BUY",
  "symbol": "AAPL"
}

Response

Order ID

order_idstring required

Order ID to fetch status by REST

Example response

{
  "order_id": "KJ.836a28cc-46ad-45d8-af25-a48812a9b7ae"
}

Changes

No recorded changes to this operation across all 1 revision of this API.