Skip to main content
POST
/
paper-trading
/
accounts
/
{accountId}
/
trades
cURL
curl --request POST \
  --url https://api.yoshi.ai/v1/paper-trading/accounts/{accountId}/trades \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbol": "<string>"
}
'
{
  "data": {
    "action_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "action_type": "<string>",
    "status": "<string>",
    "thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "approval_url": "<string>",
    "approval_status_url": "<string>",
    "description": "<string>",
    "display_error_message": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "decided_at": "<string>",
    "executed_at": "<string>",
    "expires_at": "<string>",
    "decision_needs": {
      "approval": true,
      "passkey": true,
      "identity_verification": true,
      "client_execution": true
    },
    "details_v1": {
      "kind": "paper_trade",
      "account": {
        "id": "<string>",
        "source_label": "<string>",
        "display_name": "<string>",
        "subtitle": "<string>",
        "institution_name": "<string>",
        "icon_url": "<string>",
        "available_amount_display": "<string>",
        "available_amount_label": "<string>"
      },
      "symbol": "<string>",
      "security_name": "<string>",
      "side_label": "<string>",
      "quantity": "<string>",
      "quantity_display": "<string>",
      "amount_label": "<string>",
      "current_price_display": "<string>",
      "price_change_display": "<string>",
      "quote_as_of": "2023-11-07T05:31:56Z",
      "quote_as_of_label": "<string>",
      "estimated_cost_display": "<string>",
      "order_type_display": "<string>",
      "proposed_by_label": "<string>",
      "top_markdown": "<string>",
      "bottom_markdown": "<string>",
      "reason_markdown": "<string>",
      "timing_disclosure": "<string>",
      "money_movement_disclosure": "<string>",
      "primary_action_label": "<string>",
      "secondary_action_label": "<string>"
    }
  },
  "meta": {
    "request_id": "req_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
default:yoshi_test_...
required

A Yoshi API key from Settings → API Keys, or a Yoshi OAuth access token issued by Sign in with Yoshi.

Path Parameters

​
accountId
string<uuid>
required

Body

application/json
​
symbol
string
required
Required string length: 1 - 10
​
side
enum<string>
required
Available options:
buy,
sell
​
quantity
number
​
notional
number
​
skip_approval
boolean
default:false

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.

​
data
object
required
​
meta
object
required
Last modified on June 18, 2026