Paper trading: simulate trades with virtual portfolios

import Yoshi from "@yoshi-ai/sdk";

const yoshi = new Yoshi();

const result = await yoshi.paperTrading.accounts.create({
  name: "Tech Portfolio",
  starting_cash_balance: "50000", // $50,000
});

console.log("Action ID:", result.action_id);
console.log("Status:", result.status);
console.log("Approve at:", result.approval_url);

from yoshi import Yoshi

yoshi = Yoshi()

result = yoshi.paper_trading.accounts.create(
    name="Tech Portfolio",
    starting_cash_balance="50000",
)

print(f"Action ID: {result.action_id}")
print(f"Status: {result.status}")
print(f"Approve at: {result.approval_url}")

curl -X POST https://api.yoshi.ai/paper-trading/accounts \
  -H "Authorization: Bearer yoshi_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Tech Portfolio", "starting_cash_balance": "50000"}'

// Buy 10 shares of AAPL
const trade = await yoshi.paperTrading.accounts.trades.create("acc_paper123", {
  symbol: "AAPL",
  side: "buy",
  quantity: 10,
});

// Or buy $5,000 worth of AAPL
const notionalTrade = await yoshi.paperTrading.accounts.trades.create(
  "acc_paper123",
  {
    symbol: "AAPL",
    side: "buy",
    notional: 5000,
  },
);

console.log("Approve trade:", trade.approval_url);

# Buy 10 shares of AAPL
trade = yoshi.paper_trading.accounts.trades.create(
    "acc_paper123",
    symbol="AAPL",
    side="buy",
    quantity=10,
)

# Or buy $5,000 worth of AAPL
notional_trade = yoshi.paper_trading.accounts.trades.create(
    "acc_paper123",
    symbol="AAPL",
    side="buy",
    notional=5000,
)

print(f"Approve trade: {trade.approval_url}")

const status = await yoshi.approvals.retrieve("thread_abc123");

console.log("Status:", status.status); // "pending", "approved", "rejected", "executed"

status = yoshi.approvals.retrieve("thread_abc123")

print(f"Status: {status.status}")

// Current holdings
const holdings = await yoshi.paperTrading.accounts.holdings.list("acc_paper123");

for (const h of holdings.holdings) {
  console.log(`${h.symbol}: ${h.quantity} shares @ $${h.institution_price}`);
}

// Trade history
for await (const trade of yoshi.paperTrading.accounts.trades.list("acc_paper123")) {
  console.log(`${trade.type} ${trade.symbol}: ${trade.quantity} @ $${trade.price}`);
}

# Current holdings
holdings = yoshi.paper_trading.accounts.holdings.list("acc_paper123")

for h in holdings.holdings:
    print(f"{h.symbol}: {h.quantity} shares @ ${h.institution_price}")

# Trade history
for trade in yoshi.paper_trading.accounts.trades.list("acc_paper123"):
    print(f"{trade.type} {trade.symbol}: {trade.quantity} @ ${trade.price}")