TipRanks

Returns the financial-blogger consensus for a stock plus the underlying blogger articles. Distinct from get_recent_analyst_ratings (Wall Street analysts) and get_investor_sentiment (TipRanks crowd positioning). Args: ticker: Stock ticker (e.g. 'AAPL') limit: Max blogger articles to return (default 20, max 50) Returns JSON: {ticker, company, consensus, articles}. - consensus: {bullish_pct, bearish_pct, neutral_pct, bullish_count, bearish_count, neutral_count, score, avg}. - articles: [{blogger, title, url, site, date}] (newest first).

get_blogger_sentiment

Returns the discrete bull and bear key points for stocks — the individual sentence bullets TipRanks shows on its stock pages, each tagged with a topic. Args: tickers: Comma-separated tickers (e.g. 'AAPL,TSLA') Returns JSON: {"data": [...one entry per ticker...]}. Each entry has: - ticker, updatedOn - bullish: list of bullish point sentences - bearish: list of bearish point sentences - key_points: list of {sentiment, topic, point} for the full set.

get_bulls_bears_summary

Cached equities market sentiment snapshot. Returns {overallSentiment, atmosphere, keyThemes, tailwinds, headwinds}. Generated by TipRanks' AI pipeline with web search, refreshed every ~4 hours; this endpoint reads the cache only and does not trigger regeneration. If no recent cache exists, returns {"status": "unavailable"}. The content is AI-generated commentary, not authoritative TipRanks market data — present it as such to end users.

get_market_commentary

Daily OHLC price history for a commodity, covering the whole date range you ask for. Chart-ready: while the range fits in one response, each row is the price feed's own daily row — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordered for direct plotting as a price history. A range too long to return day by day is aggregated into coarser OHLC bars rather than cut short. `interval` names which (weekly/monthly/quarterly/yearly), each bar spans `date` to `endDate`, and a bar's high/low are that period's real extremes. Aggregated bars carry the same fields except `vwap`, which the feed defines per session only. Re-request a narrower from_date/to_date for daily rows. `summary` always describes the FULL requested window, computed from the daily data: its first and last close with dates, its high and low with dates, and the trailing changes the window reaches back far enough to support. Base any "starting price", "a year ago" or "period high/low" claim on `summary`, or on a bar that is actually present. `summary.windowHigh`/`windowLow` describe THIS window. A quote tool's yearHigh/yearLow are the feed's trailing range, roughly the past 12-13 months — a different period — so label those as trailing-year figures. For the current level alone, call get_commodity_quote. Args: symbol: Commodity symbol (e.g. 'GCUSD' for gold) from_date: Start date YYYY-MM-DD (optional) to_date: End date YYYY-MM-DD (optional)

get_commodity_historical

Returns the real-time price quote for a specific commodity. Common symbols: GCUSD (gold), SIUSD (silver), CLUSD (crude oil), NGUSD (natural gas), HGUSD (copper), PLUSD (platinum). yearHigh / yearLow are the feed's trailing-year range, roughly the past 12-13 months: call them trailing-year figures. For a year-to-date or calendar-year change, a dated extreme or an exact 52-week figure use get_commodity_historical, since the quote does not date its extremes. Args: symbol: Commodity symbol (e.g. 'GCUSD' for gold)

get_commodity_quote

Returns company-specific operational KPIs: segment revenue, geographic breakdown, active users/devices, gross margins by type, opex breakdown. Full history runs back to 2014 and is large, so this returns the most recent `count` periods per metric by default — pass count=0 for the full history, or `group` to fetch a single group. Args: ticker: Stock ticker (e.g. 'AAPL', 'MSFT') count: Most-recent periods per metric (default 8, max 40; 0 = full history) group: Optional single group by slug or title Returns JSON: {"ticker", "lastUpdated", "groups": [...]}. Each group has slug, title, and metrics: [{title, slug, unit, series: [{periodEnd, value}]}].

get_company_kpis

Returns market-wide performance for a specific country: average returns, sector breakdown, top/bottom performers. Args: country: Country code: 'us', 'ca', 'gb', 'de', 'il', 'au', 'hk', 'sg', etc.

get_market_performance

