---
title: "Get holdings"
method: GET
path: "/paper-trading/accounts/{accountId}/holdings"
tags: ["Paper Trading"]
---

# Get holdings

`GET /paper-trading/accounts/{accountId}/holdings`

## Request

- Base URL: `https://api.yoshi.ai/v1`
- URL: `https://api.yoshi.ai/v1/paper-trading/accounts/{accountId}/holdings`
- Auth: HTTP bearer

Get current holdings/positions for a paper trading account.

## Path parameters

- `accountId` string, uuid, required

## Response `200`

Holdings retrieved.

- object
  - `data` object, required
    - `holdings` object[], required
      - `id` string, required
      - `security_id` string, required
      - `symbol` string, nullable, required
      - `name` string, nullable, required
      - `security_type` string, nullable, required
      - `quantity` number, required
      - `cost_basis` number, nullable, required
      - `institution_price` number, nullable, required
      - `institution_value` number, nullable, required
      - `as_of` string, nullable, required
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required

## Other responses

- `404`: Account not found.

---

[API](https://skmtc.dev/yoshi-ai-dev/apis/yoshi-api.md) - [All operations](https://skmtc.dev/yoshi-ai-dev/apis/yoshi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yoshi-ai-dev/apis/yoshi-api/revisions/79b8247d58a2?raw)
