Skip to main content
GET
/
trading
/
accounts
/
{account_id}
/
orders
List orders for an account
curl --request GET \
  --url https://api.bluum.finance/v1/trading/accounts/{account_id}/orders \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "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"

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"

​
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