add_to_watchlist
ChatGPTAdd a ticker to the watchlist (market: stocks, etfs, crypto, forex, otc, instrument). Changes the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
ask_financial_ai
ChatGPTUse this when the user asks anything financial: a stock, ETF, index or crypto; a company's financials (revenue, earnings, EBITDA, margins, segments, guidance); prices, returns or technical indicators; forecasts and analyst estimates; options; macro data; screening for stocks; backtesting a trading strategy; or their own portfolio. thefinancial.ai answers from licensed market data and computes the numbers itself. Returns a finished analysis as markdown: text, tables, and a data summary of each chart. Stateless: include all context in the question. CALL ONCE, VERBATIM: pass the user's question exactly as written (do NOT rewrite it into a formal spec or add date ranges/assumptions). A "finished" result is complete and authoritative. Do NOT call again to validate/audit/reconcile/recompute figures (Sharpe, CAGR, volatility, etc.); present the returned result and stop. IMPORTANT — analyses take 30s to several minutes (multi-strategy backtests 10+ min) and use a POLL protocol. If a result has status "in_progress", it includes a job/request_id and a retry_after_seconds hint: stand by that many seconds, then call this tool AGAIN passing that same job (and NO question) to keep waiting. Repeat ONLY while status is "in_progress" — do NOT re-ask the question (that starts a new run); the result is coming, just keep polling with the job. "finished"/"timeout"/"error" are terminal (no job): stop polling and report the answer, or for timeout/error tell the user.
backtest_strategy
ChatGPTUse this when the user wants to backtest, simulate or compare a trading or investment strategy: moving-average or indicator rules, buy and hold, DCA, rebalanced mixes, top-N baskets, option strategies, or intraday 1-minute rules such as opening gaps and VWAP. Answers from thefinancial.ai's licensed market data, current to the latest close. Pass the user's request verbatim as question. Same protocol as ask_financial_ai: while status is "in_progress", call this tool again with only {"job": ...}.
create_manual_portfolio
ChatGPTCreate a manual portfolio from holdings (ticker + shares), e.g. from a pasted position list. Changes the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
get_company_financials
ChatGPTUse this when the user asks about a company's financials: revenue or sales, earnings, EPS, net income, EBITDA, margins, cash flow, debt, valuation ratios (P/E, P/B, EV/EBITDA), dividends, segment or geographic revenue, guidance, analyst consensus, or operating KPIs (ARPU, deliveries, backlog). US and international companies, by ticker or name. Answers from thefinancial.ai's licensed market data, current to the latest close. Pass the user's request verbatim as question. Same protocol as ask_financial_ai: while status is "in_progress", call this tool again with only {"job": ...}.
get_manual_portfolio
ChatGPTOne manual portfolio with its holdings. Reads the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
get_market_forecast
ChatGPTUse this when the user asks what is expected: thefinancial.ai revenue/EBITDA forecasts and their drivers, who will beat or miss estimates, earnings dates and calendars, earnings surprises and price reaction, S&P 500 direction, recession probability, or macro forecasts such as CPI. Answers from thefinancial.ai's licensed market data, current to the latest close. Pass the user's request verbatim as question. Same protocol as ask_financial_ai: while status is "in_progress", call this tool again with only {"job": ...}.
get_portfolio_analysis
ChatGPTStored analysis of one portfolio (risk, exposures, forecasts). Reads the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
get_result
ChatGPTRead more rows of a stored result: the handle that another thefinancial.ai tool returned. offset/limit paging (a negative offset counts from the end), optional column selection, markdown, CSV or JSON. Results are kept for 24 hours.
get_stock_price_data
ChatGPTUse this when the user asks about a stock, ETF, index or crypto price or quote, returns or performance over a period, market cap, moving averages, RSI, MACD, Bollinger Bands, volatility, drawdown, risk profile, correlations, or price charts. Answers from thefinancial.ai's licensed market data, current to the latest close. Pass the user's request verbatim as question. Same protocol as ask_financial_ai: while status is "in_progress", call this tool again with only {"job": ...}.
list_manual_portfolios
ChatGPTThe user's manual portfolios. Reads the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
list_portfolios
ChatGPTAll of the user's portfolios — manual, demo and connected broker accounts — with values. Reads the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
list_saved_screeners
ChatGPTThe user's saved screeners (Workspace > Screeners), with their latest results. Reads the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
list_saved_strategies
ChatGPTThe user's saved strategies (Workspace > Strategies), with their configuration and performance. Reads the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
list_watchlist
ChatGPTThe user's watchlist. Reads the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
remove_from_watchlist
ChatGPTRemove an item from the watchlist (item_id from list_watchlist). Deletes from the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
save_screener_from_answer
ChatGPTSave the screen of an ask_financial_ai answer to Workspace > Screeners, with its result rows, as the website's Save screener button does. It is saved inactive. Changes the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
save_strategy_from_answer
ChatGPTSave the backtested strategy of an ask_financial_ai answer to Workspace > Strategies, as the website's Save strategy button does (regular or intraday). It is saved inactive. Changes the signed-in user's thefinancial.ai account. If the result has status "in_progress", call this tool again with only {"job": ...} to collect it.
screen_stocks
ChatGPTUse this when the user wants to find, rank or list stocks, ETFs or crypto meeting conditions (valuation, growth, margins, technicals, market cap, sector, index membership, revenue geography) or asks what to buy within a universe. Answers from thefinancial.ai's licensed market data, current to the latest close. Pass the user's request verbatim as question. Same protocol as ask_financial_ai: while status is "in_progress", call this tool again with only {"job": ...}.