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

# Execute trade

`POST /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

Place a buy or sell trade. Requires user approval in the Yoshi web app before execution.

## Path parameters

- `accountId` string, uuid, required

## Request body

- object
  - `symbol` string, required
  - `side` 'buy' | 'sell', required
  - `quantity` number
  - `notional` number
  - `skip_approval` boolean: Skip the approval flow and execute immediately. Not supported yet — reserved for future use.

## Response `200`

Approval request created. User must approve in the Yoshi web app.

- object
  - `data` object, required
    - `action_id` string, uuid, required
    - `status` string, required
    - `thread_id` string, uuid, nullable, required
    - `approval_url` string, required
    - `approval_status_url` string, nullable, required
    - `description` string, required
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required

## Other responses

- `422`: Validation error.
- `500`: Failed to create approval request.

---

[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)