Returns crowd / retail investor sentiment for a stock. Args: ticker: Stock ticker (e.g. 'NVDA') Returns JSON with these top-level keys: - investorStatsOverview: stats aggregated across ALL TipRanks portfolios that hold the ticker. Fields: * numberOfPortfolios: total active portfolios on the platform. * portfoliosHoldingStock: how many of them hold THIS ticker. * averageAllocation: average % allocation among holders (decimal). * percentOverLast30Days / percentOverLast7Days: change in the count of holders over the window (decimal; 0.013 = +1.3%). * investorScore: TipRanks' 0-1 score of how confident "the crowd" is on this stock; higher = more bullish positioning. * sectorAverageScore: investorScore averaged across the sector, for comparison. * sentiment: bucketed label — one of "VeryNegative", "Negative", "Neutral", "Positive", "VeryPositive". * sectorAverageSentiment: same bucket, sector-wide. - bestInvestorStatsOverview: same fields, but restricted to "Best Investors" — TipRanks users with top-decile portfolio returns over the trailing window. If investorStatsOverview and bestInvestorStatsOverview diverge (e.g. crowd is Positive but best investors are Negative), that's the headline signal. - ageDistribution: holders split by TipRanks account-tenure tier (NOT the investor's biological age): * eldest: oldest accounts on the platform * midRange: middle tier * youngest: newest accounts Each has percentHolders, last30DaysChange, last7DaysChange, and per-bucket averages (averageBeta, averageMonthlyReturn, dividendYield, averagePeRatio). - investorsAlsoBought: top other stocks held by people who hold this one (each: ticker, companyName, averageHoldingSize, lastSevenDayChange, lastThirtyDayChange, sector, sectorName, score, sentiment, marketCap, marketCapCurrencyCode). - investorsAlsoBoughtYoungest / MidRange / Eldest: same shape, filtered to that account-tenure bucket. Often shorter or empty for stocks held mostly by one cohort.

get_investor_sentiment

Daily OHLC price history for a cryptocurrency, covering the whole date range you ask for. Chart-ready: while the range fits in one response, each row is the price feed's own daily row — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordered for direct plotting as a price history. A range too long to return day by day is aggregated into coarser OHLC bars rather than cut short. `interval` names which (weekly/monthly/quarterly/yearly), each bar spans `date` to `endDate`, and a bar's high/low are that period's real extremes. Aggregated bars carry the same fields except `vwap`, which the feed defines per session only. Re-request a narrower from_date/to_date for daily rows. `summary` always describes the FULL requested window, computed from the daily data: its first and last close with dates, its high and low with dates, and the trailing changes the window reaches back far enough to support. Base any "starting price", "a year ago" or "period high/low" claim on `summary`, or on a bar that is actually present. `summary.windowHigh`/`windowLow` describe THIS window. A quote tool's yearHigh/yearLow are the feed's trailing range, roughly the past 12-13 months — a different period — so label those as trailing-year figures. For the current level alone, call get_crypto_quote. Args: symbol: Cryptocurrency symbol (e.g. 'BTCUSD' for Bitcoin) from_date: Start date YYYY-MM-DD (optional) to_date: End date YYYY-MM-DD (optional)

get_crypto_historical

Real-time crypto quotes: the largest coins, each with a display name. The feed carries 4,771 coins in alphabetical order, which is far more than one response can hold — so this returns `limit` of them ordered by market capitalisation, largest first, and the response states how many were left out. Pass `symbols` for specific coins, or call get_crypto_quote for a single one. Read `note` before summarising: it says how many coins the slice covers out of how many exist, so a "top coins" answer is not mistaken for the whole market. `volume` on a crypto row is the source venue's own figure and is not a common unit across coins — some rows count coins, others quote-currency turnover. It does not rank the market and coins cannot be compared on it. Args: symbols: Comma-separated coins (optional; overrides the ranked slice) limit: How many ranked coins to return (optional)

get_all_crypto_quotes

Latest cryptocurrency news — a market-wide feed across all coins (not filtered to a single asset), ordered newest-first: article headlines, snippets, and source URLs. Read-only, no side effects. Use for broad crypto/market headlines. For news about a specific holding use get_assets_news; for the general (non-crypto) editorial feed use get_latest_news.

get_crypto_news

Returns the real-time price quote for a specific cryptocurrency. Common symbols: BTCUSD (Bitcoin), ETHUSD (Ethereum), SOLUSD (Solana), BNBUSD (BNB), XRPUSD (XRP), ADAUSD (Cardano), DOGEUSD (Dogecoin). yearHigh / yearLow are the feed's trailing-year range, roughly the past 12-13 months: call them trailing-year figures. For a year-to-date or calendar-year change, a dated extreme or an exact 52-week figure use get_crypto_historical, since the quote does not date its extremes. Args: symbol: Cryptocurrency symbol (e.g. 'BTCUSD' for Bitcoin)

get_crypto_quote

Dividend payment history for a ticker. Chart-ready: includes the current snapshot (yield %, payout ratio, frequency, annualised payout) plus two time series — a per-payment list [{ex_date, pay_date, amount, yield_pct, is_special, ...}] (newest first, capped at `count`) and an annual_totals list [{year, amount, yield_pct}] suitable for a yearly bar chart. All yields are emitted as percentages (4.5 = 4.5%), so plots don't need to know which underlying field used decimal vs. percentage encoding. Use for: "AAPL dividend history", "yield trend over 5 years", "dividend growth chart", "is the payout sustainable". Args: ticker: Stock ticker (e.g. 'AAPL', 'JNJ'). count: Number of most-recent individual payments to return (default 16, max 100). The annual_totals series is always returned in full.

get_dividend_history

Returns upcoming earnings dates across all stocks for a date range. Args: fromDate: Start date YYYY-MM-DD (default: today) toDate: End date YYYY-MM-DD (default: 14 days from now) exchange: Optional exchange filter, e.g. 'US' for US-only results

get_earnings_calendar

Returns the most recent earnings call summary for a ticker — management guidance text, overall call sentiment (positive / neutral / negative with a one-line rationale), and AI-extracted highlights and lowlights from the call as {title, content} bullets. This is a structured summary derived from the call, not the raw transcript text. Useful for "what did management say about X on the last call", "was the most recent call bullish or bearish", or "summarise the highlights from MSFT's latest earnings". Only the most recent quarter is stored per ticker; for historical EPS actual-vs-estimate series use get_earnings_history. Args: ticker: Stock ticker (e.g. 'AAPL', 'NVDA'). Returns: { ticker, fiscal_year, fiscal_quarter, guidance, sentiment: { label, summary }, highlights: [ { title, content }, ... ], lowlights: [ { title, content }, ... ] }

get_earnings_call_summary

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.

get_ticker_earnings

Quarterly earnings time series for a ticker. Chart-ready: each quarter row is {period, report_date, actual_eps, estimate_eps, eps_surprise_pct, prior_year_eps, eps_yoy_change_pct, actual_revenue, estimate_revenue, revenue_surprise_pct, net_income, ...}, ordered oldest-first so a bar chart of actual vs. estimate EPS, or a YoY trend line, plots directly. Also returns next_quarter — the upcoming scheduled report with the consensus estimate, low/high estimate band, and expected report date — for forward-looking charts. Use for: "AAPL earnings history", "earnings surprise trend", "did NVDA beat last quarter", "EPS beat/miss the past 4 quarters". Args: ticker: Stock ticker (e.g. 'AAPL', 'NVDA'). quarters: Number of most-recent reported quarters to return (default 8, max 40).

get_earnings_history

Returns upcoming and recent economic events (Fed meetings, jobs reports, CPI, GDP). Defaults to US events at High/Medium impact only because the raw feed includes hundreds of low-impact items from every country. Args: daysBack: Days to look back (default 0) daysForward: Days to look forward (default 7) fromDate: Start date ISO format (alternative to daysBack) toDate: End date ISO format (alternative to daysForward) countries: Comma-separated country names to keep (default 'US'). Pass an empty string to disable the country filter. Common values: 'US','UK','Germany','Japan','China','Canada','France'. impact: Comma-separated impact levels to keep (default 'High,Medium'). Valid values: 'High','Medium','Low'. Pass empty to keep all levels. limit: Max events returned after filtering (default 50, max 200). Returns: { totalMatched, returned, filters, economicCalendar: [...] }.

get_economic_calendar

Financial statements time series for a ticker, chart-ready. Each period is a flat ~25-field object spanning the income statement (revenue, gross / operating / EBITDA / net margins, EPS, R&D), the balance sheet (total assets, total debt, total equity, net debt, cash + short-term investments), the cash flow statement (operating cash flow, free cash flow, capex, dividends paid, buybacks), and two computed ratios (current ratio, debt-to-equity). Margins are emitted as percentages — gross_margin_pct of 49.27 means 49.27%. Cash outflows (dividends_paid, buybacks) are returned as negative numbers, matching the source convention. Use for: "AAPL revenue and FCF over the last 10 years", "show margins trend", "is net debt rising", "EPS growth", "R&D as % of revenue". Args: ticker: Stock ticker (e.g. 'AAPL', 'NVDA'). period: 'annual' (default), 'quarterly', or 'ttm' (trailing twelve months). Annual periods extend ~9 years back; quarterly extends ~37 quarters back. count: Number of most-recent periods to return (default 5, max 40), ordered oldest-first inside the returned `periods` array.

get_financials

Daily OHLC price history for a forex pair, covering the whole date range you ask for. Chart-ready: while the range fits in one response, each row is the price feed's own daily row — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordered for direct plotting as an exchange-rate history. A range too long to return day by day is aggregated into coarser OHLC bars rather than cut short. `interval` names which (weekly/monthly/quarterly/yearly), each bar spans `date` to `endDate`, and a bar's high/low are that period's real extremes. Aggregated bars carry the same fields except `vwap`, which the feed defines per session only. Re-request a narrower from_date/to_date for daily rows. `summary` always describes the FULL requested window, computed from the daily data: its first and last close with dates, its high and low with dates, and the trailing changes the window reaches back far enough to support. Base any "starting rate", "a year ago" or "period high/low" claim on `summary`, or on a bar that is actually present. `summary.windowHigh`/`windowLow` describe THIS window. A quote tool's yearHigh/yearLow are the feed's trailing range, roughly the past 12-13 months — a different period — so label those as trailing-year figures. For the current level alone, call get_forex_quote. `volume` on a forex row is a per-venue tick count, not market turnover — FX is over-the-counter. Read it as a liquidity hint at best. Args: symbol: Forex pair symbol (e.g. 'EURUSD') from_date: Start date YYYY-MM-DD (optional) to_date: End date YYYY-MM-DD (optional)

get_forex_historical

Real-time forex quotes: the most-traded pairs, each with a display name. The feed carries 1,550 pairs in alphabetical order, which is far more than one response can hold — so this returns the most prominent `limit` of them (majors first, then by volume), and the response states how many were left out. Pass `symbols` for specific pairs, or call get_forex_quote for a single one. Read `note` before summarising: it says how many pairs the slice covers out of how many exist, so a "top pairs" answer is not mistaken for the whole market. `volume` on a forex row is a per-venue tick count, not market turnover — FX is over-the-counter and most pairs report 0. It does not rank the market. Args: symbols: Comma-separated pairs (optional; overrides the ranked slice) limit: How many ranked pairs to return (optional)

get_all_forex_quotes

Returns the real-time exchange rate quote for a forex pair. Common pairs: EURUSD, GBPUSD, USDJPY, USDCHF, AUDUSD, USDCAD. yearHigh / yearLow are the feed's trailing-year range, roughly the past 12-13 months: call them trailing-year figures. For a year-to-date or calendar-year change, a dated extreme or an exact 52-week figure use get_forex_historical, since the quote does not date its extremes. A pair quotes the BASE currency (first three letters) in units of the QUOTE currency (last three): USDHUF 320 means 1 USD = 320 HUF. A rising rate, or a rate above its priceAvg50 / priceAvg200, is the base strengthening against the quote. changePercentage is measured against previousClose as of the quote's timestamp. Spot FX is closed from Friday 17:00 to Sunday 17:00 New York time; a quote stamped in that window shows the change as of the last close, not a move made that day. Args: symbol: Forex pair symbol (e.g. 'EURUSD')

get_forex_quote

Hedge-fund share-count history for a ticker. Returns the most recent `limit` snapshots (max 60) plus a summary block (snapshot_count, first/last date and shares). Each row: {date, shares}. Sourced from quarterly 13F filings; lags by up to 45 days. For a snapshot of current sentiment without the timeseries, use get_assets_data and read hedgeFundSentimentData. Args: ticker: Stock ticker (e.g. 'AAPL'). limit: Max snapshots to return (default 60, max 60).

get_hedge_fund_holdings

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').

get_stock_prices

Daily OHLC price history for a major market index, covering the whole date range you ask for. Chart-ready: while the range fits in one response, each row is the price feed's own daily row — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordered for direct plotting as an index history. A range too long to return day by day is aggregated into coarser OHLC bars rather than cut short. `interval` names which (weekly/monthly/quarterly/yearly), each bar spans `date` to `endDate`, and a bar's high/low are that period's real extremes. Aggregated bars carry the same fields except `vwap`, which the feed defines per session only. Re-request a narrower from_date/to_date for daily rows. `summary` always describes the FULL requested window, computed from the daily data: its first and last close with dates, its high and low with dates, and the trailing changes the window reaches back far enough to support. Base any "starting level", "a year ago" or "period high/low" claim on `summary`, or on a bar that is actually present. `summary.windowHigh`/`windowLow` describe THIS window. A quote tool's yearHigh/yearLow are the feed's trailing range, roughly the past 12-13 months — a different period — so label those as trailing-year figures. For the current level alone, call get_index_quote. Takes the same index symbols and broker/CFD-name mapping as get_index_quote — e.g. ^NDX for 'US Tech 100' / 'Nasdaq 100', ^IXIC for 'Nasdaq Composite', ^GDAXI for 'Germany 40'. Args: symbol: Index symbol (e.g. '^GSPC' for S&P 500) from_date: Start date YYYY-MM-DD to_date: End date YYYY-MM-DD (defaults to today)

get_index_historical

Returns the real-time quote for a major market index. Index symbols: ^GSPC (S&P 500), ^NDX (Nasdaq 100), ^IXIC (Nasdaq Composite), ^DJI (Dow Jones), ^RUT (Russell 2000), ^GSPTSE (TSX), ^FTSE (FTSE 100), ^GDAXI (DAX 40), ^FCHI (CAC 40), ^STOXX50E (Euro STOXX 50), ^IBEX (IBEX 35), ^N225 (Nikkei), ^AXJO (ASX 200), ^AORD (All Ords), ^HSI (Hang Seng), ^STI (STI), ^BSESN (Sensex), ^VIX (VIX). Broker / CFD names map to the index they track (the same map the AI chat uses): 'US Tech 100' / 'NAS100' / 'USTEC' -> ^NDX; 'US 500' / 'SPX500' -> ^GSPC; 'Wall Street 30' / 'US 30' -> ^DJI; 'US 2000' / 'US Small Cap 2000' -> ^RUT; 'Germany 40' / 'GER40' -> ^GDAXI; 'UK 100' -> ^FTSE; 'France 40' -> ^FCHI; 'Euro 50' / 'EU50' -> ^STOXX50E; 'Spain 35' -> ^IBEX; 'Japan 225' -> ^N225; 'Australia 200' -> ^AXJO; 'Hong Kong 50' -> ^HSI. 'Nasdaq Composite' is ^IXIC; 'Nasdaq 100' and the Nasdaq 100 CFD names above are ^NDX — different indices at different levels, so quote the one the user named and name it. A bare 'Nasdaq' is ambiguous: say which one you quote. For an index not listed here (e.g. 'S&P 100'), call it by its own symbol — a listed index with a similar name is a different index. yearHigh / yearLow are the feed's trailing-year range, roughly the past 12-13 months: call them trailing-year figures. For a year-to-date or calendar-year change, a dated extreme or an exact 52-week figure use get_index_historical, since the quote does not date its extremes. Args: symbol: Index symbol (e.g. '^GSPC' for S&P 500)

get_index_quote

Individual corporate-insider (officers/directors, Form 4) transactions for a ticker, newest first. Each row: insider_name, role, is_officer, is_director, action (e.g. "Auto Sell", "Grant/Award/Other Acquisition"), side (buy/sell), shares, price (approximate — value / shares; the source has no exact price), value, date, filing_link (the SEC Form-4 URL), and insider_stars. This is corporate-insider activity (Form 4). For retail/individual investor sentiment, use get_assets_data and read investorActivity. Args: ticker: Stock ticker (e.g. 'AAPL'). limit: Max rows to return (default 30, max 100).

get_insider_transactions

Latest TipRanks news articles (newest first) from TipRanks's own editorial/wire feed — each with a text excerpt, unlike get_assets_news. Use for general market news (no ticker), news on a specific stock with a short summary of each story, or to browse a news category. This is also the tool for news from a specific PAST date range — pass from_date AND to_date together; the archive holds years of stories, so a past window is answerable here even though get_assets_news only reaches recent articles. Args: tickers: Optional comma-separated tickers to filter by (e.g. 'NVDA,AAPL'). Omit for general market news. category: Optional single category (see the field description). from_date: Optional 'YYYY-MM-DD' recency floor. limit: Max articles to return (default 20). to_date: Optional 'YYYY-MM-DD' inclusive upper bound. Results are newest-first, so from_date alone returns today's news rather than news from around that date — add to_date to scope a window. Returns a JSON list of {id, title, excerpt, author, category, date, url, tickers}. To read a full article, pass its url or id to get_article.

get_latest_news

Your current TipRanks MCP usage against the monthly tool-call quota. Reports calls used this calendar month, your limit, how many remain, your plan tier, and when the quota resets (UTC). Handy to check before running a large batch of calls. This call is free — it never counts against the quota. What counts: every tool call is metered once whether or not it returns data, so an unrecognised ticker or an invalid argument costs the same as a successful call. The connection handshake (initialize, tools/list and the other discovery calls) is never metered, and neither is this tool. Calls refused for being over the limit are refunded on both ladders, so `used` settles at the cap rather than climbing while a client retries. It can still read higher than `limit` when the ceiling FELL mid-month — a complimentary grant expiring or being revoked, or a paid MCP subscription lapsing — and there it is the count of calls genuinely served before the cap dropped.

get_my_usage

Contracts at one expiration, enriched with price + OI + volume. Each row: ticker (OCC), contract_type, strike, name, price, volume, open_interest, open_interest_change, change_percent, day_open / high / low, last_trade_date. Quotes are typically delayed ~15 minutes. Greeks and implied volatility are NOT exposed by this data source — do not fabricate them. Args: ticker: Underlying (e.g. 'AAPL'). expiration_date: One of the dates from get_options_expirations (YYYY-MM-DD). contract_type: '' for both, or 'call' or 'put'. strike_gte: Filter strikes >= this value (optional). strike_lte: Filter strikes <= this value (optional). limit: Max contracts to return (default 50).

get_options_chain

Snapshot one OCC contract — price, OI, intraday OHLCV, last trade. The contract_ticker is an OCC-format symbol like 'O:AAPL260520C00205000' (O: + underlying + YYMMDD + C/P + strike-in-thousandths-8-digits). The 'O:' prefix is optional. Quotes are typically delayed ~15 minutes. Greeks and implied volatility are not available from this data source. Args: contract_ticker: OCC contract symbol.

get_options_contract

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.

get_peers

Returns per-fund hedge-fund holdings and recent transactions for a ticker — which institutions hold it, how much each changed (bought/sold), the holding value, % of portfolio, and the fund's TipRanks rank/stars. Complements get_hedge_fund_holdings (the aggregate share-count timeseries). Args: ticker: Stock ticker (e.g. 'AAPL') limit: Max funds to return (default 25, max 100) Returns JSON: {ticker, company, sentiment, trend_action, trend_value, funds}. - funds: [{manager, institution, shares_change, direction, holding_value, pct_of_portfolio, as_of, rank, stars, is_active}].

get_hedge_fund_activity

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.

get_portfolio_analysis

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.

get_portfolio_holdings

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.

get_portfolio_overview

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.

get_portfolio_performance

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').

get_stock_quotes

Recent Wall Street analyst rating actions on a single stock, covering the trailing 12 months (newest first). Each row carries the analyst's name and firm, the rating (Buy/Hold/Sell), the action (initiated/upgraded/downgraded/reiterated/maintained), the price target, and the analyst's TipRanks credibility (numOfStars 0-5, rank, success rate, average return) plus the source article title/quote. For the aggregate consensus and average/best price target, use get_assets_data instead. Args: ticker: Stock ticker (e.g. 'NVDA', 'AAPL'). Returns: a list of rating actions. recommendationDate is a 'MM/DD/YYYY' string; numOfStars is the analyst's 0-5 TipRanks star rating.

get_recent_analyst_ratings

Returns recent news articles for tickers, aggregated from many news sites, each with a sentiment tag and source URL (headlines only — no article body). For general/market TipRanks news without a specific ticker, or for an article excerpt, use get_latest_news. This tool serves the CURRENT news window only: it returns each ticker's most recent articles, and from_date just trims that recent set. For news from a specific past date range, use get_latest_news with from_date + to_date, which searches the full archive. Args: tickers: Comma-separated ticker symbols count: Number of articles to return (default 10) from_date: Optional 'YYYY-MM-DD' recency floor (filtered on `date`). Returns JSON: {"assetNewsArticles": [...]}. Each entry: - ticker, companyName - sentiment: bucketed signal — one of "VeryPositive", "Positive", "Neutral", "Negative", "VeryNegative". Derived from TipRanks news-sentiment classifier on the article text. - siteName, url, title - date, addedOn, publishTime, articleTimestamp: redundant date fields. addedOn is when TipRanks ingested it; publishTime is the source's stated publication time. Prefer publishTime.

get_assets_news