TipRanks

Recent unusual option trades for an underlying (size/sweep alerts). Returns the most recent `limit` flagged trades with the side, strike, expiry, size, and notional value. Useful for spotting large bullish or bearish positioning. Args: ticker: Underlying ticker (e.g. 'AAPL'). limit: Max trades to return (default 25).

Peer/competitor companies for a stock, with comparative metrics for side-by-side analysis. Read-only, no side effects. Use to find and compare a company against similar names (competitors, same-sector peers). For that company's own data use get_assets_data; for a sector-wide breakdown use get_sector_analysis.

Returns a specific politician's stock trades or holdings. First call get_politicians to find the politicianId. Args: politicianId: Politician ID from get_politicians activity: 'trades' or 'holdings'

Returns the list of politicians tracked for trading activity. Returns: name, party, state, position, net worth, profile.

Returns asset allocation by type/country/top stocks and distribution by sector, market cap, dividend yield, beta, and P/E. Args: portfolio_id: One of the IDs returned by list_my_portfolios.

Returns all holdings for one of your TipRanks portfolios. Per holding: ticker, shares, price, cost basis (AvgExecutionPrice), P/E ratio, dividend yield, market cap, sector, country, 52-week high/low, percentage of portfolio, beta, EPS. Plus total value, cash, stock count. Args: portfolio_id: One of the IDs returned by list_my_portfolios.

Returns lifetime / 1mo / 6mo / 12mo / YTD returns, Sharpe ratio, and a monthly-return time series. The monthly history field is chart-ready — a list of {month, return} points suitable for direct plotting. Args: portfolio_id: One of the IDs returned by list_my_portfolios.

Returns full performance: stats, gains, best trade, recent activity, a daily-yield time series benchmarked against S&P 500 (chart-ready — aligned dates with portfolio and benchmark yield columns, plot directly as overlaid lines), monthly returns, risk profile, beta, dividend yield/amount. Args: portfolio_id: One of the IDs returned by list_my_portfolios.

Recent Wall Street analyst rating actions on a single stock, covering the trailing 12 months (newest first). `ratings` holds one row per analyst, their latest rating, newest first. Each row carries the analyst's name, expertUID and firm, the rating (Buy/Hold/Sell), the action (initiated/upgraded/downgraded/reiterated/ maintained), recommendationDate and timestamp, the price target in its own currency (priceTarget, priceTargetCurrencyCode) and converted (convertedPriceTarget, convertedPriceTargetCurrencyCode), and the analyst's TipRanks credibility (numOfStars 0-5, rank, successRate as a fraction, excessReturn as the average return) plus the source article title/quote. The response is size-bounded, so a long list comes in pages: when rows are left out the result carries `nextOffset`; call again with that offset for the next page, until a result has no `nextOffset`. `totalRatings` is the full count. The source returns at most the 100 newest ratings; when it hit that limit the result carries `feedLimit`, and older ratings are not available from this tool. `counts` gives exact last30Days / last90Days / last12Months totals (analysts whose latest rating falls in the window, split buy/hold/sell) over every rating fetched, as of `asOf`; answer 'how many analysts rated X in the past month' from `counts`, which cover every page. For the aggregate consensus and average/best price target, use get_assets_data instead. Args: ticker: Stock ticker (e.g. 'NVDA', 'AAPL'). offset: Index of the first rating to return in the newest-first list (default 0); pass the previous result's `nextOffset`. Returns: {ticker, asOf, totalRatings, counts, offset, ratings, and nextOffset when more remain}. recommendationDate is a 'MM/DD/YYYY' string; numOfStars is the analyst's 0-5 TipRanks star rating.

Returns sector-level analysis for all 11 US sectors: average P/E, analyst upside, buy ratio, stock count. Sorted by average analyst upside.

TipRanks-generated catalyst summary explaining why a stock is moving. Each entry: {ticker, price_move, summary, sentiment, updated} where sentiment is 'positive' | 'neutral' | 'negative' and price_move, present once today's session has traded, is the stock's actual change today from the live quote. Use to explain today's move for a specific stock. Args: tickers: Comma-separated tickers (e.g. 'AMZN' or 'AMZN,NVDA').

Historical daily closing prices for up to 5 stocks or ETFs. Per ticker: {ticker, period, series:[{date, price}], summary} with summary fields first_price, last_price, change_pct, high, low, trading_days. Series is downsampled to ~250 evenly-spaced points (latest point always retained) so the payload stays small for charting. `period` must be one of: 1m, 3m, 6m, ytd, 1y, 2y, 3y, 5y, all. Args: tickers: Comma-separated tickers, up to 5 (e.g. 'AAPL,MSFT'). period: Lookback window (default 'ytd').

