// the today path — manual deep-link#
1. See a signal you find interesting on /signals or in a Discord DM.
2. Read the thesis. If you can't articulate the why, skip — no exceptions.
3. Click the external-link icon on the row (or 'open on Polymarket / Kalshi ↗' on the signal detail). The venue page loads in a new tab.
4. Verify the URL bar shows polymarket.com or kalshi.com (not a lookalike). Sage's deep-link is always canonical, but verify when real money is on the line.
5. Place the order on the venue. Use the caller's max entry as your price ceiling. If the market is past that, you missed the signal — don't chase.
6. Track the position. Your venue UI is the source of truth for the trade; Sage's /signals row tracks the signal's PnL (which is informational, not your actual position).
// what the trade ticket gives you#
/trade/[signalId] (and /trade/manual) pre-fills the ticket with the signal's venue + market + side + entry price. It computes the implied number of contracts at the size you choose and shows the deep-link.
The ticket is informational today — it's a 'here's what you'd do' worksheet, not a 'submit' button. Phase 5 swaps the deep-link for a real submit when custody ships.
// size before you click#
Decide your dollar size before opening the venue. Once the order ticket is in front of you, the friction to upsize is too low. The risk-sizing doc has the discipline; the short version: quarter-Kelly of the edge, capped by your daily loss cap.
Round down, not up. A 'feels right' adjustment up is how positions creep beyond what you'd planned. The signal's max-entry is your ceiling on price; your size is your ceiling on exposure.
// settle + reconcile#
When the market resolves on the venue, your position pays out (or doesn't). Your venue UI shows the settle; the venue's wallet/account holds the proceeds.
Sage's signal-side PnL freezes at the realized bps. The leaderboard math updates within minutes. Your personal PnL track lives on /account/pnl (when execution + position sync ship).
// the phase-5 path — custodial execution#
When the custodial wallet ships, the trade-ticket gets a real submit button. You'll be able to fire a signal-driven trade from the dashboard or accept an auto-copy DM directly.
Server-side rails enforce /account/risk's caps before any order leaves. The audit row logs everything; the kill switch can pause trading for 24h with one click.
Until that ships, the deep-link flow above is the canonical path.