Skip to main content
GET
/
trading
/
accounts
/
{account_id}
/
positions
List all positions for an account
curl --request GET \
  --url https://service.bluumfinance.com/v1/trading/accounts/{account_id}/positions \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "id": "727c1d92-855f-4ae1-9bc1-959179b5e57e",
    "account_id": "da0333c6-b1b5-4c5e-ae67-a51604e7059d",
    "symbol": "AAPL",
    "asset_id": "c83e6841-3621-4e9a-946f-78559cf08fe0",
    "quantity": "0.0000",
    "average_cost_basis": "270.5800",
    "total_cost_basis": "400.00",
    "current_price": "175.0000",
    "last_transaction_at": "2026-01-02T20:40:18.976Z",
    "created_at": "2026-01-02T20:40:18.977Z",
    "updated_at": "2026-01-02T20:40:18.977Z"
  },
  {
    "id": "c70a5ea5-4a73-4a87-9090-1aabf3c44f4e",
    "account_id": "da0333c6-b1b5-4c5e-ae67-a51604e7059d",
    "symbol": "MSFT",
    "asset_id": "8e3c9fce-42cf-439a-a643-83ceb64c3214",
    "quantity": "0.0000",
    "average_cost_basis": "472.1500",
    "total_cost_basis": "100.00",
    "current_price": "380.0000",
    "last_transaction_at": "2026-01-02T20:04:49.063Z",
    "created_at": "2026-01-02T20:04:49.064Z",
    "updated_at": "2026-01-02T20:04:49.064Z"
  }
]

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:

"da0333c6-b1b5-4c5e-ae67-a51604e7059d"

Response

List of positions for the account

id
string<uuid>

Unique identifier for the position.

Example:

"727c1d92-855f-4ae1-9bc1-959179b5e57e"

account_id
string<uuid>

Account ID associated with the position.

Example:

"da0333c6-b1b5-4c5e-ae67-a51604e7059d"

symbol
string

The ticker symbol of the asset.

Example:

"AAPL"

asset_id
string<uuid>

Unique identifier for the asset.

Example:

"c83e6841-3621-4e9a-946f-78559cf08fe0"

quantity
string

Current quantity of shares held in the position.

Example:

"0.0000"

average_cost_basis
string

Average cost basis per share for the position.

Example:

"270.5800"

total_cost_basis
string

Total cost basis for the position.

Example:

"400.00"

current_price
string

Current market price per share.

Example:

"175.0000"

last_transaction_at
string<date-time>

Timestamp of the last transaction affecting this position.

Example:

"2026-01-02T20:40:18.976Z"

created_at
string<date-time>

Timestamp when the position was created.

Example:

"2026-01-02T20:40:18.977Z"

updated_at
string<date-time>

Timestamp when the position was last updated.

Example:

"2026-01-02T20:40:18.977Z"