FactSet

Connect your AI agents to FactSet.

Available Tools

get_consensus_estimates

Get Wall Street consensus estimates. Returns mean, median, high, low, and count for metrics like EPS, revenue. Requires FactSet IDs - use match_entity first.

get_actuals

Get actual reported values for financial metrics. Compare actuals vs estimates for earnings analysis. Requires FactSet IDs - use match_entity first.

get_surprise_history

Get earnings surprise history showing beat/miss vs consensus. Returns actual EPS, estimate, surprise amount, and percentage. Requires FactSet IDs.

get_analyst_ratings

Get buy/hold/sell ratings distribution and price targets. Returns rating counts, consensus score, and target prices. Requires FactSet IDs - use match_entity first.

get_guidance

Get company-issued guidance. Returns management’s outlook with low, high, and midpoint values for revenue, EPS, etc. Requires FactSet IDs - use match_entity first.

get_calendar_events

Get upcoming/past company events (earnings calls, conferences, investor days). Filter by company, date range, event type. Returns event times, dial-in info.

get_transcripts

Get earnings call transcripts. Returns full text with speaker attribution, Q&A sections. Filter by company, date range. Corrected transcripts available within 24hrs.

get_fundamentals

Get fundamental financial metrics.

get_company_profile

Get company profile including business description, industry, headquarters, website, employees, and CEO. Requires FactSet IDs - use match_entity first.

get_financial_statements

Get income statement (IS), balance sheet (BS), or cash flow (CF) statement data. Returns last 4 years of data. Requires FactSet IDs - use match_entity first.

get_fundamental_metrics

List available fundamental metrics by category.

get_segments

Get business or geographic segment breakdown. Returns revenue, operating income, and assets by segment. Requires FactSet IDs - use match_entity first.

get_deals

Search M&A deals by company, date range, deal status, or deal type. Returns deal value, buyer/target names, announcement dates. Covers 500K+ global deals since 1992.

get_deal_details

Get detailed M&A deal info by deal ID. Returns full terms, advisors, financing details, timeline. Use get_deals first to find deal IDs.

get_security_holders

Get institutional holders of a security. Returns fund names, shares held, % ownership, filing dates. Filter by holder type (institutions, insiders, funds).

get_fund_holdings

Get securities held by a fund. Returns positions, market values, % of portfolio. Filter by asset type (equity, fixed income). Limited to top_n holdings (default: 50).

get_people_profiles

Get executive/person profiles by FactSet People ID. Returns name, title, biography, contact info. Use get_company_people first to find person IDs for a company.

get_company_people

Get executives, board members, and key personnel for a company. Returns names, titles, and FactSet People IDs. Use company ticker or FactSet entity ID.

get_security_prices

Get OHLC prices for securities. Requires FactSet IDs - use match_entity first to find them. Returns open, high, low, close, volume by date. Supports date ranges and frequency options.

get_security_returns

Get total returns for securities including dividend reinvestment. Requires FactSet IDs - use match_entity first. Use for performance analysis and benchmarking.

get_dividends

Get dividend history for securities. Returns ex-date, pay-date, record-date, and amount. Requires FactSet IDs - use match_entity first. Use for income analysis.

get_splits

Get stock split history for securities. Returns split ratio, effective date, and description. Requires FactSet IDs - use match_entity first.

get_market_value

Get market capitalization and shares outstanding for securities. Requires FactSet IDs - use match_entity first. Use for valuation and size analysis.

validate_credential

Validate FactSet API credentials by making a test request. Returns success status and message.