Tools for your AI app
Every tool Theta Vantage gives a connected AI app, what each one is for, and which plan opens it, generated from the same rules the app enforces.
Once you connect your AI, your app can call the tools below. Each is one of Theta Vantage's own features, the same one the pages and Athena use, so an answer in your app matches the page. You don't call them by name: ask in plain words and the app picks the tool. The names are what your app shows when it uses one.
A tool your plan doesn't open isn't listed to your app. Without an account an app has no tools until you sign in.
Dealer positioning
| Tool | Free | Pro |
|---|---|---|
positioning_summaryThe overall picture: the regime, zero gamma, the walls, total gamma, vanna, charm, and dealer delta, the nearest expected move and max pain, and what changed, with the read. | SPX, SPY, QQQ, and IWM · All expirations together | Any ticker |
positioning_levelsThe levels drawn on the session's price: zero gamma, the walls, the major strikes, max pain, and the expected move. | SPX, SPY, QQQ, and IWM · All expirations together | Any ticker |
positioning_key_levelsSpot, zero gamma, the call and put walls, max pain, and the expected move, each with its distance from spot. | SPX, SPY, QQQ, and IWM · All expirations together | Any ticker |
exposure_gamma_profileTotal dealer gamma recomputed at prices around spot, with zero gamma and the walls. | SPX, SPY, QQQ, and IWM · All expirations together | Any ticker |
exposure_by_strikeGamma, vanna, charm, or dealer delta at each strike, split into calls and puts. | SPX, SPY, QQQ, and IWM · All expirations together · Gamma only | Any ticker |
exposure_heatmapDealer exposure on a grid of strikes: by expiration, or intraday through one of the last five sessions. | SPX, SPY, QQQ, and IWM · All expirations together · By expiration only · Gamma only | Any ticker |
options_max_painMax pain for each expiration, with its open interest. | SPX, SPY, QQQ, and IWM · All expirations together | Any ticker |
options_expected_moveThe expected move for each expiration, in dollars and as a price range, with the straddle. | SPX, SPY, QQQ, and IWM · All expirations together | Any ticker |
options_expirationsThe listed expirations with their settlement, days to expiry, and cycle. | SPX, SPY, QQQ, and IWM | Any ticker |
price_barsPrice bars for a stock's extended session (04:00-20:00 ET) or an index's regular session, with moving averages and RSI. | SPX, SPY, QQQ, and IWM · 15-minute candles and longer | Any ticker |
Options tools
| Tool | Free | Pro |
|---|---|---|
options_chainQuotes, volume, open interest, IV, and greeks by strike, for whole expirations or a few named strikes. | SPX, SPY, QQQ, and IWM · Expirations within 45 days | Any ticker |
options_contract_statsOne contract's trading over recent sessions, split by trades at the ask, the mid, and the bid. | SPX, SPY, QQQ, and IWM | Any ticker |
options_credit_spreadsBull put and bear call spreads by expiration and short strike, sized to your collateral. | SPX, SPY, QQQ, and IWM · Expirations within 45 days | Any ticker |
options_chain_summaryEvery listed expiration on one line: expected move, IV, volume, open interest, and put/call. | SPX, SPY, QQQ, and IWM | Any ticker |
options_strike_selectionShort puts and calls for one expiration, ranked by yield, breach rate, the risk profile, and delta, with the reasons. | SPY only · A 3-row preview | Any ticker |
options_strike_ladderThe strike selector's price ladder: prices around spot with the expiration's gamma and its levels. | — | Included |
income_picksYour wheel and income book priced: covered calls and cash-secured puts for each ticker, with totals. | A preview: a sample book of 3 Free tickers at the defaults | Included |
income_pickOne ticker's covered call and cash-secured put for given shares and cash. | — | Included |
strategy_templatesThe 48 named strategies, from novice to expert, with their legs and outlook. | Included | Included |
strategy_seedBuilds a named strategy at the current prices and prices it to expiration. | SPX, SPY, QQQ, and IWM | Any ticker |
strategy_evaluatePrices any position across prices and dates: credit or debit, max profit and loss, breakevens, chance of profit. | SPX, SPY, QQQ, and IWM | Any ticker |
Flow and volatility
| Tool | Free | Pro |
|---|---|---|
flow_listLarge option trades across the market, today or in the last 30 days, with filters and presets. | A preview: the last session's 10 largest SPY flows, before today | Included |
flow_statsTotals over a session's flows: the top symbols, each kind, and the bullish and bearish split. | — | Included |
flow_premium_driftNet premium drift: net call and net put premium through a session, or 5 or 10 sessions side by side with call − put and net volume, and the bull and bear crosses. | — | Included |
volatility_iv_rankIV rank, IV percentile, the regime, and IV against realized volatility over a lookback. | SPX, SPY, QQQ, and IWM | Any ticker |
volatility_historical_moveHow far the stock has typically moved to an expiration, beside the expected move, with past moves. | SPX, SPY, QQQ, and IWM | Any ticker |
Research
| Tool | Free | Pro |
|---|---|---|
company_profileA company's profile, ratios, next earnings date, and latest report against estimates. | Included | Included |
company_financialsIncome statement, balance sheet, and cash flow for the last eight quarters or years. | Included | Included |
company_eventsEarnings, dividends, splits, and SEC filings, most recent first. | Included | Included |
company_newsRecent headlines for a stock or fund. | Included | Included |
earnings_calendarThe market's earnings calendar for a month, and one day's reports. | Included | Included |
earnings_nextWhen a company reports next, with estimates and the move options price through it. | Included | Included |
Your workspace
| Tool | Free | Pro |
|---|---|---|
watchlist_getYour watchlist with last prices and changes. | Included | Included |
watchlist_addAdds a ticker to your watchlist. | 25 watchlist tickers | 200 watchlist tickers |
watchlist_removeTakes a ticker off your watchlist. | Included | Included |
brief_watchlistA brief on your watchlist in one call: each ticker against its levels, what changed since the close, IV rank, earnings ahead, and watchers near firing. | Included | Included |
brief_morning_levelsMorning levels for one ticker: the regime, zero gamma, the walls, max pain, and the expected move, what moved since the close, and the headlines. | SPX, SPY, QQQ, and IWM | Any ticker |
brief_close_recapThe close for SPX, SPY, QQQ, and IWM: each one's move and range, what changed in its positioning over the session, and the market's headlines. | Included | Included |
brief_ticker_spotlightWhere one ticker's positioning stands now: the levels, IV and IV rank, earnings ahead, the session's largest flows, and the headlines. | SPX, SPY, QQQ, and IWM | Any ticker |
brief_earnings_reactionA company's last report against estimates and how the stock and its options reacted: the move against the move priced, IV before and after, and the levels now. | — | Included |
watchers_listYour watchers and whether each is running. | Included | Included |
watchers_createWrites a watcher from a rule, shows it to you, and saves it once you agree. | 1 watcher | 25 watchers |
watchers_deleteDeletes one of your watchers. | Included | Included |
alerts_listThe alerts your watchers sent, newest first, with their explanations. | Included | Included |
alerts_deleteDeletes alerts you name, or every alert, or one watcher's. The watcher's count of alerts stays. | Included | Included |
Search and preferences
| Tool | Free | Pro |
|---|---|---|
tickers_searchFinds tickers by symbol or company name, and whether they list options. | Included | Included |
preferences_getYour default risk profile and target delta for choosing a strike. | Included | Included |
What's not here
Theta Vantage has no public API and no API keys to buy. Your AI app reaches these tools by signing in to your account. Account, billing, and admin tools, and the page-only controls (live streams, editing a strategy leg by leg, watchlist tags), stay in the app.