---
title: "Fetch User Stock Ownership"
method: GET
path: "/api/my_stocks"
tags: ["US Securities"]
---

# Fetch User Stock Ownership

`GET /api/my_stocks`

## Request

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

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.

## Headers

- `content-type` string, required
- `accept-language` string, required
- `x-user-id` string, required
- `x-subject-type` string, required
- `x-client-token` string, required
- `x-request-source` string, required
- `currency` string

## Response `200`

Stock pricing details

- UserStockOwnership: Details of User Stock Ownership
  - `currency_symbol` string: Currency Symbol
  - `equity_value` number: Equity value
  - `stocks` object: Click to see sample details of user stock list below
    - `name` string: High
    - `symbol` string: Stock symbol
    - `logo` string: Stock logo with a background colour
    - `quantity` number: price
    - `price` number: price
    - `avatar` string: Avatar
    - `total_return` number: Total return
    - `total_percent_change` number: Total percentage change
    - `background_color` string: Stock background color
    - `value_change` number: Price change
    - `cost_basis` string: Current market price
    - `market_price` string: Current market price
    - `percent_change` number: Total percentage change
    - `user_equity` string: User Equity
    - `market_cap` integer: market_cap
    - `pe_ratio` integer: market_cap
    - `div_yield` integer: Dividend yield
    - `eps` integer: eps
    - `volume` integer: Volume
    - `favourite` string: Favourite

## Other responses

- `401`: Token have expired or invalid token
- `404`: Resource not found
- `422`: Error response

---

[API](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api.md) - [All operations](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/revisions/063521e8d924?raw)