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

# Execute trade

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

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.net/yoshi-ai-dev/apis/yoshi-api.md) · [All operations](https://skmtc.net/yoshi-ai-dev/apis/yoshi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yoshi-ai-dev/yoshi-api/revisions/79b8247d58a2/schema)