OptionClaws

One journal trade in full: legs and fills, current value, notes and tags, breakevens, roll chain, any legs waiting to be settled after expiration, and its recent change history with event ids (use an event id with revert_journal_change to undo that change).

get_journal_trade

Analyze options on one stock or ETF, for example 'what are NVDA options pricing in' or 'is TSLA IV high right now'. Returns everything OptionClaws has on the symbol: stock price, market cap, beta, dividend and earnings dates, technicals (RSI, ATR, moving averages, 52-week range), IV, IV rank and percentile, how IV has been reacting to price moves (volReaction: usual spot-vol pattern and whether it broke today or recently), option volume, every listed expiration, and the option chain for one expiration (nearest 30 days out by default) near the stock price with bid/ask, IV, delta, gamma, theta, vega, volume and open interest per contract. Requires an active trial or subscription.

get_symbol_details

The user's OptionClaws watchlist: the tickers they follow, shared with the OptionClaws website and app. To scan only these tickers, use run_scan_v2 (or run_scan) with universe "watchlist". Change the list with add_to_watchlist and remove_from_watchlist.

get_watchlist

The user's open journaled positions as a portfolio: net delta, gamma, theta and vega, exposure by symbol, sector and expiration, and an estimated margin used. Paid plans only; on a free plan it explains that.

get_journal_portfolio

How the user's journaled trades are doing: win rate, realized and unrealized P&L, expectancy, profit factor, drawdown, equity curve and calendar. Paid plans also get breakdowns (by strategy, symbol, days to expiration, tag, playbook, emotion, mistake) and calibration of entry win probabilities versus results. Small samples are noisy; say so when there are few closed trades.

get_journal_stats

The user's trade-journal accounts (live and paper) and playbooks (their trading setups with rule checklists), with the ids the other journal tools take as accountId and playbookId. Use it to map "my IRA" or "my wheel playbook" to an id before filtering list_journal_trades, get_journal_stats or get_journal_portfolio, or before logging a trade to an account or playbook. Playbooks are paid plans only.

list_journal_accounts

The user's OptionClaws trade journal: the trades they logged, newest first, with realized P&L for closed trades and current unrealized P&L for open ones. Filter by status, symbol, strategy, tag, playbook, dates, or practice (paper) trades. Use the ids with get_journal_trade and preview_journal_change.

list_journal_trades

The user's named ticker lists from OptionClaws (separate from the watchlist), plus any built-in index lists available to them (e.g. "S&P 500® members"; name and ticker count only, the members aren't listed). Each entry has a universe value ("list:<id>" or "index:<id>") to pass as the universe of run_scan_v2, run_scan, run_preset_scan or create_saved_scan to scan only those tickers. Change lists with create_universe_list, update_universe_list and delete_universe_list (or on optionclaws.com). S&P 500® is a registered trademark of S&P Dow Jones Indices LLC. Nasdaq-100® is a registered trademark of Nasdaq, Inc. OptionClaws is not affiliated with or endorsed by either.

list_universes

The user's practice (paper) orders placed from the journal: working limit orders waiting to fill, and filled, canceled or expired ones. Each has its legs, order type, limit price, time in force, status, fill price, and the current natural price. Use an order id with cancel_paper_order. New practice orders are placed with preview_journal_change (intent paper_order) and confirm_journal_change.

list_paper_orders

List OptionClaws' curated, ready-to-run options trade ideas, optionally filtered by tag: income (covered calls, cash-secured puts, wheel candidates, iron condors, strangles), dividends, high-probability, technical (oversold/overbought spreads, 52-week highs, below the 200-day), earnings plays, volatility, hedging (married puts), unusual call volume, and advanced setups. Use when the user wants options trade ideas without specifying exact criteria.

list_presets

List the scans the user saved in OptionClaws (id, name, strategy, last updated); the text also lists each scan's filters, marking (default) the ones OptionClaws added automatically from the web defaults when it was saved. Use when the user mentions 'my scan', 'my saved screener' or a scan by name. Delete unwanted filters with update_saved_scan removeFilters.

list_saved_scans

Opens the OptionClaws scanner as a full-screen app: pick a curated trade idea, a saved scan or a strategy, adjust filters and review ranked options trades. Opened by the user from the sidebar; takes no arguments.

open_scanner

