Skip to main content
GET
/
trading
/
accounts
/
{account_id}
/
orders
List orders for an account
curl --request GET \
  --url https://api.bluumfinance.com/v1/trading/accounts/{account_id}/orders \
  --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",
    "status": "filled",
    "filled_qty": "10",
    "remaining_qty": "0",
    "average_price": "175.50",
    "submitted_at": "2025-01-15T14:30:00Z",
    "filled_at": "2025-01-15T14:30:15Z",
    "canceled_at": null,
    "reject_reason": null
  },
  {
    "id": "ord_a1b2c3d4e5f6g7h8",
    "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
    "symbol": "MSFT",
    "currency": "USD",
    "qty": "5",
    "side": "buy",
    "type": "limit",
    "time_in_force": "gtc",
    "limit_price": "350.00",
    "status": "accepted",
    "filled_qty": "0",
    "remaining_qty": "5",
    "average_price": "0.00",
    "submitted_at": "2025-01-15T15:00: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"

Query Parameters

​
status
enum<string>

Filter orders by status.

Available options:
accepted,
filled,
partially_filled,
canceled,
rejected
​
symbol
string

Filter orders by symbol.

​
side
enum<string>

Filter orders by side.

Available options:
buy,
sell
​
limit
integer
default:50

Maximum number of orders to return.

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of orders to skip for pagination.

Required range: x >= 0

Response

List of orders for the account

​
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