Fetch User Stock Ownership

This endpoint is used to get the list of stocks a user owns, providing a complete view of their current investment positions.

User portfolio stocks include:

Owned positions: showing all stocks currently held by the user
Position details: with share quantities, current values, and performance metrics
Equity breakdown: showing individual stock contributions to total portfolio
Multi-currency support: displaying local currency values with exchange rates

This endpoint supports portfolio management by tracking all user investments in one view, calculating portfolio diversity and concentration, monitoring individual position performance, and supporting portfolio rebalancing decisions.

get/api/my_stocks

Request

Base URL
https://powered-by-bamboo-sandbox.investbamboo.com
Auth
none declared. Required headers: content-type, accept-language, x-user-id, x-subject-type, x-client-token, x-request-source

Headers

content-typestring required

Acceptable content type

accept-languagestring required

Acceptable language; 'en' for English

x-user-idstring required

Required for user authentication

x-subject-typestring required

For user request -> 'tenant'.

x-client-tokenstring required

API consumer token

x-request-sourcestring required

The tenant's username

currencystring

NGN - to order in Naira

Response

Stock pricing details

currency_symbolstring

Currency Symbol

equity_valuenumber

Equity value

Example response

{
  "currency_symbol": "$",
  "equity_value": 2267.91,
  "stocks": {
    "name": "Apple, Inc.",
    "symbol": "AAPL",
    "logo": "https://d3an3cesqmrf1x.cloudfront.net/images/symbols/mdy.png",
    "total_return": 226.94,
    "total_percent_change": 34.45,
    "background_color": "ff9201",
    "value_change": 16.51,
    "percent_change": 34.45,
    "market_cap": 2081325483000,
    "pe_ratio": 2081325483000,
    "volume": 208132548
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.