Skip to main content
GET
/
investors
/
{investor_id}
/
positions
List positions for an investor
curl --request GET \
  --url https://api.bluumfinance.com/v1/investors/{investor_id}/positions \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "list",
  "url": "/v1/investors/inv_…/deposits",
  "has_more": false,
  "data": [
    {
      "object": "investor",
      "livemode": false,
      "id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
      "created": 1747776000,
      "metadata": {},
      "investor_id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
      "symbol": "AAPL",
      "asset_id": "<string>",
      "class": "equity",
      "country": "us",
      "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",
      "price_timestamp": "2023-11-07T05:31:56Z",
      "last_transaction_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

​
investor_id
string
required

Prefixed public id of the investor (e.g. inv_…).

Query Parameters

​
symbol
string
​
non_zero_only
boolean
default:false
​
refresh_prices
boolean
default:true

When true, fetches live prices from market-data providers. The response will include price_source, price_confidence, and price_timestamp. Adds latency; set to false to use stored values only.

Response

List of positions.

List envelope. data holds the page of items; each item is itself wrapped in a ResourceEnvelope.

​
object
enum<string>
required
Available options:
list
​
url
string
required

The endpoint path that produced this list.

Example:

"/v1/investors/inv_…/deposits"

​
has_more
boolean
required

Whether more results exist beyond data.

Example:

false

​
data
object[]
required