v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-22280107.9 KB
Paper Trading

Execute trade

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

post/paper-trading/accounts/{accountId}/trades

Path parameters

accountIdstring uuid required

Request body

symbolstring required
side'buy' | 'sell' required
quantitynumber
notionalnumber
skip_approvalboolean

Skip the approval flow and execute immediately. Not supported yet — reserved for future use.

Response

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

Example response

{
  "meta": {
    "request_id": "req_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}