Bring live markets and Wiz into your AI chat.

Fetch the authenticated TradingWizard user's plan tier, credit balance and daily-API usage. Use this to check whether a feature is gated before calling other tools.

Check the agent budget: remaining credits, plan, and how many of today's API requests are left before the daily rate limit. Call this to self-monitor before running a batch of tools.

The durable facts Wiz has learned about the signed-in user in their ACTIVE workspace (trading style, risk appetite, focus markets, decisions, lessons). Use to personalise answers or for 'what does Wiz remember about me'. Read-only and scoped to the user's own workspace.

List the user's personal trading bots. Optional `symbol` filter (e.g. "BTC" or "BTCUSDT") narrows to one symbol. Returns bot status, current bias/score, recent P&L, win-rate and last/next scan timestamps.

The bot's merged activity timeline, newest first — the engine stream a human sees on the bot page: scan receipts (state, plain-language reason, plus verdict + trade-likelihood when present), life events (deploy, config_change and other lifecycle steps with their plain-language reason), and trade opens/closes (side, entry/exit, and realized pnlPercent on closes). `limit` caps rows (default 20, max 50); the web app has the full paginated view. Access mirrors the bot page: a private bot is visible only to its owner; a global fleet bot is public. A feature_run is private to the user who ran it and the bot owner. Setup levels (entry/stop/target/rrr and the level-bearing reasons) are included only for the owner, Pro+ callers, or fleet admins — stripped otherwise.

Read the current public, paper-mode Bot One snapshot: market, timeframe, latest view and reason, level-free paper-position summary, and tracked paper results.

The strategy lenses a bot can run — the six modules (Wiz plus five named technical lenses: Elliott Wave, Fibonacci, Cycle, MACD, MA Cross) with a plain-language description, the inputs each leans on, and the module it degrades to. Each carries an HONEST track record from real closed trades: status is 'proven' (with avgPnlPct + tradeCount), 'new' (no number yet — the lens hasn't earned one), or 'unproven' (a thin outlier we won't advertise). A lens changes what the analyst WEIGHS, never the odds — there is no fabricated per-strategy P&L. Pass a strategy id into deploy_bot or edit_bot to run a bot on that lens.

Deploy a new autonomous trading bot for a symbol. ⚠️ PAID: deploying kicks off an AI scan (consumes Gemini compute + 1 credit; the first bot is free on Free plan). Ultimate-only via the agent API. Respects plan bot-limits. Paper mode by default. timeframe/risk default to the user's settings. strategyId selects the analysis lens (default Wiz — call get_strategies for ids); language sets the bot's output language.

Control a bot by id: pause, resume, delete, or scan. pause/resume/delete are free; delete closes any open positions and restores follower balances. scan queues an immediate re-scan (⚠️ PAID Gemini compute) and is Ultimate-only + rate-limited — it runs on the next cron tick, not inline.

Edit a personal bot's BEHAVIOUR config in place. `botId` is required; pass ONLY the fields you want to change (each optional). strategyId — a lens id from get_strategies (wiz | elliott | fibonacci | cycle | macd | macross) or an alias (breakout | meanreversion | vwap, which resolve). riskLevel — Low | Medium | High. timeframe — 1m, 5m, 15m, 30m, 1H, 2H, 4H, 1D, 1W. thinkingEffort — auto | low | medium | high. language — auto, en, sv, de, es, fr, nl, zh, hi. customPrompt — free-text strategy instructions (≤500 chars; empty string clears them). tradeSizing — small | standard | large: the paper trade-size band (small ≈ half, large ≈ double the standard position size), applied from the next trade. Every REAL change writes a permanent config_change event to the bot's timeline (see get_bot_timeline) and takes effect from the bot's next scan; a no-op save changes nothing. A bot's symbol/market/asset are FIXED — deploy a new bot for a different market. Owner-only; timeframe can't change while a trade is open. Returns the fields that changed plus the reloaded bot.

The caller's PENDING confirm-mode trade proposals — own only, freshest first. A bot in 'Ask me first' mode (executionMode: confirm) writes a proposal on an ENTER verdict INSTEAD of opening the trade; this is your decide queue. Each row carries the proposal id (pass to approve_trade / decline_trade), the bot + symbol + side, the staked setup (entry zone, stop, target — your own bot, so levels are always shown), the trade-likelihood score, the plain-language reason, and when it expires. Lapsed proposals are hidden. Approve opens the SAME paper trade the bot would have on auto (re-validated against the live price); pass records the honest road-not-taken. Nothing ever auto-approves.

Approve a PENDING confirm-mode proposal by id (from list_proposals). Re-validates against the LIVE price and, only if the market still sits in the staked entry zone, opens the SAME PAPER trade the bot would have opened on auto — through the identical executor path, no real money. A market that moved out of the zone expires the proposal ('this setup has moved') and opens nothing; an already-decided/expired/superseded proposal returns the honest per-status message. Exits stay automatic (SL/TP). There is NO auto-approve — a proposal only opens by this explicit call.