Remove tickers from the user's OptionClaws watchlist (shared with the website and app) when the user asks. Tickers not on it are ignored. To clear the list, pass every ticker from get_watchlist. Returns the list as saved plus what was removed.

remove_from_watchlist

Find trades for a position the user describes leg by leg (up to 4 legs: calls, puts and at most one stock leg), when none of the built-in strategies fits: e.g. 'short a 20-delta put and buy the put 2 strikes below, 30-45 DTE, on SPY and QQQ', 'jade lizards on my watchlist', 'a 1x2 call ratio 5% out of the money'. Each option leg picks its expiration by a DTE window or the same expiration as an earlier leg, and its strike by delta (plus or minus a tolerance), by percent from the stock price, or by a width (listed strikes or dollars) from an earlier leg. Covers up to 25 symbols (a watchlist, a symbols: list, or all narrowed by stock filters; the most liquid are kept). Every matching combination is priced: net debit/credit (options only), max profit/loss, breakevens, probability of profit, expected value, return on risk, Reg-T margin where it can be derived, per-leg greeks and position greeks. For built-in strategies (covered calls, spreads, iron condors, ...) use run_scan_v2 instead: it is faster and covers the whole market. To price one exact position, use analyze_position. To save a custom scan, call create_saved_scan with definition {strategy: "custom", universe, legs, and optionally filters, sort and pricing}; rerun it here with savedScanId. Read-only: it never places trades. Requires an active trial or subscription; on the free plan each call uses one free scan.

run_custom_scan

Find options trades that match the user's own criteria, such as 'covered calls on my watchlist paying over 1% a week', '30-45 DTE iron condors with 70%+ probability of profit' or 'cheap LEAPS on semiconductor stocks'. Takes a ScanDefinition (strategy, universe, filters, sort) and returns a compact top-N result. Results collapse to one row per symbol unless definition.onePerSymbol is false, so limit caps symbols, not contracts, in the default case. Each row's filterValues shows its actual value for every filter and the sort key used. For results past the first page, or per-leg greeks, use run_scan_v2. Use describe_scan_filters first if unsure what's valid. Filters you leave out get the web app's defaults for the strategy (a liquidity floor, a DTE window and, for premium-selling strategies, probability and return floors and an earnings exclusion); a watchlist or symbols: universe skips the market-wide ones. The note lists what was added: to remove one, pass that filter as {} (false for a yes/no filter). If nothing matches, the scan is retried with only the liquidity floor, then without defaults, and the note says so. Your sort is used as given. Requires an active trial or subscription.

run_scan

Find and rank options trades from a curated idea (presetId), one of the user's saved scans (savedScanId) or custom criteria (definition), and return one page of ranked results. Best when the user wants more results, per-leg greeks or position greeks. Page with offset (up to rank 500): each result gives nextOffset while more matches exist, so 'show me 10 more' is the same call with offset=nextOffset. Results collapse to one row per symbol unless definition.onePerSymbol is false. Each row has its rank, legs, metrics, filterValues (its value for every filter and the sort key), per-leg quotes and greeks (legDetails) and position greeks (netGreeks). Use describe_scan_filters first if unsure what's valid. For a custom definition, filters you leave out get the web app's defaults for the strategy and an omitted sort gets that strategy's default sort (return on risk for credit strategies, market cap for cash-secured and naked puts, probability of profit for debit strategies); appliedDefaults and the note list what was added. Pass a filter as {} (false for a yes/no filter) to drop it, or applyDefaults=false to add none; a watchlist or symbols: universe skips the market-wide defaults. presetId and savedScanId are never changed. If nothing matches, it retries with only the liquidity floor, then without defaults, and the note says so. Requires an active trial or subscription.

run_scan_v2

Run a curated trade idea from list_presets (for example covered-call-income, wheel-candidates or iron-condor-core) across the whole market or the user's watchlist and return the best current matching options trades with legs, premium, max profit/loss, breakevens, probability of profit and return. One row per symbol by default, so limit caps symbols, not contracts. Each row's filterValues shows its actual value for every filter and the sort key used. For results past the first page, or per-leg greeks, use run_scan_v2. Requires an active trial or subscription.

run_preset_scan