Real-time price quote for one or more stocks or ETFs. Returns price, intraday OHLC, day change (amount + percent), volume, previous close, market cap, currency, exchange, and market-state flags (is_market_open / is_premarket / is_after_market). When extended-hours data is present, the entry includes a `pre_post_market` block — when the regular session is closed, that's the freshest price. For forex pairs use get_forex_quote; this endpoint is stocks/ETFs only. Args: tickers: Comma-separated tickers (e.g. 'AAPL' or 'AAPL,MSFT,NVDA').

Returns the stock-split calendar with split ratios and direction (Forward / Reverse). Use for upcoming splits, reverse-split alerts, historical split lookup. Args: fromDate: Start date YYYY-MM-DD (default: 30 days ago) toDate: End date YYYY-MM-DD (default: 30 days from now) type: Optional filter — 'Forward' or 'Reverse' (case-insensitive). Empty string returns both. limit: Max rows (default: 25, max: 100) ticker: Optional single symbol. Widen fromDate to search a company's history — the default window is only today ± 30 days. Returns: { totalCount, data: [{ ticker, companyName, effectiveDate, type, splitRatio, splitRatioText }] }. A filtered call (ticker or type) also returns `matched` and `window`: `totalCount` is every split in the window, `matched` how many passed the filter. The window is read in full before filtering, so an empty result means there genuinely are none rather than that the first page held none.

Returns RSI, MACD, Stochastics, ADX, moving averages, and pivot points for stocks and ETFs. Covers stocks and ETFs alike (e.g. 'NVDA', 'SPY', 'QQQ', 'VTI') with the same payload shape. For an ETF's analyst consensus, forecast, holdings or exposures, use get_etf_analysis, get_etf_forecast, get_etf_top_stocks, or get_etf_exposures. Args: tickers: Comma-separated stock or ETF tickers (e.g. 'NVDA' or 'NVDA,SPY'). timeFrame: '1m','5m','15m','30m','1h','5h','day','3d','week','2w','month' (default: 'day') '5h' is slow upstream: request it for one ticker per call. Returns: summary scores, oscillators (RSI, MACD, Stochastics, ADX, CCI, Williams %R, ATR, ROC), moving averages, and pivot points. Labels are strings. indicator: "Buy", "Neutral" or "Sell" (null on ATR and pivot points). scoreScale: "StrongBuy", "Buy", "Neutral", "Sell" or "StongSell" (the upstream's own spelling).

Upcoming and recent earnings dates for a specific stock — scheduled report dates with EPS/revenue estimates where available. Read-only, no side effects. Use this to find when a company reports. For past actual-vs-estimate results use get_earnings_history; for a cross-market schedule use get_earnings_calendar.

Returns top-performing hedge fund managers ranked by success rate and returns. Args: num: Number of managers to return (default 10, max 100 — the upstream returns 100 for anything higher)

Returns stocks most recommended by the best-performing analysts (by analyst track record) in one market. Args: num: Number of results sector: Sector filter (financial, healthcare, technology, etc.) or empty for all country: 'US', 'Canada', 'UK', 'Germany', 'France', 'Spain', 'Italy', 'Netherlands', 'Switzerland', 'Australia', 'Singapore', 'Japan', 'Israel'; any other country returns no_match. NOTE: UK tickers use GB: prefix but country param is 'UK'.

Returns up to 10 stocks with the highest TipRanks Smart Score (perfect 10 / Outperform) in one market. Args: num: Number of results; the feed returns at most 10 whatever this asks sector: Keeps the rows of that top-10 list in this sector, or empty for all country: 'US', 'Canada', 'UK', 'Germany', 'Spain', 'Australia', 'Singapore', 'HongKong', 'Global'; any other country returns no_match. NOTE: UK tickers use GB: prefix but the country param is 'UK'.

Returns currently trending stocks that recently received analyst ratings. Args: num: Number of results (default 20) filter: exactly one of 'analysts', 'bloggers', 'both'. Anything else is refused — the feed would otherwise answer it with the 'both' list. daysAgo: Days to look back: 3, 7, or any number from 30 up. Every other value (1, 2, 14…) is rejected by the feed. Default 7. Pass 30 or more when filtering by sector or country to ensure enough results — narrow windows often return fewer than 5 stocks in a specific sector. trendingType: exactly 'best-rated' or 'worst-rated' (empty for all). Anything else is refused — the feed would otherwise return the unranked list. country: 'US','Canada','UK','Germany','Israel','Australia' etc. sector: One of energy, financial, general, healthcare, industrials, services, technology, utilities. Empty for all sectors. This feed answers a sector it does not recognise with financial stocks rather than an error, so anything outside that list comes back refused instead. Rows returned for 'energy' are energy companies (Exxon, Chevron, BP) even though the feed tags them UTILITIES. Returns: ticker, SmartScore, analyst/blogger sentiment, hedge fund trend, price target, buy/hold/sell counts per stock.

List the portfolios you authorized this connector to access. Returns the portfolios that were on your TipRanks account at the time you signed in, each with its id and name. If you've added or renamed portfolios since, re-authorize to refresh.