Portfolio — Positions, P&L, Alerts, and Guards

Track live Polymarket positions, review price charts, manage price alerts and position guards, and export your full trade history.

The Portfolio page at /portfolio is your risk management center. Connect your wallet to see live positions pulled directly from Polymarket, track unrealized P&L, set price alerts, configure automated stop-loss and take-profit guards, and review your complete trade history — both paper and live.

Trade history, price alerts, and position guards are all stored in your browser’s local storage. They persist across sessions but are specific to the device and browser you’re using. Nothing is synced to a server.

Connecting your wallet

A wallet connection is required to view live positions and unrealized P&L. Without a wallet, you can still access your paper trade history, price alerts, and position guards.

Once connected, Kuroko fetches your open positions from Polymarket’s Gamma API and displays them in the positions panel. Positions update when you refresh the page.

Summary

The top of the page shows three headline numbers:

• Total value — combined value of all open positions at current probabilities
• Unrealized P&L — paper gain or loss across all open positions
• Position count — number of open markets you hold

Price chart

Click any position in the positions panel to load a price chart for that market. The chart is powered by lightweight-charts and pulls historical price data from Polymarket’s CLOB API so you can see how the probability has moved over time.

Price alerts

Price alerts notify you when a market crosses a probability threshold you set.

1. Create an alert

   Click New Alert in the Alerts panel, or ask the AI: “Set an alert when [market] hits 70%.” Select the market, choose above or below, and enter your threshold.

2. Enable browser notifications

   The first time an alert fires, your browser will ask for notification permission. Grant it to receive alerts even when Kuroko is in a background tab.

3. Alerts run automatically

   Kuroko checks all active alerts every 60 seconds against live market data. When a threshold is crossed, you receive a browser notification immediately.

You can also set alerts directly from any market card on the Markets page — the alert is created without navigating away.

Position guards

Position guards are automated stop-loss and take-profit rules. Set the thresholds once and Kuroko monitors your positions every 60 seconds.

1. Create a guard

   Click New Guard in the Guards panel, or ask the AI: “Set a stop-loss at 30% on my position.” Select the market, enter your stop-loss and/or take-profit probability levels, and save.

2. What happens when a guard triggers

   The guard evaluates against the current market probability. When your threshold is crossed, the action depends on your wallet status:

   • Wallet connected — attempts a live exit order through your connected wallet to Polymarket’s order book
   • No wallet — records a paper trade exit and fires a browser notification

   Guards deactivate after triggering to prevent repeated execution on the same threshold.

Default thresholds are calculated from your entry price: take-profit is set to entry + 10pp (capped at 99%), and stop-loss to entry − 10pp (floored at 1%).

Guards watch your positions 24/7 as long as the Kuroko tab is open in your browser. For continuous protection, keep the Portfolio page open or pinned.

Trade history

The Trade History panel shows every paper and live trade you’ve made in Kuroko, up to the last 200 records.

Each row shows:

• Market question
• Side (YES / NO)
• Shares and entry price
• Total cost
• Outcome (if the market has resolved)
• Realized P&L

Aggregate stats at the top of the panel summarize your overall performance:

• Total trades
• Total capital deployed
• Realized P&L
• Win rate
• Average return per trade

Click Export CSV to download your full trade history as a spreadsheet.

Layout

Screen	Layout
Desktop	3 columns: positions summary + chart, alerts + guards
Mobile	5 tabs: Portfolio, Chart, Alerts, Guards, History