Pass on a PENDING confirm-mode proposal by id (from list_proposals). Records the honest 'You passed on this setup' on the bot timeline and opens nothing. Declining an already-resolved proposal returns the honest per-status message.

Browse a level-free snapshot of the public TradingWizard AI bot fleet: symbols, current bias, AI confidence, trade-likelihood and paper track record. Optionally filter by symbol.

Follow a GLOBAL fleet bot so the user is told about every trade it takes — its entry, stop, target and result, as a percentage. Nothing is opened in the user's account. `action` selects follow | unfollow. Get bot ids from get_global_bots.

Verified Wiz Bot Fund paper-performance index, based at 100 across every verified global master bot. Current NAV combines realized return from closed positions with mark-to-market unrealized return from open positions, using equal bot sleeves and real position exposure. Returns the canonical Total / Closed / Open percentages, 7d / 30d / all NAV-ratio periods, completeness and mark-freshness metadata, and complete verified series points. Percentages only: no currency values, account identifiers, trade identifiers, or GlobalPerformance fallback. `period`: 7d | 30d | all (default 30d).

Fetch the user's recent trades. `status` selects OPEN, CLOSED or PENDING (default: all three). `limit` caps the result count (default 25, max 100). Most recent first.

Mark-to-market view of all OPEN positions, priced live right now (vs get_trades, whose pnl is a stored snapshot). Returns a tradeId per row plus live price, live P&L and P&L %, so an agent can monitor position health and decide what to close or modify. Includes a totalLivePnl across positions.

Fetch the current live price for a single stock, crypto, forex, futures, or index symbol. The asset class is inferred when `type` is omitted.

Use this when the user asks about the current macro market picture. Returns crypto and stock Fear & Greed, altcoin season, BTC dominance, VIX, the US 10Y yield and daily change, market regime, AI signal, top movers and fleet sentiment. Every unavailable metric is null, and freshness metadata shows whether the four-hour macro ingest is healthy, stale or unknown.

Use this when the user wants to browse or compare a market list instead of looking up one ticker. Returns the same real asset universe and live quote fields used by /wiz/markets for Top 100, crypto, stocks, ETFs, forex, indices or futures. Results are capped at 50 and missing prices stay null.

Latest TradingWizard Market Track events: price spikes, regime changes and AI calls with significance, sentiment and a short explanation. Optionally filter by symbols, market type or significance.

Latest verified public statements from influential market-movers (Trump, Elon, Powell, Cathie Wood, Saylor, Cramer…) that could move a stock, crypto or sector — with the affected ticker, sentiment, a 'how likely to move' score, the source, and how far the asset has moved SINCE the statement. Optionally filter by symbols.

What changed for ONE US stock or ETF in SEC filings: insider buying and selling (Form 4), recent company filings (8-K), and quarter over quarter institutional position changes (13F). Returns a short "what changed" list where every claim names the filing it came from, plus each part in its own envelope with provider, publication date, fetch date and freshness. Any part we could not check says so and is listed in `gaps`; it never comes back as "no activity". US stocks and ETFs only, because it reads SEC filings: crypto, currency pairs, futures, indices and non-US listings are refused with a reason rather than returned empty. Public-domain SEC EDGAR data. Ultimate plan only. Educational, read-only, and it never places a trade.

Cross-asset event scanner. `kind` selects "earnings" (upcoming earnings calendar, synced daily from the FMP calendar), "ipo" (upcoming IPOs by date from the IPO calendar, with a live NASDAQ-feed fallback), "insider" (recent insider transactions — live Yahoo Finance SEC Form 4 data across a curated large-cap universe) or "all" (default). Sections with no data return empty arrays.

Fetch the most recent AI chart analysis for a symbol — verdict, confidence, entry/SL/TP levels, headline reasoning. Returns null when no analysis has been run yet. For a FRESH analysis, call run_analysis.

Get a structured trade SETUP for a symbol BEFORE execution — bias (BUY/SELL/WAIT), entry zone, stop / invalidation, targets, confidence, risk:reward, reasoning, and warnings. The call idempotently creates or updates a private setup receipt for the authenticated user and returns its shareable receiptUrl when available. It never places a trade. Educational only — no profit guarantee.

Top trade signals across the global bot fleet right now — symbols where the AI conviction is highest. Use this when the user asks "what should I look at" without a specific ticker. Ultimate plan only.

How the global bot fleet is currently biased on a symbol — a fast macro signal to validate or challenge your own conviction without running a fresh analysis. Returns bullish/bearish/neutral counts, the net consensus, and a confidence %.

Trigger a FRESH AI chart analysis for a symbol on demand (vs get_chart_analysis, which only returns the cached one). ⚠️ PAID: runs the Gemini engine (consumes a credit + Gemini compute). Ultimate-only via the agent API. Synchronous — can take up to ~2 min; if your client times out, the analysis still completes (recover it with get_analysis_status or get_chart_analysis). After it completes, call get_trade_setup for the structured setup.

Check a chart analysis by analysisId, or the latest for a symbol — returns its status (processing/completed/failed) and the full analysis when ready. Use to poll a run_analysis that your client may have timed out on.

