Skip to main content
GET
/
trading
/
orders
/
{order_id}
Retrieve a specific trade order
curl --request GET \
  --url https://api.bluumfinance.com/v1/trading/orders/{order_id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "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": "filled",
  "filled_qty": "10",
  "remaining_qty": "0",
  "average_price": "175.50",
  "commission": "1.00",
  "commission_type": "notional",
  "submitted_at": "2025-01-15T14:30:00Z",
  "filled_at": "2025-01-15T14:30:15Z",
  "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

​
order_id
string<uuid>
required
Example:

"ord_x9y8z7a6b5c4d3e2"

Response

Order details retrieved successfully

​
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