---
title: "List trade history"
method: GET
path: "/paper-trading/accounts/{accountId}/trades"
tags: ["Paper Trading"]
---

# List trade history

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

## Request

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

List trade history for a paper trading account with cursor-based pagination.

## Path parameters

- `accountId` string, uuid, required

## Query parameters

- `cursor` string: Opaque cursor from a previous response
- `limit` integer: Items per page (1-100, default 50)

## Response `200`

Trades retrieved.

- object
  - `data` object[], required
    - `id` string, required
    - `type` string, nullable, required
    - `subtype` string, nullable, required
    - `name` string, nullable, required
    - `symbol` string, nullable, required
    - `quantity` number, nullable, required
    - `price` number, nullable, required
    - `amount` number, nullable, required
    - `date` string, nullable, required
    - `created_at` string, nullable, required
  - `has_more` boolean, required
  - `cursor` string, nullable, required: Opaque cursor for the next page, null if no more pages
  - `count` integer, required: Number of items in the current page
  - `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)
