add_to_watchlist
ChatGPTAdds ticker symbols to one of the member's MadStockAlerts watchlists (the default 'My Watchlist' unless list_id is given) and returns the list's symbols afterward. Use it only when the member asks to add or follow a stock. A symbol already on the list is left as it is, so repeating the call changes nothing.
alert_performance
ChatGPTThe premium alert track record, computed from CLOSED alerts only: how many measured, winners and losers, average and median winner, loser and return, average hold, profit factor, expectancy per unit of planned risk, largest winner and loser, the record by month and by entry-price band, plus recent and all-time top winners. The win rate is withheld (null) until the closed sample reaches twenty, and averages are flagged provisional under ten. Report the numbers with those caveats intact.
compare_tickers
ChatGPTOne call that answers a question about SEVERAL named tickers: 2 to 8 of them, side by side, in one table. How each is trading right now (price, change, gap from the open, volume against its 30-day average, where price sits against the session VWAP and inside today's range, ATR as a percent of price, float), how each sits on the chart (RSI, above or below the 50 and 200-day, 52-week range position, trailing performance), what each is worth (market cap, P/E, revenue growth, margins, short float), and the next earnings date. Use this instead of calling research_ticker once per symbol; follow up with research_ticker only on the one or two that deserve the detail. One row per ticker; nulls mean not measured.
corporate_events
ChatGPTWhat companies did, market-wide or for one ticker, classified from the news wire over the last N days: earnings reports and surprises (beat, miss), guidance changes (raised, cut), M&A (to acquire, to be acquired), FDA and clinical decisions, product launches, and buybacks or dividend changes. Each row carries the category, a short label, the tone, the subject company, the headline, source and time, plus the real-time change for the subject. These are headline classifications, not a structured corporate-actions feed; for what a company itself disclosed, read sec_filings in research_ticker. Alongside them, filed_results lists the earnings results companies FILED with the SEC since the last close (8-K item 2.02): when each landed against the trading day, today's move, and an AI summary of the release where one is ready. It answers 'what did X report' from the filing itself; it is included unless another category is asked for.
economic_calendar
ChatGPTThe government prints and Fed decisions that set the tape: FOMC decisions and minutes, CPI, PPI, payrolls, PCE, GDP, weekly jobless claims, retail sales, consumer sentiment, JOLTS, housing starts, industrial production and existing home sales, over a window of past and coming days (default the last 3 and next 14), each with its release time in US Eastern, its impact tier and whether it has already landed. Also the latest readings behind them (CPI and core CPI year over year and month over month, PPI year over year, unemployment, fed funds, real GDP with the Atlanta Fed GDPNow nowcast); each reading's change and change_basis say how it moved from the prior month, and change is null where none was measured. Use it for 'what is on the calendar this week' and before judging a macro-driven session.
find_setups
ChatGPTThe MAD Setups board: the best-ranked bullish chart setups across the whole market from our nightly detection sweep, with any setups our team has curated in the last three weeks pinned first. Each row carries the pattern, a 0-99 score, real-time price, change, relative volume, the trigger level (the nearest overhead high the setup resolves through) and the distance to it in percent. The score ranks setups against each other on relative volume, trend alignment, pattern agreement and RSI. Optionally restrict to one pattern type.
get_bars
ChatGPTOHLCV price bars for one ticker at a chosen resolution, newest last. Default is 120 daily bars. Each bar is [time_iso, open, high, low, close, volume, vwap, session] where session is pre, regular or post for intraday bars and day for session bars. Pass session: regular to drop extended-hours bars (the default keeps them), and from/to (YYYY-MM-DD) to frame a window such as one session's open. Keep limit small unless you are computing something; a chart's worth (100 to 250 bars) is plenty for most questions. For the opening range, VWAP distance and time-of-day relative volume, intraday_context computes them for you.
get_news
ChatGPTRecent news for one ticker, or market-wide when no symbol is given, as CLUSTERED stories: one event with the outlets that carried it, rather than nine near-identical headlines for one earnings beat. Each story carries the measured price move around its publication (15 minutes, the peak, and where it stands now, with a plain-English shape) and, where we have publicly called the name, the date we did. The move is measured around the timestamp and is never a claim that the story caused it. For a ticker it also returns the company's SEC filings from the last 45 days (offerings, 8-K material events in plain English, activist stakes) and a coverage note saying how current the headlines are. The headline wire is thin on small caps, so read the filings before concluding nothing happened. Legal-solicitation press releases and opinion, rating and pick pieces are filtered out, as on the members' News Feed.
get_quote
ChatGPTReal-time price, change, session range, volume and pre/after-market moves for up to 20 tickers in one call. Use this only when the price itself is the question. For anything a member would call a question about the stock, use research_ticker for one name or compare_tickers for several: both carry the same session figures plus the technicals, fundamentals, setups and our alerts.
insider_transactions
ChatGPTSEC Form 4 insider filings: for one ticker, the latest transactions by its officers, directors and 10% owners (purchases, sales, option exercises, awards, tax withholding) with shares, price, value and the holding afterwards; or market-wide, the latest open-market purchases (code P) or sales (code S). Open-market purchases are rare on the raw tape and are the rows traders read; awards and exercises are routine compensation.
institutional_holders
ChatGPTQuarterly SEC Form 13F ownership: for one ticker, the largest institutional holders (passive ETFs, mutual funds, hedge funds, banks and advisors) with shares, market value and the change against the prior quarter, including managers that exited; or, without a symbol, the market-wide flows board (the names tracked managers added, reduced and opened most). 13F data lags the quarter end by up to 45 days and describes long common-stock positions only.
intraday_context
ChatGPTHow one stock is trading today, from its 5-minute bars and the real-time quote: the pre-market range and volume, the gap, the opening range (first 5, 15 or 30 minutes) and whether price is above, inside or below it, the session high and low with their times, distance from VWAP, position in the day's range, range used against the 14-day ATR, cumulative volume against the same clock time on the last twenty sessions (time-of-day relative volume), the after-hours tape once the close has passed, and the prior session's high, low and close as reference levels. After the close it describes the completed session. Use it when a member asks how a stock is acting today, whether it is holding a gap, or whether volume is really heavy for the hour.
list_alerts
ChatGPTMadStockAlerts premium alerts: the ideas our scanners surfaced and a human analyst approved, each with the thesis (when written), a generated context block captured at publish (the day's detected patterns, trend, relative volume and the company's filings from the prior week), entry, stop, target, planned reward-to-risk, publish and close dates, and the peak since publish. Open alerts also carry the real-time price, the unrealised return from entry, and the distance to the stop and to the target. Closed alerts carry the exit price and realized return. Filter by open, closed or all, and optionally by ticker. Open alerts are live ideas; closed ones are the record. Every alert is educational analysis, never a recommendation.
market_context
ChatGPTWhere the market stands right now: session status, the major index ETFs (SPY, QQQ, IWM, DIA), breadth across the S&P 500 and Nasdaq 100 (advancing vs declining, new highs and lows, share above the 50-day), the cross-asset tape through listed funds (volatility via VIXY, long Treasuries, the dollar, gold, crude, bitcoin), Treasury yields (2, 10 and 30 year, with the whole par curve, the 10y-2y and 10y-3m spreads, TIPS real yields and 5 and 10-year breakeven inflation, as the U.S. Treasury published them for the latest session), the latest macro readings (CPI and core CPI both year over year and month over month, PPI, unemployment, fed funds, GDP with the GDPNow nowcast, each with its change from the prior month where measured), the economic calendar for today and the next ten days (FOMC and its minutes, CPI, PPI, payrolls, PCE, GDP, jobless claims, retail sales, consumer sentiment, JOLTS, housing, industrial production), sector performance ranked over the day and the month, the leading and lagging industries (e.g. Semiconductors, Banks) over the same window, today's top gainers and losers among US common stocks over $1 with at least $1M traded, earnings in the next three days (with each company's usual before-open or after-close slot), the earnings results companies have FILED with the SEC since the last close (when each landed, today's move, and an AI summary of the release where one is ready), and the latest market headlines. Call this first for any 'how is the market' or 'what should I be looking at today' question, and before judging whether a single stock's move is its own or the market's.
paper_cancel_order
ChatGPTCancels one of the member's SIMULATED Paper Trading orders that is still working (a market order waiting for the open, a limit resting at its price, a stop or trailing stop watching for its trigger: status working in paper_portfolio's working_orders or from paper_place_order). An order that has filled cannot be cancelled; sell the shares instead. Use it only when the member asks, and confirm which order with them first, unless the order's portfolio has autonomous_trading true: the owner pre-approved you to cancel orders there without asking. Returns whether the order was cancelled; an id that is not one of the member's working orders answers cancelled: false.
paper_cash_out
ChatGPTTakes SIMULATED cash out of one of the member's Paper Trading portfolios, the way a withdrawal would. Only cash can be cashed out, and only cash that no working buy order has already claimed; to free more, the member sells a holding or cancels the order first. The cash out is recorded as money taken out, so the portfolio's total return stays measured net of it and a cash out is never a loss. Returns the cash and balances afterwards; asking for more than is free comes back as an error naming the amount available. Use it only when the member asks, and confirm the amount and the portfolio with them first.
paper_close_portfolio
ChatGPTCloses one of the member's MadStockAlerts Paper Trading portfolios (SIMULATED money) and removes everything in it: its cash, holdings, working orders and history. It cannot be undone, and the member's last portfolio cannot be closed (open another first). Requires confirm: true, which you may send only after naming the portfolio to the member, with its value, and getting their explicit yes in this conversation. Returns the portfolios left.
paper_deposit
ChatGPTAdds SIMULATED cash to one of the member's Paper Trading portfolios, up to $5,000,000 in one deposit and $50,000,000 funded in total. The deposit is recorded as money put in, so the portfolio's total return stays measured net of it and a deposit is never a gain. Returns the cash and balances afterwards. Use it only when the member asks to add money to a paper portfolio, and confirm the amount and the portfolio first.
paper_open_portfolio
ChatGPTOpens a MadStockAlerts Paper Trading portfolio for the member (SIMULATED money), their first or another, with the name they give it and a starting cash balance between $1,000 and $10,000,000 (default $100,000). A member keeps up to 12 portfolios; each has its own cash, holdings and history. Returns the new portfolio's id and the full list. Use it only when the member asks for a new or separate paper portfolio, and confirm the name and the starting cash first.
paper_place_order
ChatGPTPlaces a SIMULATED Paper Trading order (market, limit, stop, stop limit or trailing stop) on one of the member's portfolios. Requires confirm: true. Unless the portfolio's autonomous_trading is true, send it only after showing paper_preview_order's preview to the member and getting their explicit yes in this conversation, and never place an order the member has not approved; when it is true, the owner pre-approved orders on that portfolio and the preview is enough. Takes the same fields as paper_preview_order, plus the required preview_id from that preview: the order is placed only if it still matches the preview (same portfolio, symbol, side, size, type, prices and time in force, within ten minutes), and a repeated call returns the same order instead of placing another. Fill rules, the tab's own: a market order fills at once during the regular session, at the ask on a buy and the bid on a sell when the bid/ask is current and tight, otherwise at the platform's real-time price (the usual case: the feed's bid/ask runs behind, and nbbo_delayed says so); placed in pre-market or after hours (04:00 to 20:00 ET) it fills at once at the real-time price if its real-time price updated in the last 15 minutes; otherwise (overnight, weekends, or no recent price update) it rests and fills at the market price on its first check once the regular session opens. Every fill is at the market price of that moment, never another figure. A limit rests until the price reaches it and fills at the limit or better. A stop or trailing stop watches the regular session's trades and becomes a market order when the stop is reached; a stop limit becomes a limit. A Day order lapses at the close, a GTC order after ninety days. Any working order can be cancelled with paper_cancel_order until it fills or lapses. Autonomous trading: when a portfolio's autonomous_trading is true (paper_portfolios, paper_portfolio, and the preview's portfolio), its owner turned it on for that portfolio on the Paper Trading tab, which pre-approves you to place and cancel simulated orders there without asking each time. Only the owner can turn it on, on the tab. When it is false, the member approves every order. Returns the order's id, status (filled, or working when it waits), the fill price and basis, the shares, the engine's note, and the portfolio's balances afterwards. A refusal (not enough cash, more shares than held, no price for the symbol, a stop on the wrong side of the price) comes back as an error message to relay to the member.
paper_portfolio
ChatGPTOne of the member's MadStockAlerts Paper Trading portfolios in full (SIMULATED money): the balances (equity, cash, buying power, invested, money put in, total return in dollars and percent, today's change in dollars and percent), every holding (symbol, company name, shares, average cost, price, previous close, market value, total return and percent against cost, today's change and percent, weight in the portfolio), every working order (market orders waiting for the open, limits resting at their price, stops watching for their trigger, trailing stops with the level they trail from, each with the id paper_cancel_order takes and when it lapses), the most recent fills (symbol, side, shares, fill price and basis, time, and the realized gain on a sell), the most recent cancelled, expired and rejected orders with the reason, the deposits and cash outs, and the market session. Use it for 'what do I hold', 'what orders do I have working', 'how is my paper portfolio doing' and before a sell, so the shares held are known. It also says whether the owner turned on autonomous trading for the portfolio. Read only.
paper_portfolios
ChatGPTThe member's MadStockAlerts Paper Trading portfolios (SIMULATED money, never a brokerage): for each, its id, name, equity (cash plus holdings at the platform's quotes), cash, buying power (cash not already set aside for a working order), the value invested, the money put in (starting cash plus deposits less cash outs), total return in dollars and percent against that, how many positions it holds, how many orders are working, when it was opened, and whether the owner turned on autonomous trading for it. Call this first to pick the portfolio for every other paper_* tool, and for 'how is my paper trading doing' or 'what is my paper balance'. A member who has not opened a portfolio yet gets an empty list and a next_step; only paper_open_portfolio opens one, and only when the member asks. Read only; it never opens or changes a portfolio.
paper_preview_order
ChatGPTPrices a SIMULATED Paper Trading order without placing it: the portfolio, the order as it would be written (type, prices, time in force), the platform's quote (price, bid and ask with their sizes, previous close), the market session, whether it would fill now or work (and the engine's note on what it waits for), when it would lapse, the estimated price (a market order's fill, a limit's limit, a stop's stop, a trailing stop's level from the price now), the estimated shares and value, the cash a working buy would hold back, the shares already held, buying power before and after, the reason it would be refused if it would be (not enough cash, more shares than held, a stop on the wrong side of the price, a fraction of a share on a stop), and warnings. Fill rules, the tab's own: a market order fills at once during the regular session, at the ask on a buy and the bid on a sell when the bid/ask is current and tight, otherwise at the platform's real-time price (the usual case: the feed's bid/ask runs behind, and nbbo_delayed says so); placed in pre-market or after hours (04:00 to 20:00 ET) it fills at once at the real-time price if its real-time price updated in the last 15 minutes; otherwise (overnight, weekends, or no recent price update) it rests and fills at the market price on its first check once the regular session opens. Every fill is at the market price of that moment, never another figure. A limit rests until the price reaches it and fills at the limit or better. A stop or trailing stop watches the regular session's trades and becomes a market order when the stop is reached; a stop limit becomes a limit. A Day order lapses at the close, a GTC order after ninety days. Any working order can be cancelled with paper_cancel_order until it fills or lapses. Unless the portfolio's autonomous_trading is true, always show this preview to the member and get an explicit yes in this conversation before calling paper_place_order with the same fields and its preview_id. Autonomous trading: when a portfolio's autonomous_trading is true (paper_portfolios, paper_portfolio, and the preview's portfolio), its owner turned it on for that portfolio on the Paper Trading tab, which pre-approves you to place and cancel simulated orders there without asking each time. Only the owner can turn it on, on the tab. When it is false, the member approves every order. Read only; nothing is placed.
remove_from_watchlist
ChatGPTRemoves ticker symbols from one of the member's MadStockAlerts watchlists (the default 'My Watchlist' unless list_id is given) and returns the list's symbols afterward. Use it only when the member asks to remove a stock, and confirm the symbols and the list with the member before calling it.
research_ticker
ChatGPTSTART HERE for any question about ONE named stock, general or specific. The complete research packet for one ticker in a single call: company profile, real-time quote, technicals (RSI, moving averages, 52-week range, performance), valuation and balance-sheet fundamentals, the latest filed quarters, liquidity, chart patterns and support/resistance from the daily bars, MAD Setups our team has curated on it, our own premium alerts on it (open and closed), how often it has come up in the conversation we track, the next earnings date, recent headlines with sentiment and a note on how current they are, and the company's SEC filings from the last 90 days (offerings, 8-K material events in plain English, activist stakes), the newsworthy ones with a short AI summary of what the filing itself says and its headline terms (price, shares, proceeds, counterparty). Start here whenever a member asks about a specific stock. Null fields mean 'not measured', never zero.
scan_market
ChatGPTRun the MadStockAlerts scanner across the whole US market: pick a preset scan and/or add filters, get back the top matches with price, change, volume, relative volume, market cap, RSI, trend and detected chart patterns. Use it for 'find me stocks that...' questions. Combine a preset with filters to narrow (e.g. preset unusual-volume + marketCap small + rsiBand strong). Rows are ranked by the preset's own order unless sort is given. Whole-market rankings use the last universe refresh (seconds to a few minutes old); the returned rows carry a real-time price overlay. Extended-hours presets answer for the whole session they describe: after-hours movers from the 4:00 PM close until the next 4:00 AM ET pre-market open, pre-market movers from 4:00 AM through the close. Outside that the result says which window applies. Every filter the members' scanner has is available here, including float size, dollar volume, ATR in dollars or as a percent of price, price against the session VWAP, change from the open, current volume, the pre-market and after-hours bands, short float and the valuation ratios; rows carry the float, share count, ATR percent and VWAP distance they were screened on. Relative-volume sorts default to operating companies (assetClass stock) so thin leveraged funds do not top the list; pass assetClass to widen. Free-text filters are echoed back as received. Presets: all (All Stocks: The full universe, most actively traded first.); top-gainers (Top Gainers: Biggest percentage winners in the regular session.); biggest-losers (Biggest Losers: Biggest percentage decliners in the regular session.); most-active (Most Active: Highest dollar volume traded today.); premarket-gainers (Pre-Market Gainers: Leading the tape before the opening bell.); premarket-losers (Pre-Market Losers: Falling hardest before the opening bell.); afterhours-gainers (After-Hours Gainers: Climbing after the close — often on earnings or news.); afterhours-losers (After-Hours Losers: Selling off after the close — often on earnings or news.); overbought (Overbought: RSI(14) above 70 — extended to the upside, most extreme first.); oversold (Oversold: RSI(14) below 30 — extended to the downside, most extreme first.); all-time-high (All-Time High: Within 2% of their highest price on record.); all-time-low (All-Time Low: Within 3% of their lowest price on record.); 5y-high (5-Year High: Trading within 2% of their highest price in five years.); 5y-low (5-Year Low: Trading within 3% of their lowest price in five years.); 52w-high (52-Week High: Within 2% of their 52-week high, closest to it first.); 52w-low (52-Week Low: Within 2% of their 52-week low, closest to it first.); premarket-active (Pre-Market Most Active: Heaviest volume before the opening bell.); premarket-gap (Pre-Market Gap: Moving at least 2% either way before the open.); afterhours-active (After-Hours Most Active: Heaviest volume after the close — usually earnings.); gap-down (Gap Downs: Opened more than 3% below yesterday's close, biggest gap first.); best-performing (Best Performing: Strongest one-year return in the market.); worst-performing (Worst Performing: Weakest one-year return in the market.); most-volatile (Most Volatile: Widest daily swings over the last 20 sessions.); high-beta (High Beta: Moves hardest when the market moves — beta above 1.5.); large-cap (Large Cap: Companies worth $10B and up, largest first.); small-cap (Small Cap: Companies worth $300M to $2B.); penny-stocks (Penny Stocks: Trading under $5, most active first.); most-expensive (Most Expensive: Highest share price in the market.); high-dividend (High Dividend: Yielding over 4%, highest first.); highest-cash (Highest Cash: Largest cash piles on the balance sheet.); new-daily-high (New Daily High: Printing at the high of the day right now, heaviest volume first.); highest-volume (Highest Volume: Most shares traded today, whatever they cost.); unusual-volume (Unusual Volume: Relative volume above 2x the 30-day average.); gap-up (Gap Ups: Opened more than 3% above yesterday's close, biggest gap first.); golden-cro…
setup_playbook
ChatGPTThe MadStockAlerts setups playbook: the chart setups we teach and trade (breakouts, bull flags, gap-and-go, cup-and-handle, trend pullbacks, momentum continuation, ascending triangles), each with what to look for, what completes it, and a link to the Academy lesson. Use it to explain a setup a member asks about, or to check a chart against our definition.
upcoming_catalysts
ChatGPTOne countdown of everything scheduled that can move a price: company earnings, government prints and Fed decisions, ex-dividend dates for names a reader would recognize, and new listings. The evening question, answered in one call: what should I be ready for tomorrow and this week. Each row carries the date, the clock time when we hold one, an impact tier, and whether the date is published or derived from the company's filing cadence. Use upcoming_earnings when the question is only about company reports, and economic_calendar when it is only about macro prints or you need the readings behind them.
upcoming_earnings
ChatGPTEarnings dates: the notable names reporting over the next N days (default 7), or the next report date for specific tickers. Dates are derived from each company's SEC filing cadence, so date_is_estimated is true until confirmed. timing is before_open or after_close when the company's last results filing landed there (from its EDGAR acceptance time), so timing_basis is last_report: the usual slot, not an announced time; null when unknown or mid-session. For results already filed today, call market_context (earnings_reported) or corporate_events.
watchlist
ChatGPTThe member's MadStockAlerts watchlists: every list with its id, name and symbols, each symbol with its live price, change and volume. Use it before answering 'how are my stocks doing' or 'review my watchlist'. Read only; add_to_watchlist and remove_from_watchlist change a list.