Skip to main content
POST
/
trading
/
accounts
/
{account_id}
/
orders
Place a new investment order
curl --request POST \
  --url https://api.bluum.finance/v1/trading/accounts/{account_id}/orders \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbol": "AAPL",
  "qty": "5",
  "side": "buy",
  "type": "limit",
  "time_in_force": "day",
  "limit_price": "175.00",
  "client_order_id": "limitorder123",
  "commission": "1.00",
  "commission_type": "notional"
}
'
{
  "id": "ord_x9y8z7a6b5c4d3e2",
  "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
  "symbol": "AAPL",
  "qty": "5",
  "side": "buy",
  "type": "limit",
  "time_in_force": "day",
  "limit_price": "175.00",
  "client_order_id": "limitorder123",
  "status": "accepted",
  "filled_qty": "0",
  "remaining_qty": "5",
  "average_price": "0.00",
  "commission": "1.00",
  "commission_type": "notional",
  "submitted_at": "2025-10-18T10:30:00Z",
  "filled_at": null,
  "canceled_at": null,
  "reject_reason": null
}

Authorizations

​
Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

​
account_id
string<uuid>
required
Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

Body

application/json
​
symbol
string
required

The ticker symbol of the asset (e.g., AAPL).

Example:

"AAPL"

​
qty
string
required

Quantity of shares to trade.

Example:

"5"

​
side
enum<string>
required

Whether to buy or sell the asset.

Available options:
buy,
sell
Example:

"buy"

​
type
enum<string>
required

Order type - market executes immediately at current price, limit sets a specific price.

Available options:
market,
limit
Example:

"limit"

​
time_in_force
enum<string>
required

How long the order remains active. 'day' expires at end of trading day, 'gtc' (Good Till Cancelled) remains active until filled or cancelled.

Available options:
day,
gtc
Example:

"day"

​
limit_price
string

Price limit for limit orders (required when type is 'limit').

Example:

"175.00"

​
client_order_id
string

Optional client-provided identifier for tracking the order.

Example:

"limitorder123"

​
commission
string

Commission amount to charge (optional).

Example:

"1.00"

​
commission_type
enum<string>

Commission calculation method:

  • notional: Charge commission on a per order basis (default)
  • qty: Charge commission on a per qty/contract basis, pro rated
  • bps: Percent commission in basis points (up to 2 decimal places)
Available options:
notional,
qty,
bps
Example:

"notional"

Response

Order accepted by the system

​
id
string<uuid>

Unique identifier for the order.

Example:

"ord_x9y8z7a6b5c4d3e2"

​
account_id
string<uuid>

Account ID associated with the order.

Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

​
symbol
string

The ticker symbol of the asset.

Example:

"AAPL"

​
qty
string

Quantity of shares ordered.

Example:

"5"

​
side
enum<string>

Whether to buy or sell the asset.

Available options:
buy,
sell
Example:

"buy"

​
type
enum<string>

Order type.

Available options:
market,
limit
Example:

"limit"

​
time_in_force
enum<string>

How long the order remains active.

Available options:
day,
gtc
Example:

"day"

​
limit_price
string

Price limit for limit orders.

Example:

"175.00"

​
client_order_id
string

Client-provided identifier for tracking the order.

Example:

"limitorder123"

​
status
enum<string>

Current status of the order.

Available options:
accepted,
filled,
partially_filled,
canceled,
rejected
Example:

"accepted"

​
filled_qty
string

Quantity of shares that have been filled.

Example:

"0"

​
remaining_qty
string

Quantity of shares remaining to be filled.

Example:

"5"

​
average_price
string

Average price at which shares have been filled.

Example:

"0.00"

​
commission
string

Commission amount charged.

Example:

"1.00"

​
commission_type
enum<string>

Commission calculation method used.

Available options:
notional,
qty,
bps
Example:

"notional"

​
submitted_at
string<date-time>

Timestamp when the order was submitted.

Example:

"2025-10-18T10:30:00Z"

​
filled_at
string<date-time> | null

Timestamp when the order was completely filled.

Example:

null

​
canceled_at
string<date-time> | null

Timestamp when the order was canceled.

Example:

null

​
reject_reason
string | null

Reason for order rejection if applicable.

Example:

null