Skip to main content
GET
/
trading
/
accounts
/
{account_id}
/
positions
/
{position_id}
Retrieve a specific position
curl --request GET \
  --url https://api.bluumfinance.com/v1/trading/accounts/{account_id}/positions/{position_id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "pos_a1b2c3d4e5f6g7h8",
  "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
  "symbol": "AAPL",
  "asset_id": "6c5b2403-24a9-4b55-a3dd-5cb1e4b50da6",
  "currency": "USD",
  "quantity": "10.5",
  "average_cost_basis": "175.50",
  "total_cost_basis": "1842.75",
  "current_price": "180.00",
  "market_value": "1890.00",
  "unrealized_pl": "47.25",
  "unrealized_pl_percent": "2.56",
  "last_transaction_at": "2025-01-15T14:30:15Z",
  "created_at": "2025-01-10T10:00:00Z",
  "updated_at": "2025-01-15T14:30:15Z"
}

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"

​
position_id
string<uuid>
required
Example:

"pos_a1b2c3d4e5f6g7h8"

Query Parameters

​
refresh_prices
boolean
default:false

When true, fetches live price from market data providers. Response will include price_source, price_confidence, and price_timestamp fields.

Response

Position details retrieved successfully

​
id
string<uuid>

Unique identifier for the position.

Example:

"pos_a1b2c3d4e5f6g7h8"

​
account_id
string<uuid>

Account ID associated with the position.

Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

​
symbol
string

The ticker symbol of the asset.

Example:

"AAPL"

​
asset_id
string<uuid>

Asset ID.

Example:

"6c5b2403-24a9-4b55-a3dd-5cb1e4b50da6"

​
currency
string

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

Example:

"USD"

​
quantity
string

Current quantity owned (can be negative for shorts).

Example:

"10.5"

​
average_cost_basis
string

Average cost per unit.

Example:

"175.50"

​
total_cost_basis
string

Total cost basis (quantity * average_cost_basis).

Example:

"1842.75"

​
current_price
string

Current market price.

Example:

"180.00"

​
market_value
string

Current market value (quantity * current_price).

Example:

"1890.00"

​
unrealized_pl
string

Unrealized profit/loss (market_value - total_cost_basis).

Example:

"47.25"

​
unrealized_pl_percent
string

Unrealized P/L as percentage.

Example:

"2.56"

​
price_source
enum<string>

Source of the price data. Present when refresh_prices=true.

Available options:
ALPACA,
NAYA,
DATABASE,
UNAVAILABLE
Example:

"ALPACA"

​
price_confidence
enum<string>

Confidence level of the price data. Present when refresh_prices=true.

Available options:
REAL_TIME,
DELAYED,
END_OF_DAY,
STALE,
UNAVAILABLE
Example:

"REAL_TIME"

​
price_timestamp
string<date-time>

When the price was recorded by the source. Present when refresh_prices=true.

Example:

"2025-10-18T10:30:00Z"

​
last_transaction_at
string<date-time> | null

Timestamp of last transaction.

Example:

"2025-10-18T10:30:00Z"

​
created_at
string<date-time>

Timestamp when the position was created.

Example:

"2025-10-18T10:30:00Z"

​
updated_at
string<date-time>

Timestamp when the position was last updated.

Example:

"2025-10-18T10:30:00Z"