Skip to main content
POST
/
trading
/
accounts
/
{account_id}
/
orders
curl --request POST \
  --url https://service.bluumfinance.com/v1/trading/accounts/{account_id}/orders \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbol": "AAPL",
  "side": "buy",
  "type": "market",
  "time_in_force": "day",
  "qty": "10",
  "extended_hours": false
}
'
{
  "id": "ord_x9y8z7a6b5c4d3e2",
  "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
  "symbol": "AAPL",
  "currency": "USD",
  "qty": "10",
  "side": "buy",
  "type": "market",
  "time_in_force": "day",
  "extended_hours": false,
  "status": "accepted",
  "filled_qty": "0",
  "remaining_qty": "10",
  "average_price": "0.00",
  "submitted_at": "2025-01-15T14:30:00Z",
  "filled_at": null,
  "canceled_at": null,
  "reject_reason": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.bluumfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

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"

​
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 market price
  • limit: Sets a specific price limit
  • stop: Stop loss order that triggers at stop price
  • stop_limit: Stop order with a limit price
  • trailing_stop: Trailing stop order
Available options:
market,
limit,
stop,
stop_limit,
trailing_stop
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
  • opg: Opening - executes at market open
  • cls: Closing - executes at market close
  • ioc: Immediate or Cancel - fills immediately or cancels
  • fok: Fill or Kill - fills completely or cancels
Available options:
day,
gtc,
opg,
cls,
ioc,
fok
Example:

"day"

​
market
string

Market identifier (e.g., "NASDAQ", "NYSE"). Optional.

Example:

"NASDAQ"

​
isin
string

International Securities Identification Number. Optional.

Example:

"US0378331005"

​
figi
string

Financial Instrument Global Identifier. Optional.

Example:

"BBG000B9XRY4"

​
qty
string

Quantity of shares to trade (required if notional not provided, required for sell orders).

Example:

"5"

​
notional
string

Dollar amount to trade (required if qty not provided, only for buy market orders).

Example:

"1000.00"

​
limit_price
string

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

Example:

"175.00"

​
stop_price
string

Stop price for stop/stop_limit orders (required when type is 'stop' or 'stop_limit').

Example:

"170.00"

​
trail_percent
string

Trail percentage for trailing stop orders (required for trailing_stop if trail_price not provided).

Example:

"2.5"

​
trail_price
string

Trail price for trailing stop orders (required for trailing_stop if trail_percent not provided).

Example:

"5.00"

​
extended_hours
boolean
default:false

Whether to allow extended hours trading.

Example:

false

​
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"

​
currency
string

ISO 4217 currency code for the asset's trading currency.

Example:

"USD"

​
qty
string

Quantity of shares ordered (if quantity-based order).

Example:

"5"

​
notional
string

Notional amount ordered (if notional-based order).

Example:

"1000.00"

​
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,
stop,
stop_limit,
trailing_stop
Example:

"limit"

​
time_in_force
enum<string>

How long the order remains active.

Available options:
day,
gtc,
opg,
cls,
ioc,
fok
Example:

"day"

​
limit_price
string

Price limit for limit/stop_limit orders.

Example:

"175.00"

​
stop_price
string

Stop price for stop/stop_limit orders.

Example:

"170.00"

​
trail_percent
string

Trail percentage for trailing stop orders.

Example:

"2.5"

​
trail_price
string

Trail price for trailing stop orders.

Example:

"5.00"

​
extended_hours
boolean

Whether extended hours trading was enabled.

Example:

false

​
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