Re-run one of the user's saved scans (from list_saved_scans) to see which trades match it right now, and return a compact top-N result. Each row's filterValues shows its actual value for every filter and the sort key used. For results past the first page, or per-leg greeks, use run_scan_v2. A saved scan runs exactly as saved (no defaults are added); the text shows its filters, and if it matches nothing while some are marked (default), removing them with update_saved_scan removeFilters may return more. Requires an active trial or subscription.

run_saved_scan

Save a scan to the user's OptionClaws account so they can rerun it later here (run_scan_v2 savedScanId) or on the OptionClaws website. Give a name plus either presetId (save a curated idea as-is) or definition (custom criteria, same shape as run_scan_v2's definition; check describe_scan_filters if unsure). Filters the definition leaves out get the web app's defaults for the strategy (and an omitted sort its default sort) unless applyDefaults is false; a preset is never changed. The result returns the definition as saved plus appliedDefaults: tell the user which filters you did not choose were added, and use update_saved_scan removeFilters to delete any. Only save when the user asks to. Each user can keep up to 10 saved scans; at the limit this returns an error, and the user must delete one first (delete_saved_scan).

create_saved_scan

Look up a stock or ETF ticker by company name or partial ticker (for example 'nvidia' or 'SPY') in the OptionClaws symbol universe.

search_symbols

Send the user's feedback to the OptionClaws team: a bug report, a feature request, or a support question. Use it only when the user asks to send feedback, report a problem, request a feature or contact OptionClaws support, or when you offered to pass along their complaint or missing feature and they said yes. Before calling, show the user what you will send and get their OK. Send the user's own words or a faithful summary of them; never send feedback they didn't ask for, and don't add personal details they didn't write. Works on every plan and uses no scans.

send_feedback

OptionClaws' Top Trades: a short curated list of today's best income trades, one or two per curated idea (high-probability puts, wheel candidates, iron condors, covered calls and more), picked with liquidity and fill guardrails. The same list as optionclaws.com/top-trades. Call this first when the user asks what's good to trade today, wants the best ideas across strategies, or has no specific criteria: it's instant and runs no scan. Optional strategy or presetId narrow the list. Each row is shaped like a run_scan_v2 row plus the presetId it came from; for more trades like one, call run_scan_v2 with that presetId. For one specific stock or ETF, pass symbol (for example AAPL): you get the best trades for that ticker that pass the same quality checks, up to 2 per strategy, or the reason none do (status, blockers, nearestMisses) so you can explain it briefly. A symbol search counts as one scan on the free plan; the market-wide list does not.

get_top_trades

Opens the OptionClaws Trade Board beside the conversation: run a curated idea or saved scan and add trades to the chat. Opened by the user from the conversation's side panel; takes no arguments.

open_trade_board

Undo one change in the user's trade journal by its event id (from get_journal_trade's events). It can delete or restore data, so tell the user exactly what will be undone (the event's summary) and get an explicit yes first. Only events marked revertible can be undone.

revert_journal_change

Change one of the user's saved scans (id from list_saved_scans): rename it (name), replace its definition (definition: same shape as create_saved_scan's, with the same web defaults added for filters it leaves out unless applyDefaults is false), and/or delete filters from it (removeFilters: filter ids). Use removeFilters when a saved scan returns too little: list_saved_scans and run_saved_scan mark filters OptionClaws added automatically as (default), and removing those is usually what the user wants. Only change what the user asked for. Returns the scan and its definition as saved now.

update_saved_scan

How a stock's implied volatility has been reacting to its price moves (spot-vol), and whether it broke its usual pattern. Use it for questions like 'how has NVDA's IV reacted to the selloff?', 'is TSLA vol behaving normally?', 'did IV rise with the stock?'. For each symbol it returns: the usual reaction fitted over the last 60 trading days (IV points per 1% up day and per 1% down day, correlation, and whether that matches the usual stock pattern of IV rising on selloffs), today so far, the last trading day, 5 and 20 days (price change, IV change, the IV change the usual reaction predicts, and a verdict: in_line, opposite, stronger, muted, or iv_without_price), recent days IV broke its pattern, a 20-day vs 60-day pattern shift, 30-day IV vs 20-day realized volatility, and earnings context (post-earnings IV drops and pre-earnings build-ups are not counted as breaks). Each result has a plain-English headline and summary to relay. Pass symbol, symbols (up to 25), or watchlist=true. To find which stocks broke their pattern, use find_vol_reaction_breaks. On the free plan each call uses one free scan.

get_vol_reaction