The live public scanner board: symbols the global AI bot fleet is watching, ranked by trade-likelihood. Returns symbol, bias, likelihood, confidence, fleet coverage and scan freshness without actionable price levels.

Start watching a setup receipt so TradingWizard tracks its outcome — target hit, stopped out, or invalidated — and alerts the user when it resolves. Pass the receiptId (the 24-char id inside get_trade_setup's receiptUrl, /r/<id>) or the receiptUrl itself. This closes the loop on get_trade_setup: fetch the setup, act (or not), then watch how the call plays out. Plan-capped concurrent watches (Free 1 / Pro 10 / Ultimate unlimited).

Snapshot of the user's portfolio — total equity, virtual cash balance, open exposure, win-rate, daily and all-time P&L, and per-holding AI verdicts.

List the user's watchlists — saved symbol groups (name, icon, symbols, default flag). Use this to discover which symbols the user cares about before scanning or analysing.

List the user's imported Portfolio holdings — the real assets they track (symbol, quantity, average cost, currency, horizon, broker source). NOT the paper account: use get_portfolio for paper equity and positions. Holdings are analysis context only; Wiz never trades them.

Add holdings to the user's Portfolio: each row needs `symbol` and a non-zero `quantity`; optional avgCost, currency (default USD), assetType, assetName, horizon (default position). Upserts by symbol, so re-adding a manual symbol updates it. Confirm the rows with the user before calling — this edits their real portfolio record. Caps: 100 rows per call, 250 holdings total. Wiz never trades holdings.

Update one Portfolio holding's quantity, avgCost, horizon, or assetType. Identify it by `id` (from get_holdings) or by `symbol` when unambiguous. Synced holdings (connected venues) are read-only and refuse edits. Confirm the change with the user before calling.

Remove one holding from the user's Portfolio, by `id` (from get_holdings) or by `symbol` when unambiguous. This deletes the row — confirm with the user before calling. Synced holdings (connected venues) cannot be removed here.

The user's own trading analytics over a window of CLOSED trades — win rate, profit factor, expectancy per trade, average and largest win/loss, total realized P&L, and max drawdown of the realized equity curve. `days` sets the window (default 90, max 365, 0 = all-time) — use days=30 for monthly stats. Optional `source` filter: paper | bot | live | imported. Use for "what's my win rate", "how did I trade this month", "am I profitable".

List the user's price/indicator alerts. Optional `symbol` filter. Shows condition, target value, timeframe, delivery channels and active state.

Create a price or indicator alert for a symbol. Conditions: price_above, price_below, rsi_above, rsi_below, rsi_oversold, rsi_overbought, ma_cross_above, ma_cross_below, volume_spike. price_*/rsi_above/rsi_below need a positive `value` (RSI 1-99). Delivery defaults to in-app + email. Plan-capped (Free 3 / Pro 10 / Ultimate unlimited) and rate-limited. Notifications only — does NOT auto-trade.

Update an existing alert by id — change its value, condition, timeframe, delivery, cooldown, or pause/resume it via `active`. Re-activating respects the plan cap.

Delete an alert by id. Frees a slot against the plan cap.

Add a symbol to a watchlist. Targets the list by `listId` or `listName`, else the user's default list. Idempotent (no duplicates).

Remove a symbol from a watchlist (by listId/listName, else the default list).

Create a new watchlist with an optional name, icon (emoji) and starting symbols. Plan-capped (Free 3 / Pro 10 / Ultimate unlimited).

Delete a watchlist by id. If it was the default, the oldest remaining list is promoted to default.

Open a PAPER (simulated) market trade — no real money. Fills at the live market price (you cannot set the entry; a >2% move or no feed is rejected, like a real broker). Deducts from the virtual balance. Provide an optional analysisId to attribute the trade to a chart analysis. Free across plans; paper only.

Close an OPEN paper position by tradeId (get the id from get_positions_live). Closes at the live price. Pass partialPercent (0-100) to scale out; omit for a full close. Bot positions also settle followers.

Edit the stop-loss, take-profit(s) or trailing-stop on an OPEN paper position by tradeId. A level is set when present, cleared with null, untouched when omitted. New levels are validated against the live price (you can move a stop to break-even+ but not set one that would trigger immediately).

Place a PAPER (simulated) LIMIT order at YOUR exact entry price — the execution counterpart to get_trade_setup's entryZone (execute_paper_trade is market-only). A BUY limit below / SELL limit above the live price waits until price reaches the level (funds are reserved up-front, Binance-style); a limit already at/past the live price fills immediately at market and the response says so. Optional stop/target are validated for side and sane distance (a dropped-k typo like "BTC at 107" is rejected with a units hint). Cancel an unfilled order with cancel_pending_order. Paper only — no real money.

Cancel one of the user's PENDING (unfilled) paper limit orders by tradeId and refund the funds reserved at placement. Find pending orders via get_trades with status=PENDING. Has no effect on OPEN positions — use close_position for those.