SEC filings, company financials, holdings, earnings calls, stock prices, options and macro data.
io.github.daniel3303/equibles — Model Context Protocol (MCP) Server
This MCP server provides access to stock market and financial data for AI agents such as Claude and ChatGPT. Its catalog includes SEC filings, 13F institutional holdings, insider and congressional trades, earnings call transcripts, options chains, live quotes, IPO filings, and short interest, along with macro data and portfolio data.
Get each ticker's newest traded, settled daily close in USD, with one-session change, volume, and trailing 52-week closing range. Rows can have different dates while a session settles; use the Date column. Change is omitted when the immediately prior trading session is absent. Split-limited or partial 52-week ranges are marked in the response. This is settled history, not an intraday quote.
Parameters1
tickers
array
required
Ticker symbols (max 25). Class shares may use BRK-B or BRK.B.
Raw schema
{
"type": "object",
"properties": {
"tickers": {
"description": "Ticker symbols (max 25). Class shares may use BRK-B or BRK.B.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"tickers"
]
}
GetCftcPositioning
Get Commitments of Traders (COT) positioning data for a specific futures contract. Shows commercial and non-commercial positions over time. Values are contract counts from the legacy futures-only COT report (positions as of each Tuesday, published Friday). Use SearchCftcMarkets to find available market codes.
Parameters4
marketCode
string
required
CFTC market code, common contract name, or standard futures symbol (e.g., 067651, WTI, ES, Gold futures)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 1 year ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of reports to return (default: 52, max: 500). When the range holds more reports the newest are kept; rows are always listed oldest to newest.
Raw schema
{
"type": "object",
"properties": {
"marketCode": {
"description": "CFTC market code, common contract name, or standard futures symbol (e.g., 067651, WTI, ES, Gold futures)",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 1 year ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of reports to return (default: 52, max: 500). When the range holds more reports the newest are kept; rows are always listed oldest to newest.",
"type": "integer",
"default": 52
}
},
"required": [
"marketCode"
]
}
AddPortfolioLot
Record a user-confirmed purchase or sale in the caller's portfolio. Never infer or guess the instrument, quantity, price or date. For stock, pass ticker; a listing on another exchange is its MIC:TICKER symbol (e.g. XPAR:AIR, as ScreenStocks returns it). For an option, pass both its underlying ticker and verified OCC symbol; unknown or expired contracts are rejected. quantity is signed: positive for long shares/contracts, negative for short stock or written options. costPerUnit is always the positive per-share price or option premium, never the per-contract total, in the currency the listing trades in and in major units (London prices in pounds, not pence). Identical retries within the duplicate window return the existing lot instead of adding another.
Parameters8
portfolio
string
required
The portfolio to add to, by name.
ticker
string
required
Stock ticker, or MIC:TICKER for a listing on another exchange, e.g. XPAR:AIR. For an option, the UNDERLYING U.S. ticker, e.g. AAPL.
quantity
number
required
Signed size: shares for a stock, contracts for an option. Negative for a short sale or a written option.
costPerUnit
number
required
Price per share, always positive: paid for a long, received for a short. For an option, the premium per share (a $3.20 contract is 3.20, not 320). In the currency the stock trades in, in major units: London prices in pounds, not pence.
acquiredDate
string
required
The trade date, as yyyy-MM-dd. Cannot be in the future.
optionContract
string
optional
Optional. The OCC option symbol, e.g. O:AAPL260724C00110000. Provide it to record an option contract; omit it for shares.
note
string
optional
Optional. A short note from the user about this lot, up to 256 characters.
fxRate
number | null
optional
Optional. The broker's exchange rate on the trade, as units of the portfolio's currency per 1 unit of the stock's trading currency (e.g. 0.92 for EUR per USD). Only when the user states it; omit to convert at the official rate on the trade date.
Raw schema
{
"type": "object",
"properties": {
"portfolio": {
"description": "The portfolio to add to, by name.",
"type": "string"
},
"ticker": {
"description": "Stock ticker, or MIC:TICKER for a listing on another exchange, e.g. XPAR:AIR. For an option, the UNDERLYING U.S. ticker, e.g. AAPL.",
"type": "string"
},
"quantity": {
"description": "Signed size: shares for a stock, contracts for an option. Negative for a short sale or a written option.",
"type": "number"
},
"costPerUnit": {
"description": "Price per share, always positive: paid for a long, received for a short. For an option, the premium per share (a $3.20 contract is 3.20, not 320). In the currency the stock trades in, in major units: London prices in pounds, not pence.",
"type": "number"
},
"acquiredDate": {
"description": "The trade date, as yyyy-MM-dd. Cannot be in the future.",
"type": "string"
},
"optionContract": {
"description": "Optional. The OCC option symbol, e.g. O:AAPL260724C00110000. Provide it to record an option contract; omit it for shares.",
"type": "string",
"default": null
},
"note": {
"description": "Optional. A short note from the user about this lot, up to 256 characters.",
"type": "string",
"default": null
},
"fxRate": {
"description": "Optional. The broker's exchange rate on the trade, as units of the portfolio's currency per 1 unit of the stock's trading currency (e.g. 0.92 for EUR per USD). Only when the user states it; omit to convert at the official rate on the trade date.",
"type": [
"number",
"null"
],
"default": null
}
},
"required": [
"portfolio",
"ticker",
"quantity",
"costPerUnit",
"acquiredDate"
]
}
GetMarketStatus
Get the current US equity market status (NYSE/Nasdaq), evaluated in America/New_York: whether the market is open, the current session (pre-market, regular, after-hours, or closed), whether today is a full-day holiday or a 1:00 p.m. ET early close, today's regular and extended (pre-market/after-hours) trading hours, and the next open and next close. Backed by the exchange's curated holiday and early-close calendar, not a heuristic.
Parameters
No parameters.
Raw schema
{
"type": "object",
"properties": {}
}
GetMarketWideCongressionalActivity
Get the stocks members of Congress traded most over a trailing window, aggregated across EVERY member and ticker — 'what did Congress buy this week' without needing a ticker or a member name. The window is anchored on the DISCLOSURE (filing) date because the STOCK Act's general outside filing deadline is 45 days after a trade; late or amended records can arrive later. Each row aggregates one stock's disclosed trades: distinct members buying and selling, trade counts, estimated dollar flow per direction (each disclosed amount range's midpoint — members disclose a band, not an exact figure), the largest participants, and the latest filing and transaction dates. direction=buys ranks by estimated net buying, direction=sells by estimated net selling; chamber=senate/house narrows to one chamber. Use GetCongressionalTrades for one stock's underlying disclosures and GetMemberTrades for one member's.
Parameters4
days
integer
optional
Trailing disclosure window in days (default: 30, max: 365).
direction
string
optional
Ranking direction: 'buys' (most net congressional buying first, default) or 'sells' (most net selling first).
maxResults
integer
optional
Maximum number of stocks to return (default: 25, max: 200).
chamber
string
optional
Filter by chamber: 'senate' or 'house' (defaults to both).
Raw schema
{
"type": "object",
"properties": {
"days": {
"description": "Trailing disclosure window in days (default: 30, max: 365).",
"type": "integer",
"default": 30
},
"direction": {
"description": "Ranking direction: 'buys' (most net congressional buying first, default) or 'sells' (most net selling first).",
"type": "string",
"default": "buys"
},
"maxResults": {
"description": "Maximum number of stocks to return (default: 25, max: 200).",
"type": "integer",
"default": 25
},
"chamber": {
"description": "Filter by chamber: 'senate' or 'house' (defaults to both).",
"type": "string",
"default": null
}
}
}
GetWebDataFeed
Get the latest independently verified stored result for one of the caller's trackers, or the latest retained result at or before a requested timestamp. This is read-only, never triggers a live run, and preserves the last good result after a newer failure. To create or manage a tracker, tell the user to open the Equibles Portal and choose Dashboard → Trackers: https://www.equibles.com/trackers
Parameters2
dataFeed
string
required
The tracker name or full id shown by ListWebDataFeeds.
capturedAtOrBefore
string
optional
Optional ISO-8601 timestamp. Returns the newest retained verified capture completed at or before this instant. Omit it for the latest result.
Raw schema
{
"type": "object",
"properties": {
"dataFeed": {
"description": "The tracker name or full id shown by ListWebDataFeeds.",
"type": "string"
},
"capturedAtOrBefore": {
"description": "Optional ISO-8601 timestamp. Returns the newest retained verified capture completed at or before this instant. Omit it for the latest result.",
"type": "string",
"default": null
}
},
"required": [
"dataFeed"
]
}
ScreenStocks
Screen listed stocks with optional min/max bounds for price, market cap, institutional ownership, short data, insider activity, valuation, growth, margins, liquidity and earnings. Exact sector, industry, covered-index membership and going-concern filters are also available. A stock missing a bounded metric is excluded. Results use the requested sort (market cap descending by default), are paged, and include each dataset's vintage. Filtering or sorting on a fundamental metric adds that metric to the result table. US listings by default; pass market to screen European, Chinese or Hong Kong listings.
Parameters40
minMarketCap
number | null
optional
Minimum market capitalization in dollars.
maxMarketCap
number | null
optional
Maximum market capitalization in dollars.
minPrice
number | null
optional
Minimum share price in dollars.
maxPrice
number | null
optional
Maximum share price in dollars.
minFilerCount
integer | null
optional
Minimum number of 13F institutional filers holding the stock.
maxFilerCount
integer | null
optional
Maximum number of 13F institutional filers holding the stock.
minFilerDelta
integer | null
optional
Minimum quarter-over-quarter change in filer count.
maxFilerDelta
integer | null
optional
Maximum quarter-over-quarter change in filer count.
minShortInterestPercent
number | null
optional
Minimum short interest as a percent of shares outstanding (0-100).
maxShortInterestPercent
number | null
optional
Maximum short interest as a percent of shares outstanding (0-100).
minDaysToCover
number | null
optional
Minimum days to cover.
maxDaysToCover
number | null
optional
Maximum days to cover.
minSqueezeScore
number | null
optional
Minimum composite short-squeeze score (0-100, peer-relative; higher = more squeeze-prone).
maxSqueezeScore
number | null
optional
Maximum composite short-squeeze score (0-100, peer-relative).
Maximum trailing-twelve-month price-to-earnings ratio (e.g. 15 for value screens).
minDividendYield
number | null
optional
Minimum trailing dividend yield in percent (e.g. 3 = 3%).
maxDividendYield
number | null
optional
Maximum trailing dividend yield in percent.
minRevenueGrowth
number | null
optional
Minimum revenue growth in percent, latest quarter vs the same quarter a year earlier.
maxRevenueGrowth
number | null
optional
Maximum revenue growth in percent, latest quarter vs the same quarter a year earlier.
minGrossMargin
number | null
optional
Minimum gross margin in percent (0-100).
maxGrossMargin
number | null
optional
Maximum gross margin in percent (0-100).
minDollarVolume
number | null
optional
Minimum trailing-3-month average daily dollar volume in dollars (e.g. 5000000 = $5M/day).
maxDollarVolume
number | null
optional
Maximum trailing-3-month average daily dollar volume in dollars.
minNetIncome
number | null
optional
Minimum trailing-twelve-month net income in dollars (0 keeps profitable companies only).
maxNetIncome
number | null
optional
Maximum trailing-twelve-month net income in dollars.
sortBy
string
optional
Sort key: marketcap, ticker, name, price, filers, filerdelta, sipct, dtc, squeeze, sentiment, insiderbuy, pe, divyield, revgrowth, grossmargin, dollarvol or netincome. Default marketcap. An unknown key is rejected, never silently ignored.
sortAscending
boolean
optional
Sort ascending instead of descending.
maxResults
integer
optional
Maximum rows to return (default 50; clamped to 1-200).
page
integer
optional
Result page (default 1) — combine with maxResults to walk past the first page of a large match set.
tickers
array
optional
Optional list of up to 200 tickers to restrict the screen to, for scoring stocks the user already holds or follows instead of searching the whole market. Every other bound still applies and sortBy still orders the result. Class-share dots (BRK.B) resolve to the listed form, a secondary listing resolves to its issuer, and any symbol outside the covered universe is named back to you.
market
string
optional
Listing markets as ISO country codes, comma-separated (e.g. GB,FR or CN,HK), or 'all' for every covered market. Default US. A non-US row's ticker is a qualified MIC:TICKER symbol (e.g. XPAR:AIR) that AddPortfolioLot, WatchInstrument and UnwatchInstrument accept and the other tools do not; its price and market cap are USD at the official exchange rate, with the traded close in its own currency beside the price. Non-US rows carry identity, price and market cap only.
Raw schema
{
"type": "object",
"properties": {
"minMarketCap": {
"description": "Minimum market capitalization in dollars.",
"type": [
"number",
"null"
],
"default": null
},
"maxMarketCap": {
"description": "Maximum market capitalization in dollars.",
"type": [
"number",
"null"
],
"default": null
},
"minPrice": {
"description": "Minimum share price in dollars.",
"type": [
"number",
"null"
],
"default": null
},
"maxPrice": {
"description": "Maximum share price in dollars.",
"type": [
"number",
"null"
],
"default": null
},
"minFilerCount": {
"description": "Minimum number of 13F institutional filers holding the stock.",
"type": [
"integer",
"null"
],
"default": null
},
"maxFilerCount": {
"description": "Maximum number of 13F institutional filers holding the stock.",
"type": [
"integer",
"null"
],
"default": null
},
"minFilerDelta": {
"description": "Minimum quarter-over-quarter change in filer count.",
"type": [
"integer",
"null"
],
"default": null
},
"maxFilerDelta": {
"description": "Maximum quarter-over-quarter change in filer count.",
"type": [
"integer",
"null"
],
"default": null
},
"minShortInterestPercent": {
"description": "Minimum short interest as a percent of shares outstanding (0-100).",
"type": [
"number",
"null"
],
"default": null
},
"maxShortInterestPercent": {
"description": "Maximum short interest as a percent of shares outstanding (0-100).",
"type": [
"number",
"null"
],
"default": null
},
"minDaysToCover": {
"description": "Minimum days to cover.",
"type": [
"number",
"null"
],
"default": null
},
"maxDaysToCover": {
"description": "Maximum days to cover.",
"type": [
"number",
"null"
],
"default": null
},
"minSqueezeScore": {
"description": "Minimum composite short-squeeze score (0-100, peer-relative; higher = more squeeze-prone).",
"type": [
"number",
"null"
],
"default": null
},
"maxSqueezeScore": {
"description": "Maximum composite short-squeeze score (0-100, peer-relative).",
"type": [
"number",
"null"
],
"default": null
},
"minInsiderSentiment": {
"description": "Minimum composite insider-sentiment score (0-100, peer-relative; higher = more aggressive insider accumulation).",
"type": [
"number",
"null"
],
"default": null
},
"maxInsiderSentiment": {
"description": "Maximum composite insider-sentiment score (0-100, peer-relative).",
"type": [
"number",
"null"
],
"default": null
},
"minNetInsiderBuy": {
"description": "Minimum net open-market insider buying by officers and directors in dollars over the trailing 90 days.",
"type": [
"number",
"null"
],
"default": null
},
"maxNetInsiderBuy": {
"description": "Maximum net open-market insider buying by officers and directors in dollars over the trailing 90 days.",
"type": [
"number",
"null"
],
"default": null
},
"hasGoingConcernDoubt": {
"description": "True keeps only companies whose latest filing states unalleviated going-concern doubt; false keeps only companies without the flag.",
"type": [
"boolean",
"null"
],
"default": null
},
"sector": {
"description": "Exact sector name (e.g. Technology, Healthcare). An unknown name returns the accepted list.",
"type": "string",
"default": null
},
"industry": {
"description": "Exact industry name (e.g. Semiconductors). Prefer sector for broad groups.",
"type": "string",
"default": null
},
"index": {
"description": "Keep only members of one covered index, by slug or name (sp-500, S&P 500, nasdaq-100, Russell 2000). An unknown name returns the accepted list.",
"type": "string",
"default": null
},
"minPe": {
"description": "Minimum trailing-twelve-month price-to-earnings ratio.",
"type": [
"number",
"null"
],
"default": null
},
"maxPe": {
"description": "Maximum trailing-twelve-month price-to-earnings ratio (e.g. 15 for value screens).",
"type": [
"number",
"null"
],
"default": null
},
"minDividendYield": {
"description": "Minimum trailing dividend yield in percent (e.g. 3 = 3%).",
"type": [
"number",
"null"
],
"default": null
},
"maxDividendYield": {
"description": "Maximum trailing dividend yield in percent.",
"type": [
"number",
"null"
],
"default": null
},
"minRevenueGrowth": {
"description": "Minimum revenue growth in percent, latest quarter vs the same quarter a year earlier.",
"type": [
"number",
"null"
],
"default": null
},
"maxRevenueGrowth": {
"description": "Maximum revenue growth in percent, latest quarter vs the same quarter a year earlier.",
"type": [
"number",
"null"
],
"default": null
},
"minGrossMargin": {
"description": "Minimum gross margin in percent (0-100).",
"type": [
"number",
"null"
],
"default": null
},
"maxGrossMargin": {
"description": "Maximum gross margin in percent (0-100).",
"type": [
"number",
"null"
],
"default": null
},
"minDollarVolume": {
"description": "Minimum trailing-3-month average daily dollar volume in dollars (e.g. 5000000 = $5M/day).",
"type": [
"number",
"null"
],
"default": null
},
"maxDollarVolume": {
"description": "Maximum trailing-3-month average daily dollar volume in dollars.",
"type": [
"number",
"null"
],
"default": null
},
"minNetIncome": {
"description": "Minimum trailing-twelve-month net income in dollars (0 keeps profitable companies only).",
"type": [
"number",
"null"
],
"default": null
},
"maxNetIncome": {
"description": "Maximum trailing-twelve-month net income in dollars.",
"type": [
"number",
"null"
],
"default": null
},
"sortBy": {
"description": "Sort key: marketcap, ticker, name, price, filers, filerdelta, sipct, dtc, squeeze, sentiment, insiderbuy, pe, divyield, revgrowth, grossmargin, dollarvol or netincome. Default marketcap. An unknown key is rejected, never silently ignored.",
"type": "string",
"default": "marketcap"
},
"sortAscending": {
"description": "Sort ascending instead of descending.",
"type": "boolean",
"default": false
},
"maxResults": {
"description": "Maximum rows to return (default 50; clamped to 1-200).",
"type": "integer",
"default": 50
},
"page": {
"description": "Result page (default 1) — combine with maxResults to walk past the first page of a large match set.",
"type": "integer",
"default": 1
},
"tickers": {
"description": "Optional list of up to 200 tickers to restrict the screen to, for scoring stocks the user already holds or follows instead of searching the whole market. Every other bound still applies and sortBy still orders the result. Class-share dots (BRK.B) resolve to the listed form, a secondary listing resolves to its issuer, and any symbol outside the covered universe is named back to you.",
"type": "array",
"items": {
"type": "string"
},
"default": null
},
"market": {
"description": "Listing markets as ISO country codes, comma-separated (e.g. GB,FR or CN,HK), or 'all' for every covered market. Default US. A non-US row's ticker is a qualified MIC:TICKER symbol (e.g. XPAR:AIR) that AddPortfolioLot, WatchInstrument and UnwatchInstrument accept and the other tools do not; its price and market cap are USD at the official exchange rate, with the traded close in its own currency beside the price. Non-US rows carry identity, price and market cap only.",
"type": "string",
"default": null
}
}
}
GetFundProfile
Get a registered fund's profile and largest stored holdings from its latest SEC Form NPORT-P report. Accepts a profile ID, SEC series ID, stored ticker, or verified alias from SearchFunds. Returns registrant, series, assets, reported and stored holding counts, and the largest stored positions. Some multi-series trusts store only tracked-stock positions; reported counts and asset totals still describe the full filing. Use GetFundsHoldingStock for the inverse lookup.
Parameters3
fund
string
required
Fund profile id, SEC series id, stored series ticker, or verified share-class alias from SearchFunds (e.g., 'ishares-russell-2000-etf-s000004344', 'S000004344', 'IWM', or 'VOO').
maxResults
integer
optional
Maximum number of holdings to return, largest first (default: 20, max: 500)
offset
integer
optional
Number of ranked holdings to skip before returning rows (default: 0)
Raw schema
{
"type": "object",
"properties": {
"fund": {
"description": "Fund profile id, SEC series id, stored series ticker, or verified share-class alias from SearchFunds (e.g., 'ishares-russell-2000-etf-s000004344', 'S000004344', 'IWM', or 'VOO').",
"type": "string"
},
"maxResults": {
"description": "Maximum number of holdings to return, largest first (default: 20, max: 500)",
"type": "integer",
"default": 20
},
"offset": {
"description": "Number of ranked holdings to skip before returning rows (default: 0)",
"type": "integer",
"default": 0
}
},
"required": [
"fund"
]
}
GetInvestorEventTranscript
Get the speaker-labelled transcript of a specific investor event (earnings call, conference, investor day) by its event id — every speaker turn in order, attributed to the real person (executive or analyst) with their role when the resolution is trusted; unverified voices show as a role label (e.g. Operator) or a neutral speaker number. Get the event id from ListInvestorEvents. Use this for conferences and other non-earnings events, which have no fiscal quarter to key on.
Parameters3
eventId
string
required
The investor event id (from ListInvestorEvents)
limit
integer
optional
Maximum number of speaker turns to return (default 50, max 200; values outside 1-200 are clamped)
offset
integer
optional
Number of leading speaker turns to skip, for paging through events longer than the 200-turn cap (default 0)
Raw schema
{
"type": "object",
"properties": {
"eventId": {
"description": "The investor event id (from ListInvestorEvents)",
"type": "string",
"format": "uuid"
},
"limit": {
"description": "Maximum number of speaker turns to return (default 50, max 200; values outside 1-200 are clamped)",
"type": "integer",
"default": 50
},
"offset": {
"description": "Number of leading speaker turns to skip, for paging through events longer than the 200-turn cap (default 0)",
"type": "integer",
"default": 0
}
},
"required": [
"eventId"
]
}
GetInstitutionConsensusHoldings
Combine 2-25 institutions' 13F portfolios on their latest common report date. Ranks stocks by holder count, then combined value. Published values normally use report-date closing prices, may fall back to filer values, and can be zero when unavailable. Set minInstitutions to 2 or more for positions shared by multiple filers.
Parameters4
institutionNames
array
required
Institution names or CIKs (2-25). Unique partial names and verified aliases resolve; ambiguous partials return candidate CIKs.
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format (defaults to the latest common quarter; an off-quarter date snaps to the nearest common report on or before it)
minInstitutions
integer
optional
Minimum number of institutions that must hold a stock (default: 1; set 2 or more for shared positions)
maxResults
integer
optional
Maximum number of stocks to return (default: 30, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"institutionNames": {
"description": "Institution names or CIKs (2-25). Unique partial names and verified aliases resolve; ambiguous partials return candidate CIKs.",
"type": "array",
"items": {
"type": "string"
}
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format (defaults to the latest common quarter; an off-quarter date snaps to the nearest common report on or before it)",
"type": "string",
"default": null
},
"minInstitutions": {
"description": "Minimum number of institutions that must hold a stock (default: 1; set 2 or more for shared positions)",
"type": "integer",
"default": 1
},
"maxResults": {
"description": "Maximum number of stocks to return (default: 30, clamped to 1-500)",
"type": "integer",
"default": 30
}
},
"required": [
"institutionNames"
]
}
SearchInstitutions
Search the tracked 13F filer set by institution name or SEC CIK. Search first requires every punctuation-independent query word anywhere in the filed name, then broadens to any word only when no strict row matches. Verified brand aliases such as Fidelity, Vanguard, and BlackRock include their current flagship CIK. Results are largest within the recently-active filing bucket first and include latest report date, tracked 13F position value, and position count so same-name filers can be compared before calling an institution tool. Values normally use report-date closing prices, may fall back to filer values, and can include zero for unavailable valuations. Scoped institution tools remain strict and never discard an unmatched word.
Parameters2
query
string
required
Search query — institution name, partial name, or CIK
maxResults
integer
optional
Maximum number of results to return (default: 10, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Search query — institution name, partial name, or CIK",
"type": "string"
},
"maxResults": {
"description": "Maximum number of results to return (default: 10, clamped to 1-500)",
"type": "integer",
"default": 10
}
},
"required": [
"query"
]
}
GetShortInterest
Get bi-monthly short interest history for an exact stock or ETF listing from FINRA. Shows the reported short position, change from the previous settlement, average daily volume, and days to cover per settlement date. Share counts are restated onto today's split basis so the series stays continuous across stock splits; days to cover is as reported (FINRA caps it at 999.99). High days-to-cover (>5) suggests a potential short squeeze — for short interest as a % of shares outstanding and an actual squeeze-candidate ranking use GetShortSqueezeScores; for the market-wide latest settlement use GetShortInterestSnapshot. For primary operating-company stocks only, the answer may also carry a model estimate of the settlement FINRA has not published yet; it appears BELOW the table and must never be presented as a FINRA figure.
Parameters4
ticker
string
required
Listed security ticker (e.g., AAPL, VOO, GME)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 1 year ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of records to return — keeps the most recent N settlements in the range, displayed oldest to newest (default: 24, max: 500)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed security ticker (e.g., AAPL, VOO, GME)",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 1 year ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of records to return — keeps the most recent N settlements in the range, displayed oldest to newest (default: 24, max: 500)",
"type": "integer",
"default": 24
}
},
"required": [
"ticker"
]
}
GetPutCallRatios
Get CBOE put/call ratio data showing market sentiment. Available types: Total (all exchange), Equity, Index, Vix, Etp. High ratios (>1.0) indicate bearish sentiment; low ratios (<0.7) indicate bullish sentiment. Volumes are contract counts. Data available from November 2006 to present (the Vix type from October 2019); pre-2013 history is sampled roughly weekly rather than daily.
Parameters4
type
string
optional
Ratio type: Total, Equity, Index, Vix, Etp (default: Equity)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 3 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of records to return (default: 60, max: 500). When the range holds more rows the newest are kept; rows are always listed oldest to newest.
Raw schema
{
"type": "object",
"properties": {
"type": {
"description": "Ratio type: Total, Equity, Index, Vix, Etp (default: Equity)",
"type": "string",
"default": "Equity"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 3 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of records to return (default: 60, max: 500). When the range holds more rows the newest are kept; rows are always listed oldest to newest.",
"type": "integer",
"default": 60
}
}
}
ListInvestorEvents
List a company's recent investor events — earnings calls AND the other events it webcasts (conferences, investor/analyst days, shareholder meetings) — newest first. Each row gives the event id, type, the UTC start (time shown when one was reported), the event title, fiscal period (earnings calls only), status, and whether a transcript, audio and slide deck are on file. Conferences have no fiscal quarter, so use the event id with GetInvestorEventTranscript to read one rather than GetEarningsCallEvent (which is keyed by fiscal quarter and earnings-only).
Parameters4
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
limit
integer
optional
Maximum number of events to return (default 25, max 100; values outside 1-100 are clamped)
eventType
string
optional
Optional event type to filter on: EarningsCall, CapitalMarketsDay, InvestorUpdate, AGM, Conference, FiresideChat, or MAndA (default: all types)
offset
integer
optional
Number of matching events to skip before returning rows (default 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"limit": {
"description": "Maximum number of events to return (default 25, max 100; values outside 1-100 are clamped)",
"type": "integer",
"default": 25
},
"eventType": {
"description": "Optional event type to filter on: EarningsCall, CapitalMarketsDay, InvestorUpdate, AGM, Conference, FiresideChat, or MAndA (default: all types)",
"type": "string",
"default": null
},
"offset": {
"description": "Number of matching events to skip before returning rows (default 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetCongressionalTrades
Get congressional securities transactions for a specific ticker (newest first, last year by default). Shows which members of Congress reported a purchase or sale, with transaction and filing dates; amounts are disclosed ranges, not exact values, and Asset identifies the filed instrument (such as stock, option, or bond). Use GetMemberTrades for one member's transactions across all tickers.
Parameters6
ticker
string
required
Listed security ticker (e.g., AAPL, VOO, MSFT)
transactionType
string
optional
Filter by transaction type: Purchase or Sale; the synonyms Buy/Sell are accepted (defaults to all)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 1 year ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to today)
maxResults
integer
optional
Maximum number of trades to return (default: 50, max: 500, newest first)
offset
integer
optional
Number of matching trades to skip before returning rows (default: 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed security ticker (e.g., AAPL, VOO, MSFT)",
"type": "string"
},
"transactionType": {
"description": "Filter by transaction type: Purchase or Sale; the synonyms Buy/Sell are accepted (defaults to all)",
"type": "string",
"default": null
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 1 year ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to today)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of trades to return (default: 50, max: 500, newest first)",
"type": "integer",
"default": 50
},
"offset": {
"description": "Number of matching trades to skip before returning rows (default: 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetInstitutionCloneBacktest
Backtest how cloning an institutional filer's reported 13F portfolio would have performed against a market benchmark, either over a trailing window (windowYears) or an explicit fromDate/toDate range. Reconstructs the filer's portfolio at each quarterly 13F snapshot, rebalances on the SEC filing lag, and values each exact listed security on raw closing prices. Returns price return (dividends excluded), CAGR, and max drawdown for the clone and benchmark, plus price-return alpha. Returns are unavailable when a held security or benchmark crosses a captured split without a certified price basis; the requested window is not shortened to hide it.
Parameters5
institution
string
required
Institution name or SEC CIK (e.g., 'Berkshire Hathaway', '1067983', or zero-padded '0001067983'). Unique partials and verified aliases resolve; ambiguous partials return candidate CIKs.
benchmark
string
optional
Benchmark ticker to compare against (default: SPY)
windowYears
integer
optional
Trailing window length in years anchored at today (default: 3, clamped to 1-20; ignored when fromDate/toDate are supplied)
fromDate
string
optional
Optional window start in YYYY-MM-DD format for an anchored historical backtest (e.g. 2015-01-01); overrides windowYears
toDate
string
optional
Optional window end in YYYY-MM-DD format (defaults to today when only fromDate is given)
Raw schema
{
"type": "object",
"properties": {
"institution": {
"description": "Institution name or SEC CIK (e.g., 'Berkshire Hathaway', '1067983', or zero-padded '0001067983'). Unique partials and verified aliases resolve; ambiguous partials return candidate CIKs.",
"type": "string"
},
"benchmark": {
"description": "Benchmark ticker to compare against (default: SPY)",
"type": "string",
"default": "SPY"
},
"windowYears": {
"description": "Trailing window length in years anchored at today (default: 3, clamped to 1-20; ignored when fromDate/toDate are supplied)",
"type": "integer",
"default": 3
},
"fromDate": {
"description": "Optional window start in YYYY-MM-DD format for an anchored historical backtest (e.g. 2015-01-01); overrides windowYears",
"type": "string",
"default": null
},
"toDate": {
"description": "Optional window end in YYYY-MM-DD format (defaults to today when only fromDate is given)",
"type": "string",
"default": null
}
},
"required": [
"institution"
]
}
CompareInstitutionPortfolios
Compare two institutions' 13F portfolios on their latest common report date. Returns Jaccard and dollar-weighted overlap, portfolio totals, and shared or unique positions. Published values normally use report-date closing prices, may fall back to filer values, and can be zero when unavailable. Resolve filer names with SearchInstitutions. For mutual-fund or ETF NPORT portfolios, use GetFundProfile.
Parameters4
institutionName1
string
required
First institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)
institutionName2
string
required
Second institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format (defaults to the latest common quarter; an off-quarter date snaps to the nearest common report on or before it)
maxResults
integer
optional
Maximum number of stocks to return (default: 30, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"institutionName1": {
"description": "First institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)",
"type": "string"
},
"institutionName2": {
"description": "Second institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)",
"type": "string"
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format (defaults to the latest common quarter; an off-quarter date snaps to the nearest common report on or before it)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of stocks to return (default: 30, clamped to 1-500)",
"type": "integer",
"default": 30
}
},
"required": [
"institutionName1",
"institutionName2"
]
}
GetValuationMultiplesHistory
Get up to ~10 years of quarterly EV/Revenue, EV/EBIT, EV/EBITDA and P/E, with P/FFO and P/AFFO for REITs and EV/Adjusted EBITDA for verified filers. Each row is recomputed at its filing date from facts then available and that day's raw close; non-GAAP cells name their TTM or fiscal-year basis. Completed exact-primary split reconciliation preserves older samples; anchors before an unresolved split are omitted. The reply reports omissions and missing EV inputs by cause. Uses the strict USD-only TTM/EV methodology of GetValuationMultiples on one effective split basis. Missing or unproved inputs are dashes, never estimates.
Get upcoming investor-relations events for a stock — earnings webcasts, conference appearances, presentations, and shareholder meetings — scraped from the company's IR website. Returns events scheduled from now onward, soonest first, optionally filtered by event type. Coverage is partial — an empty answer distinguishes a coverage gap from a genuinely empty calendar. Only future events are returned; for past events and their transcripts use ListInvestorEvents / GetInvestorEventTranscript.
Parameters3
ticker
string
required
Company ticker symbol (e.g., NVDA, AAPL)
maxResults
integer
optional
Maximum number of events to return (default: 20, max: 500)
eventType
string
optional
Optional event-type filter: EarningsCall, Conference, Presentation, ShareholderMeeting, or Webcast. Omit for all types. Events whose source label could not be classified carry the generic type 'Event' and only appear when no filter is set.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., NVDA, AAPL)",
"type": "string"
},
"maxResults": {
"description": "Maximum number of events to return (default: 20, max: 500)",
"type": "integer",
"default": 20
},
"eventType": {
"description": "Optional event-type filter: EarningsCall, Conference, Presentation, ShareholderMeeting, or Webcast. Omit for all types. Events whose source label could not be classified carry the generic type 'Event' and only appear when no filter is set.",
"type": "string",
"default": null
}
},
"required": [
"ticker"
]
}
GetDividendHistory
Get the stored declared cash dividends of an exact stock or ETF listing, newest first. Each row gives the ex-dividend date and cash amount per share in USD. Date filters apply to the ex-dividend date. Future ex-dates can appear after a dividend is declared. Each listing reports its own payments: a share class (BRK-A beside BRK-B) or a fund series sharing its trust's filer (SCHD beside FNDA) never inherits another listing's dividends.
Parameters5
ticker
string
required
Listed stock or ETF ticker (e.g., AAPL, BRK-A, SCHD).
startDate
string | null
optional
Optional earliest ex-dividend date in YYYY-MM-DD format.
endDate
string | null
optional
Optional latest ex-dividend date in YYYY-MM-DD format.
maxResults
integer
optional
Maximum number of records to return (default: 20, max: 500).
offset
integer
optional
Number of newest matching records to skip for pagination (default: 0).
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed stock or ETF ticker (e.g., AAPL, BRK-A, SCHD).",
"type": "string"
},
"startDate": {
"description": "Optional earliest ex-dividend date in YYYY-MM-DD format.",
"type": [
"string",
"null"
],
"format": "date-time",
"default": null
},
"endDate": {
"description": "Optional latest ex-dividend date in YYYY-MM-DD format.",
"type": [
"string",
"null"
],
"format": "date-time",
"default": null
},
"maxResults": {
"description": "Maximum number of records to return (default: 20, max: 500).",
"type": "integer",
"default": 20
},
"offset": {
"description": "Number of newest matching records to skip for pagination (default: 0).",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
UpdatePortfolioLot
Correct a lot the USER already recorded: a mistyped quantity, price, trade date, note or exchange rate. Only the fields you pass change; the rest are left alone.
The instrument itself cannot be edited: a lot on the wrong stock or the wrong contract is a different holding, so remove it with RemovePortfolioLot and add the right one. To record a sale, use ClosePortfolioLot rather than editing the quantity down, because editing it away loses the realized profit.
Parameters8
portfolio
string
required
The portfolio holding the lot, by name.
lotId
string
required
The lot id shown by GetMyPortfolio, e.g. a1b2c3d4.
quantity
number | null
optional
Optional. The corrected signed size. Negative is a short or written option.
costPerUnit
number | null
optional
Optional. The corrected price per share, always positive.
acquiredDate
string
optional
Optional. The corrected trade date, as yyyy-MM-dd.
note
string
optional
Optional. A replacement note, up to 256 characters.
fxRate
number | null
optional
Optional. The broker's exchange rate on the trade, as units of the portfolio's currency per 1 unit of the lot's currency.
clearFxRate
boolean
optional
Optional. True removes the broker's exchange rate, so the lot converts at the official rate on its trade date. Cannot be combined with fxRate.
Raw schema
{
"type": "object",
"properties": {
"portfolio": {
"description": "The portfolio holding the lot, by name.",
"type": "string"
},
"lotId": {
"description": "The lot id shown by GetMyPortfolio, e.g. a1b2c3d4.",
"type": "string"
},
"quantity": {
"description": "Optional. The corrected signed size. Negative is a short or written option.",
"type": [
"number",
"null"
],
"default": null
},
"costPerUnit": {
"description": "Optional. The corrected price per share, always positive.",
"type": [
"number",
"null"
],
"default": null
},
"acquiredDate": {
"description": "Optional. The corrected trade date, as yyyy-MM-dd.",
"type": "string",
"default": null
},
"note": {
"description": "Optional. A replacement note, up to 256 characters.",
"type": "string",
"default": null
},
"fxRate": {
"description": "Optional. The broker's exchange rate on the trade, as units of the portfolio's currency per 1 unit of the lot's currency.",
"type": [
"number",
"null"
],
"default": null
},
"clearFxRate": {
"description": "Optional. True removes the broker's exchange rate, so the lot converts at the official rate on its trade date. Cannot be combined with fxRate.",
"type": "boolean",
"default": false
}
},
"required": [
"portfolio",
"lotId"
]
}
GetShortInterestSnapshot
Market-wide snapshot of the latest FINRA bi-monthly short interest settlement — one row per exact listed security, sorted by days to cover (descending) by default. FINRA caps days to cover at 999.99: capped rows are a sentinel (almost always illiquid names with a tiny average-daily-volume denominator) and are ranked after real readings; pass minAvgDailyVolume (e.g. 100000) to drop illiquid names entirely. This is the raw FINRA snapshot — for genuine short-squeeze candidate ranking use GetShortSqueezeScores; for one stock or ETF's history use GetShortInterest; for daily short-sale flow use GetShortVolume/GetLargestShortVolume.
Parameters5
minDaysToCover
number
optional
Minimum days to cover filter (default: 0)
maxResults
integer
optional
Maximum number of results to return (default: 50, max: 500)
offset
integer
optional
Number of ranked results to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.
minAvgDailyVolume
integer
optional
Minimum average daily share volume — set a floor (e.g. 100000) to drop illiquid names whose days-to-cover is inflated by a tiny volume denominator (default: 0 = no floor)
sortBy
string
optional
Sort key: daysToCover (default; FINRA-capped 999.99 sentinel rows ranked last), shortPosition, or change (largest increase in short position first)
Raw schema
{
"type": "object",
"properties": {
"minDaysToCover": {
"description": "Minimum days to cover filter (default: 0)",
"type": "number",
"default": 0
},
"maxResults": {
"description": "Maximum number of results to return (default: 50, max: 500)",
"type": "integer",
"default": 50
},
"offset": {
"description": "Number of ranked results to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.",
"type": "integer",
"default": 0
},
"minAvgDailyVolume": {
"description": "Minimum average daily share volume — set a floor (e.g. 100000) to drop illiquid names whose days-to-cover is inflated by a tiny volume denominator (default: 0 = no floor)",
"type": "integer",
"default": 0
},
"sortBy": {
"description": "Sort key: daysToCover (default; FINRA-capped 999.99 sentinel rows ranked last), shortPosition, or change (largest increase in short position first)",
"type": "string",
"default": "daysToCover"
}
}
}
GetValuationMultiples
Get current EV/Revenue, EV/EBIT and P/E with peer median, quartiles and sample size; REITs also include verified company-stated P/FFO and P/AFFO, and any filer with a verified reconciliation also includes EV over its own stated Adjusted EBITDA, when available. TTM money flows use four discrete fiscal quarters or an exact annual-plus-current-YTD-minus-prior-YTD bridge; annual-only figures are not TTM. P/E uses validated diluted EPS or explicitly reported income available to common shareholders, with the basis named. Enterprise value uses same-date reported debt, cash and tagged short-term investments. Inputs must reconcile, share one effective split basis and be stated in USD; missing inputs are never estimated. The company is excluded from its peer cohort, which uses similar-size industry peers when sufficient and the full industry otherwise. The response names every figure's date and cohort basis. Use GetValuationMultiplesHistory for point-in-time history.
Get recent exempt securities offerings (private placements) for a company from SEC Form D notices. Each Form D reports a Regulation D offering, showing the issuer, the date of first sale, the total offering amount (a dollar figure or "Indefinite"), the amounts sold and remaining, the minimum investment, the number of investors, the claimed exemptions, whether the notice is an amendment (D/A), and its SEC accession number. Ongoing offerings are re-noticed through D/A amendments that RESTATE the same offering — group rows by first-sale date and offering amount and use only the latest notice of each chain, or capital raised will be counted several times over. Use this to track how a company is raising private capital alongside its public filings.
Parameters5
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
maxResults
integer
optional
Maximum number of notices to return (default: 50, max: 500; values outside 1-500 are clamped)
fromDate
string
optional
Optional earliest filing date to include, ISO format yyyy-MM-dd (e.g., 2024-01-01)
toDate
string
optional
Optional latest filing date to include, ISO format yyyy-MM-dd (e.g., 2024-12-31)
offset
integer
optional
Number of matching notices to skip before returning rows (default: 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"maxResults": {
"description": "Maximum number of notices to return (default: 50, max: 500; values outside 1-500 are clamped)",
"type": "integer",
"default": 50
},
"fromDate": {
"description": "Optional earliest filing date to include, ISO format yyyy-MM-dd (e.g., 2024-01-01)",
"type": "string",
"default": null
},
"toDate": {
"description": "Optional latest filing date to include, ISO format yyyy-MM-dd (e.g., 2024-12-31)",
"type": "string",
"default": null
},
"offset": {
"description": "Number of matching notices to skip before returning rows (default: 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetFundsHoldingStock
Get the registered investment companies (mutual funds and ETFs) holding an exact stock or ETF listing, from SEC Form NPORT-P portfolio reports. The listed security's authoritative CUSIP is matched against the holding rows on each fund series' most recent report (series that stopped filing more than 18 months ago are excluded), so an exited position never shows as current. Returns the fund's registrant and series, the reporting period, the position size, its U.S.-dollar value, its share of the fund's net assets and the payoff profile (Long/Short), largest positions first. Report dates differ per fund series (each files on its own fiscal quarter), so values are as of each row's report date and cross-row totals mix as-of dates.
Parameters4
ticker
string
required
Listed security ticker (e.g., AAPL, VOO)
maxResults
integer
optional
Maximum number of fund positions to return, largest first (default: 20, clamped to 1-500)
registrantOrSeries
string
optional
Optional registrant or series name filter (case-insensitive contains, e.g. 'Vanguard') — reaches positions beyond the largest 500
offset
integer
optional
Number of matching fund positions to skip before returning rows (default: 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed security ticker (e.g., AAPL, VOO)",
"type": "string"
},
"maxResults": {
"description": "Maximum number of fund positions to return, largest first (default: 20, clamped to 1-500)",
"type": "integer",
"default": 20
},
"registrantOrSeries": {
"description": "Optional registrant or series name filter (case-insensitive contains, e.g. 'Vanguard') — reaches positions beyond the largest 500",
"type": "string",
"default": null
},
"offset": {
"description": "Number of matching fund positions to skip before returning rows (default: 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetEarningsCallEvent
Get the earnings-call event for a company's fiscal quarter — the single record that groups the quarter's call artefacts (audio, transcript, slide deck, and 8-K earnings release) under one event. Returns the event's id (usable with GetInvestorEventTranscript), title, call date, status, which of the four artefacts are available, the transcript and earnings-release document ids when linked, and the release's extracted guidance rows when the 8-K carries approved ones. When a transcript is available, read it with GetEarningsCallTranscript, or get the AI read via GetEarningsBrief / GetEarningsCallToneAndThemes. Use this to ask "what do we have for AAPL FY2025 Q3?" rather than chasing each artefact separately — or omit the fiscal period for the company's latest call.
Parameters3
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
fiscalYear
integer | null
optional
Company fiscal year. Omit both period fields for the latest call; year alone selects the latest call in that fiscal year.
fiscalQuarter
integer | null
optional
Company fiscal quarter, 1-4. Quarter alone selects the latest matching quarter across fiscal years; provide both fields for an exact period.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"fiscalYear": {
"description": "Company fiscal year. Omit both period fields for the latest call; year alone selects the latest call in that fiscal year.",
"type": [
"integer",
"null"
],
"default": null
},
"fiscalQuarter": {
"description": "Company fiscal quarter, 1-4. Quarter alone selects the latest matching quarter across fiscal years; provide both fields for an exact period.",
"type": [
"integer",
"null"
],
"default": null
}
},
"required": [
"ticker"
]
}
GetIndexChanges
Get the companies that have joined or left a major US stock index, newest first. Changes are derived by comparing consecutive constituent lists from the funds that track the index, so each one is dated to the window between two reports rather than to an announcement: a daily holdings file dates a change to a day, a quarterly filing only to a quarter. Several funds track the same index and each records a change separately, so records for the same company and direction over overlapping windows are collapsed into the single event a reader should see, keeping the narrowest window. This is observed membership, not an announcement feed, so a change appears once a tracking fund has actually reported it.
Parameters2
index
string
required
Index name or slug, for example "S&P 500", "sp-500", "nasdaq-100" or "Russell 2000".
maxResults
integer
optional
Maximum changes to return, newest first (default 25, max 500).
Raw schema
{
"type": "object",
"properties": {
"index": {
"description": "Index name or slug, for example \"S&P 500\", \"sp-500\", \"nasdaq-100\" or \"Russell 2000\".",
"type": "string"
},
"maxResults": {
"description": "Maximum changes to return, newest first (default 25, max 500).",
"type": "integer",
"default": 25
}
},
"required": [
"index"
]
}
GetEtfProfile
Get ETF settled performance, SEC assets, allocation and top holdings. For this same exact ETF ticker, use GetStockPrices or GetLatestClosingPrices for prices, GetLiveQuote for entitled intraday quotes, GetOptionExpirations/GetOptionChain/GetOptionContract for options, GetShortInterest for reported short interest and days to cover, GetShortVolume/GetOffExchangeVolume/GetFailsToDeliver for trading and settlement data, GetTopHolders/GetInstitutionalOwnershipHistory/GetTopInstitutionalBuyersSellers for 13F institutional exposure, GetFundsHoldingStock for funds owning the ETF, GetDividendHistory for its own declared distributions, and GetCongressionalTrades for congressional trades. These are shared stock-and-ETF tools; GetEtfHoldings instead returns investments inside the ETF. ListFilings/SearchDocuments select the SEC registrant and may include sibling funds, not just this ETF series. Issuer-trained short-interest forecasts and squeeze scores are not ETF analytics.
Parameters1
ticker
string
required
Exact exchange-traded ticker (for example SPY, VOO, or IVV).
Get a company's revenue disaggregated by business segment, geography and product/service — plus operating income by segment when the issuer tags it, so segment profitability and margins are answerable — from the dimensional XBRL facts the issuer tags in its own filings. Annual fiscal years only, latest restated values, one table per axis the company reports; source values are as-reported and never estimated, while segment operating margin is derived as operating income divided by revenue for the same folded raw member QName and exact period. Rows within one table can OVERLAP when the issuer tags several granularities on the same axis (a parent segment alongside its components), so never sum rows to derive total revenue — use the consolidated total row each table carries. For consolidated figures use GetFinancialStatement or GetFinancialFact.
Parameters2
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT)
maxYears
integer
optional
Most recent fiscal years to include (default 8, max 12)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"maxYears": {
"description": "Most recent fiscal years to include (default 8, max 12)",
"type": "integer",
"default": 8
}
},
"required": [
"ticker"
]
}
GetGovernmentContracts
Get federal government contract awards (from USAspending.gov) won by a specific public company. Shows the award (action) date, recipient named by the government, awarding agency, total value (obligated dollars plus unexercised ceiling — not revenue received), outlays when reported, period-of-performance end date, and description. Coverage: only prime contract awards of $1M or more that resolve to a listed company are included, so sums understate total federal revenue. Useful for gauging a company's reliance on federal spending; use GetTopGovernmentContractors to rank companies market-wide.
Parameters7
ticker
string
required
Stock ticker symbol (e.g., LMT, RTX, BA)
startDate
string
optional
Start date in YYYY-MM-DD format, filtering on the award action date (defaults to 1 year ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to today)
maxResults
integer
optional
Maximum number of awards to return (default: 50)
sortBy
string
optional
Sort order: 'amount' (largest total value first, default) or 'date' (most recent award first)
agency
string
optional
Optional case-insensitive substring filter on the awarding agency (e.g., 'Defense')
offset
integer
optional
Number of matching awards to skip before returning rows (default: 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., LMT, RTX, BA)",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format, filtering on the award action date (defaults to 1 year ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to today)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of awards to return (default: 50)",
"type": "integer",
"default": 50
},
"sortBy": {
"description": "Sort order: 'amount' (largest total value first, default) or 'date' (most recent award first)",
"type": "string",
"default": "amount"
},
"agency": {
"description": "Optional case-insensitive substring filter on the awarding agency (e.g., 'Defense')",
"type": "string",
"default": null
},
"offset": {
"description": "Number of matching awards to skip before returning rows (default: 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetCorrelatedStocks
Get the stocks whose daily price returns are most (or least) correlated with one stock — Pearson correlation of daily log returns on comparable raw closes (dividends excluded), computed over the trading days both stocks priced, never on raw price levels. Scope picks the candidate universe: Industry (default) ranks the subject's direct industry peers; Sector widens to sibling industries; Market ranges across the ~1,500 largest listed names and surfaces cross-industry relationships the classification misses (suppliers, commodity proxies). direction=Negative flips the ranking to the strongest inverse movers (hedge candidates). Candidates need a $100M market cap and enough overlapping trading days with the subject; each row reports the observation count behind its coefficient. Use GetStockPrices for the underlying series and the screener for fundamentals-based peer sets.
Parameters5
ticker
string
required
Exact listed ticker symbol (e.g., GOOG, GOOGL, BRK-A or BRK-B). Dot class-share notation such as BRK.A is also accepted.
scope
string
optional
Candidate universe: Industry (default), Sector, or Market (~1,500 largest listed names).
days
integer
optional
Trailing calendar window in days for the return series (default 180, clamped to 30-730).
direction
string
optional
Positive (default) for the strongest co-movers, Negative for the strongest inverse movers.
maxResults
integer
optional
Maximum number of stocks to return (default 10, max 50).
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Exact listed ticker symbol (e.g., GOOG, GOOGL, BRK-A or BRK-B). Dot class-share notation such as BRK.A is also accepted.",
"type": "string"
},
"scope": {
"description": "Candidate universe: Industry (default), Sector, or Market (~1,500 largest listed names).",
"type": "string",
"default": "Industry"
},
"days": {
"description": "Trailing calendar window in days for the return series (default 180, clamped to 30-730).",
"type": "integer",
"default": 180
},
"direction": {
"description": "Positive (default) for the strongest co-movers, Negative for the strongest inverse movers.",
"type": "string",
"default": "Positive"
},
"maxResults": {
"description": "Maximum number of stocks to return (default 10, max 50).",
"type": "integer",
"default": 10
}
},
"required": [
"ticker"
]
}
GetAverageTrueRange
Average True Range (ATR) for a stock. Wilder's volatility measure built from the True Range (max of high-low, |high-prev_close|, |low-prev_close|) and smoothed recursively. Higher ATR means wider daily moves; commonly used for position sizing and stop placement. ATR is denominated in the stock's price units (USD). The smoothing is warmed up on price history fetched before startDate, so values do not depend on the requested range's left edge.
Parameters5
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 6 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
period
integer
optional
Smoothing window (default: 14)
maxResults
integer
optional
Maximum number of records to return (default: 60, max: 500); the newest rows are kept and listed newest first.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 6 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"period": {
"description": "Smoothing window (default: 14)",
"type": "integer",
"default": 14
},
"maxResults": {
"description": "Maximum number of records to return (default: 60, max: 500); the newest rows are kept and listed newest first.",
"type": "integer",
"default": 60
}
},
"required": [
"ticker"
]
}
GetMyPortfolio
Get the caller's saved portfolios, and those colleagues shared with the caller's organization, including stock and option lots, cost basis, realized and unrealized profit, and watched instruments. Omit portfolio to list portfolios; if exactly one exists it is returned in full. Pass its name to select one; a shared portfolio whose name is also taken is named "Name (Creator)" in the list. Quantities are signed; costs are the owner's per-share inputs and are never split-restated. Each position is in its listing's currency; totals are in the portfolio's currency at the official rates named in the answer. Every mark names its session. Unpriceable and expired positions have unknown value, never zero. Watched instruments are not positions and must not be counted as exposure. Returned lot ids address the update, close and remove tools. Use GetInstitutionPortfolio for 13F holdings.
Parameters1
portfolio
string
optional
Optional. The portfolio's name, as listed. Omit to list the portfolios.
Raw schema
{
"type": "object",
"properties": {
"portfolio": {
"description": "Optional. The portfolio's name, as listed. Omit to list the portfolios.",
"type": "string",
"default": null
}
}
}
CreateMyPortfolio
Create a new, empty portfolio in the USER's own Equibles account, then add holdings to it with AddPortfolioLot. Ask the user before creating one, since it is their account. Names are unique within an account, and re-creating a name that already exists is rejected rather than merged. Totals are reported in the portfolio's currency; each holding stays in the currency its listing trades in.
Parameters2
name
string
required
A short name for the portfolio, e.g. Main or Retirement.
currency
string
optional
Optional. ISO code the totals are reported in: USD (default), EUR, GBP, CHF, DKK, NOK, SEK, CNY or HKD. Use the user's home currency.
Raw schema
{
"type": "object",
"properties": {
"name": {
"description": "A short name for the portfolio, e.g. Main or Retirement.",
"type": "string"
},
"currency": {
"description": "Optional. ISO code the totals are reported in: USD (default), EUR, GBP, CHF, DKK, NOK, SEK, CNY or HKD. Use the user's home currency.",
"type": "string",
"default": null
}
},
"required": [
"name"
]
}
SearchFunds
Search the tracked SEC Form NPORT-P fund directory by fund name, ticker, SEC series ID, or registrant. Returns one canonical profile per series with ticker, registration type, latest report date, assets, and reported-versus-stored holding counts. Exact stored tickers outrank verified share-class aliases. Use the profile ID with GetFundProfile. The directory covers NPORT-P filers; a miss is a dataset-coverage result, not proof that a fund does not exist.
Parameters2
query
string
required
Fund name, ticker, registrant, or verified share-class alias (e.g., 'Russell 2000', 'iShares', 'IWM', 'VOO').
maxResults
integer
optional
Maximum number of funds to return, largest by net assets first (default: 20, max: 500)
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Fund name, ticker, registrant, or verified share-class alias (e.g., 'Russell 2000', 'iShares', 'IWM', 'VOO').",
"type": "string"
},
"maxResults": {
"description": "Maximum number of funds to return, largest by net assets first (default: 20, max: 500)",
"type": "integer",
"default": 20
}
},
"required": [
"query"
]
}
SuggestToolImprovement
Suggest the smallest actionable contract improvement to an existing Equibles tool you actually called when it worked as documented but lacked a useful operation, filter, parameter or output option. Answer the user first; this records a future improvement and does not change the current call. Describe the call, never the person or their question. Omit private or user-provided argument values or replace them with [redacted]. Mention briefly that you suggested it. Use ReportProblem for wrong data; do not request new tools, duplicate existing options, or report non-Equibles ideas.
Parameters4
toolName
string
required
The existing Equibles tool you actually called, e.g. GetCompanyKpis.
limitation
string
required
The concrete limitation encountered in that call. State what the current operation, filter, parameter, or output contract could not do. Describe the call only — never the user or their question. Do not submit placeholder-only text such as N/A.
suggestedChange
string
required
The smallest actionable change you recommend, including the proposed operation, filter, parameter, or output behaviour and why it would resolve the limitation. Do not submit placeholder-only text such as N/A.
arguments
string
optional
Optional. The arguments you passed to the existing tool, as JSON or key=value pairs, so the limitation can be reproduced. Omit or redact any user-provided or private text.
Raw schema
{
"type": "object",
"properties": {
"toolName": {
"description": "The existing Equibles tool you actually called, e.g. GetCompanyKpis.",
"type": "string"
},
"limitation": {
"description": "The concrete limitation encountered in that call. State what the current operation, filter, parameter, or output contract could not do. Describe the call only — never the user or their question. Do not submit placeholder-only text such as N/A.",
"type": "string"
},
"suggestedChange": {
"description": "The smallest actionable change you recommend, including the proposed operation, filter, parameter, or output behaviour and why it would resolve the limitation. Do not submit placeholder-only text such as N/A.",
"type": "string"
},
"arguments": {
"description": "Optional. The arguments you passed to the existing tool, as JSON or key=value pairs, so the limitation can be reproduced. Omit or redact any user-provided or private text.",
"type": "string",
"default": null
}
},
"required": [
"toolName",
"limitation",
"suggestedChange"
]
}
GetEtfHoldings
Get an ETF's stored portfolio holdings from its latest SEC Form NPORT-P report, largest position first. Coverage is full, partial, or unknown when counts are missing or inconsistent. Use offset to continue through broad portfolios.
Get the speaker-labelled transcript of a company's earnings call for a fiscal quarter — every speaker turn in order, attributed to the real person (executive or sell-side analyst) with their role at the time. Identities appear only when the resolution is trusted (auto-resolved or human-reviewed); unverified voices show as a role label (e.g. Operator) or a neutral speaker number. Use GetEarningsCallEvent first to check a transcript exists.
Parameters5
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
fiscalYear
integer | null
optional
Company fiscal year. Omit both period fields for the latest call; year alone selects the latest call in that fiscal year.
fiscalQuarter
integer | null
optional
Company fiscal quarter, 1-4. Quarter alone selects the latest matching quarter across fiscal years; provide both fields for an exact period.
limit
integer
optional
Maximum number of speaker turns to return (default 50, max 200; values outside 1-200 are clamped)
offset
integer
optional
Number of leading speaker turns to skip, for paging through calls longer than the 200-turn cap (default 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"fiscalYear": {
"description": "Company fiscal year. Omit both period fields for the latest call; year alone selects the latest call in that fiscal year.",
"type": [
"integer",
"null"
],
"default": null
},
"fiscalQuarter": {
"description": "Company fiscal quarter, 1-4. Quarter alone selects the latest matching quarter across fiscal years; provide both fields for an exact period.",
"type": [
"integer",
"null"
],
"default": null
},
"limit": {
"description": "Maximum number of speaker turns to return (default 50, max 200; values outside 1-200 are clamped)",
"type": "integer",
"default": 50
},
"offset": {
"description": "Number of leading speaker turns to skip, for paging through calls longer than the 200-turn cap (default 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetIpoFeed
Get the US S-1/F-1 registration pipeline, newest filing activity first. Rows distinguish Primary, Resale, DirectListing, NonOffering and Unknown transactions; terms come from the newest effective prospectus or latest filing and never a superseded document. Results include lifecycle, proposed listing, applicable offer terms and latest annual XBRL financials in the filer's currency. Filter lifecycle or SEC-classified SPAC versus operating filers. Use a row's CIK with GetIpoDetails for the filing chain and extracted detail.
Parameters4
status
string
optional
Optional lifecycle filter: Filed, Priced, Listed, or Withdrawn. Omit for all.
filerType
string
optional
Optional company-type filter: Operating (non-SPAC) or Spac (SIC 6770 blank checks). Omit for all.
limit
integer
optional
Maximum registrations to return, newest filing activity first (default 25).
offset
integer
optional
Number of matching registrations to skip before returning rows (default 0).
Raw schema
{
"type": "object",
"properties": {
"status": {
"description": "Optional lifecycle filter: Filed, Priced, Listed, or Withdrawn. Omit for all.",
"type": "string",
"default": null
},
"filerType": {
"description": "Optional company-type filter: Operating (non-SPAC) or Spac (SIC 6770 blank checks). Omit for all.",
"type": "string",
"default": null
},
"limit": {
"description": "Maximum registrations to return, newest filing activity first (default 25).",
"type": "integer",
"default": 25
},
"offset": {
"description": "Number of matching registrations to skip before returning rows (default 0).",
"type": "integer",
"default": 0
}
}
}
GetIndexForecast
Apply an index's published entry rules and return candidates with rule-by-rule evidence. S&P results are SCREENS because a committee chooses additions; the S&P 500 adds versioned 90-day empirical join probabilities for eligible candidates and exit probabilities for every member. They are estimates, not guarantees. Russell and Nasdaq-100 are PROJECTIONS decided by published rankings. A non-member with a missing figure has no entry verdict. An unmeasured member stays out of deterministic departure buckets, while the S&P 500 gives it the neutral exit baseline. The Dow has no quantitative rule or forecast. Each model revision is immutable. A model-version change may append a higher revision for the same trading day, and readers use the highest revision.
Parameters2
index
string
required
Index name or slug, for example "S&P 500", "nasdaq-100" or "Russell 2000". The Dow is not forecastable.
maxResults
integer
optional
Maximum companies to return per bucket (default 25, max 1000).
Raw schema
{
"type": "object",
"properties": {
"index": {
"description": "Index name or slug, for example \"S&P 500\", \"nasdaq-100\" or \"Russell 2000\". The Dow is not forecastable.",
"type": "string"
},
"maxResults": {
"description": "Maximum companies to return per bucket (default 25, max 1000).",
"type": "integer",
"default": 25
}
},
"required": [
"index"
]
}
GetLatestEconomicIndicators
Get the latest values for key economic indicators across categories: interest rates, yield spreads, inflation, employment, GDP, money supply, sentiment, housing, exchange rates, and market indicators. Each row shows a series' latest stored observation with its date, plus the previous observation and the change between them for direction — check the Latest Date column for freshness. Returns a snapshot of current macro conditions.
Get an institution's quarterly position-change activity — Initiated / Increased / Reduced / Exited stocks diffed against the immediately prior quarter. Common shares, put/call positions and principal amounts are separate rows labelled by Type. Returns the buckets as one markdown section per bucket, sorted by absolute Δ market-value desc (Δ Value includes price movement, not just trading). Use `bucket` to filter to a single bucket. Use this to answer 'what did this fund do this quarter?'
Parameters4
institutionName
string
required
Institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format (defaults to the holder's latest; an off-quarter date snaps to the nearest report on or before it)
bucket
string
optional
Filter to a single bucket: initiated, increased, reduced, exited (omit for all four)
maxResults
integer
optional
Maximum number of stocks to return per bucket (default: 20, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"institutionName": {
"description": "Institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)",
"type": "string"
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format (defaults to the holder's latest; an off-quarter date snaps to the nearest report on or before it)",
"type": "string",
"default": null
},
"bucket": {
"description": "Filter to a single bucket: initiated, increased, reduced, exited (omit for all four)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of stocks to return per bucket (default: 20, clamped to 1-500)",
"type": "integer",
"default": 20
}
},
"required": [
"institutionName"
]
}
GetTopHolders
Get the top institutional holders (fund managers) of an exact stock or ETF listing from SEC 13F-HR filings. Returns a ranked list by shares held, including published position value and percentage of total institutional 13F shares (not of shares outstanding). Values normally use report-date closing prices, may fall back to filer values, and can be zero when unavailable. During the newest quarter's filing window, non-ETF primary stocks carry non-filers' prior-quarter positions; ETF listings remain exact and as-filed because carry-forward is filer-wide. Use position type before treating put/call rows as ownership.
Parameters4
ticker
string
required
Listed security ticker (e.g., AAPL, VOO)
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format, e.g. 2026-03-31 (defaults to the latest available; an off-quarter date snaps to the nearest report on or before it)
maxResults
integer
optional
Maximum number of holding rows to return (default: 20, clamped to 1-500)
offset
integer
optional
Number of ranked holding rows to skip before returning results (default: 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed security ticker (e.g., AAPL, VOO)",
"type": "string"
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format, e.g. 2026-03-31 (defaults to the latest available; an off-quarter date snaps to the nearest report on or before it)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of holding rows to return (default: 20, clamped to 1-500)",
"type": "integer",
"default": 20
},
"offset": {
"description": "Number of ranked holding rows to skip before returning results (default: 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
ClosePortfolioLot
Record that the USER sold (or covered, or let expire) all or part of a lot, at a price and on a date. The lot moves out of the open positions and its realized profit is kept. Ask the user for the closing price and date; never guess them from a market quote.
Closing PART of a lot splits it: the closed part keeps the original cost basis and the rest stays open on that same basis, so a later sale is still priced against what was actually paid.
An option that expired worthless closes at a price of 0. An option that was exercised or assigned closes here too, and the resulting shares are a separate AddPortfolioLot.
Parameters5
portfolio
string
required
The portfolio holding the lot, by name.
lotId
string
required
The lot id shown by GetMyPortfolio, e.g. a1b2c3d4.
closePrice
number
required
Price per share received (or paid, to cover a short). Zero for an option that expired worthless.
closeDate
string
required
The closing date, as yyyy-MM-dd. Cannot be in the future or before the lot was acquired.
quantity
number | null
optional
Optional. How much of the lot to close, as a positive size. Omit to close all of it.
Raw schema
{
"type": "object",
"properties": {
"portfolio": {
"description": "The portfolio holding the lot, by name.",
"type": "string"
},
"lotId": {
"description": "The lot id shown by GetMyPortfolio, e.g. a1b2c3d4.",
"type": "string"
},
"closePrice": {
"description": "Price per share received (or paid, to cover a short). Zero for an option that expired worthless.",
"type": "number"
},
"closeDate": {
"description": "The closing date, as yyyy-MM-dd. Cannot be in the future or before the lot was acquired.",
"type": "string"
},
"quantity": {
"description": "Optional. How much of the lot to close, as a positive size. Omit to close all of it.",
"type": [
"number",
"null"
],
"default": null
}
},
"required": [
"portfolio",
"lotId",
"closePrice",
"closeDate"
]
}
GetEarningsCallToneAndThemes
Get the AI-scored insights for a company's recent earnings calls — the management-tone read (a net tone score and a hedging score) and the call's key themes with their computed mention counts and per-theme tone. Newest call first. Verifier-approved — only scored and approved calls appear, so quarters can be missing from the sequence (a gap note flags non-consecutive quarters). Use it to gauge how confident or guarded management sounded and what they talked about most.
Parameters4
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
limit
integer
optional
Maximum number of scored calls to return, newest first (default 2, max 8; values outside 1-8 are clamped)
fiscalYear
integer | null
optional
Company fiscal year. Omit both period fields for newest results; year alone filters that fiscal year.
fiscalQuarter
integer | null
optional
Company fiscal quarter, 1-4. Quarter alone filters that quarter across fiscal years; both fields select an exact period.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"limit": {
"description": "Maximum number of scored calls to return, newest first (default 2, max 8; values outside 1-8 are clamped)",
"type": "integer",
"default": 2
},
"fiscalYear": {
"description": "Company fiscal year. Omit both period fields for newest results; year alone filters that fiscal year.",
"type": [
"integer",
"null"
],
"default": null
},
"fiscalQuarter": {
"description": "Company fiscal quarter, 1-4. Quarter alone filters that quarter across fiscal years; both fields select an exact period.",
"type": [
"integer",
"null"
],
"default": null
}
},
"required": [
"ticker"
]
}
SearchCftcMarkets
Search the tracked CFTC futures contracts by name, market code, common contract name, or standard futures symbol, or omit the query to list every tracked contract. Coverage is a curated set of ~35 major contracts across Agriculture, Energy, Metals, Equity Indices, Interest Rates, and Currencies - markets outside this set have no COT data here. Returns matching contracts with their codes and categories; use this to discover market codes before calling GetCftcPositioning.
Parameters2
query
string
optional
Search query — market code, name words, common name, or standard symbol (e.g., 'gold futures', 'WTI', 'ES', 'S&P 500', '088691'). Search requires every punctuation-independent word first and broadens to any word only when no strict row matches. Omit to list all tracked contracts.
maxResults
integer
optional
Maximum number of results to return (default: 50, max: 500)
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Search query — market code, name words, common name, or standard symbol (e.g., 'gold futures', 'WTI', 'ES', 'S&P 500', '088691'). Search requires every punctuation-independent word first and broadens to any word only when no strict row matches. Omit to list all tracked contracts.",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of results to return (default: 50, max: 500)",
"type": "integer",
"default": 50
}
}
}
GetIndexComposition
Get the current constituent list of a major US stock index: S&P 500, S&P MidCap 400, S&P SmallCap 600, Nasdaq-100, Russell 1000, Russell 2000, or the Dow Jones Industrial Average. Each row carries the company's rank by weight, its ticker, and its share of the index. The list is a full-replication tracking fund's own disclosed holdings, taken from an SEC Form N-PORT filing or from the holdings file the fund publishes daily, and the answer names which fund and which date it came from. A list is only published once a fund's filing reaches us whole, so a partial filing is never served as a shrunken index. Rows that could not be matched to a tracked company are listed under the name the fund reported rather than dropped, because a dropped row would make the index look shorter than it is. Use GetIndexChanges for what has joined or left, and GetIndexForecast for who the published rules point to next.
Parameters3
index
string
required
Index name or slug, for example "S&P 500", "sp-500", "nasdaq-100" or "Russell 2000".
maxResults
integer
optional
Maximum constituents to return, heaviest first (default 100, max 500).
offset
integer
optional
Rows to skip before returning, for paging through a full list (default 0).
Raw schema
{
"type": "object",
"properties": {
"index": {
"description": "Index name or slug, for example \"S&P 500\", \"sp-500\", \"nasdaq-100\" or \"Russell 2000\".",
"type": "string"
},
"maxResults": {
"description": "Maximum constituents to return, heaviest first (default 100, max 500).",
"type": "integer",
"default": 100
},
"offset": {
"description": "Rows to skip before returning, for paging through a full list (default 0).",
"type": "integer",
"default": 0
}
},
"required": [
"index"
]
}
GetLatestCftcPositioning
Get the latest COT positioning snapshot across all tracked futures contracts, grouped by category (Agriculture, Energy, Metals, Equity Indices, Interest Rates, Currencies). Shows commercial and non-commercial net positions in contract counts from the legacy futures-only COT report (positions as of each Tuesday, published Friday). Each row carries the market code accepted by GetCftcPositioning.
Get recent investor-relations press releases for a stock, scraped from the company's IR website. Returns the most recent news items (headline, publish date, summary when the source provides one, and link) in reverse-chronological order. Use this to see a company's latest official announcements straight from its IR page, distinct from third-party news. Coverage is partial — only companies whose IR page has been discovered and content-scraped have items, so an empty answer may be a coverage gap rather than corporate silence; the response says which case applies.
Parameters4
ticker
string
required
Company ticker symbol (e.g., NVDA)
maxResults
integer
optional
Maximum number of news items to return (default: 20, max: 500)
since
string
optional
Optional earliest publish date, strict yyyy-MM-dd (UTC). Only items published on or after this date are returned.
offset
integer
optional
Number of matching news items to skip before returning rows (default: 0).
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., NVDA)",
"type": "string"
},
"maxResults": {
"description": "Maximum number of news items to return (default: 20, max: 500)",
"type": "integer",
"default": 20
},
"since": {
"description": "Optional earliest publish date, strict yyyy-MM-dd (UTC). Only items published on or after this date are returned.",
"type": "string",
"default": null
},
"offset": {
"description": "Number of matching news items to skip before returning rows (default: 0).",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
SearchDocument
Search one SEC filing or earnings-call transcript by document ID. semantic mode uses hybrid relevance and returns excerpts in document order with approximate line numbers. exact mode performs a literal case-insensitive substring match and returns precise matching lines. Get document IDs from SearchDocuments or ListFilings; use ReadDocumentLines for surrounding text.
Parameters5
query
string
required
Search query — plain keywords or a short natural-language phrase. When too few excerpts match every word, the search automatically broadens to match any of the words. In searchMode 'exact', matched as a literal case-insensitive substring.
documentId
string
required
Document ID obtained from ListFilings or a SearchDocuments result header
maxResults
integer
optional
Maximum number of results to return (default: 5)
maxExcerptChars
integer
optional
Maximum characters per excerpt (default: 0 = full excerpt). Set a small value (e.g. 400) for a compact scan across many results; truncated excerpts end with an explicit note.
searchMode
string
optional
How to match: 'semantic' (default — hybrid keyword and semantic relevance) or 'exact' (literal case-insensitive substring match with precise line numbers).
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Search query — plain keywords or a short natural-language phrase. When too few excerpts match every word, the search automatically broadens to match any of the words. In searchMode 'exact', matched as a literal case-insensitive substring.",
"type": "string"
},
"documentId": {
"description": "Document ID obtained from ListFilings or a SearchDocuments result header",
"type": "string",
"format": "uuid"
},
"maxResults": {
"description": "Maximum number of results to return (default: 5)",
"type": "integer",
"default": 5
},
"maxExcerptChars": {
"description": "Maximum characters per excerpt (default: 0 = full excerpt). Set a small value (e.g. 400) for a compact scan across many results; truncated excerpts end with an explicit note.",
"type": "integer",
"default": 0
},
"searchMode": {
"description": "How to match: 'semantic' (default — hybrid keyword and semantic relevance) or 'exact' (literal case-insensitive substring match with precise line numbers).",
"type": "string",
"default": "semantic"
}
},
"required": [
"query",
"documentId"
]
}
GetStockPrices
Get daily OHLCV (Open, High, Low, Close, Volume) price history for a stock. Useful for technical analysis, charting, and price trend analysis. Prices are in USD. An Adj Close column shows the provider's split- and cash-dividend-adjusted close when it differs from Close. Captured corporate-action changes trigger a full-history refresh of the exact listed series, but the stored rows do not certify which split basis the provider returned. Do not treat reconciliation status alone as proof that a window is a consistent total-return series. Zero-volume carry-forward candles are excluded because they do not establish a traded market price.
Parameters4
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT, TSLA). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 1 year ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of records to return (default: 260, max: 500). When the range holds more rows the newest are kept; rows are always listed oldest to newest.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT, TSLA). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 1 year ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of records to return (default: 260, max: 500). When the range holds more rows the newest are kept; rows are always listed oldest to newest.",
"type": "integer",
"default": 260
}
},
"required": [
"ticker"
]
}
GetEconomicCalendar
Get the economic release calendar — scheduled (upcoming) and recent publication dates of US macro data releases, with the FRED series each release updates and an importance tier per release (High = the tier-1 scheduled market movers: CPI, PPI, Employment Situation, GDP, PCE, retail sales; Medium = other genuine scheduled prints; Low = daily rate/market levels like SOFR or VIX). FOMC meetings are NOT included — FRED's release feed has no real FOMC meeting dates; use the Federal Reserve's published meeting calendar for those. Defaults to the next 30 days. Use minImportance=high to see only the market movers, and GetEconomicIndicator to fetch a series' data after it prints.
Parameters4
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to today, UTC)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to 30 days after the start date)
minImportance
string
optional
Minimum importance tier to include: low, medium, or high (defaults to low = everything)
maxResults
integer
optional
Maximum number of release dates to return (default: 100, max: 500, chronological)
Raw schema
{
"type": "object",
"properties": {
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to today, UTC)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to 30 days after the start date)",
"type": "string",
"default": null
},
"minImportance": {
"description": "Minimum importance tier to include: low, medium, or high (defaults to low = everything)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of release dates to return (default: 100, max: 500, chronological)",
"type": "integer",
"default": 100
}
}
}
GetFinancialStatement
Get a company's income statement, balance sheet, or cash-flow statement for a given fiscal year and period, sourced from SEC Company Facts (structured XBRL). Returns the standard line items (e.g. revenue, net income, total assets, operating cash flow) with the latest-restated value for one exact statement period end. Quarterly flow rows are always discrete quarters: when the filer reports only cumulative year-to-date USD values, the quarter is derived by exact subtraction from the preceding cumulative period and marked Derived. Company-specific dimensional facts (e.g. product-segment revenue) are not included — use GetRevenueBreakdown for segment/geographic revenue, and GetFinancialFact or CompareFinancialFact for one line item across periods or across companies.
Parameters4
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT, GME)
statement
string
optional
Statement: 'income' (income statement), 'balance' (balance sheet), or 'cashflow' (cash-flow statement); the aliases 'is'/'p&l', 'bs' and 'cf' also work. Defaults to income.
year
integer | null
optional
Fiscal year, e.g. 2023. Defaults to the latest reported year.
period
string
optional
Fiscal period: 'FY' (annual) or 'Q1'..'Q4'. Defaults to the latest reported period. Most filers report no discrete Q4 income/cash-flow facts in XBRL (the fourth quarter is embedded in the full-year figure) — use 'FY' for annual figures.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT, GME)",
"type": "string"
},
"statement": {
"description": "Statement: 'income' (income statement), 'balance' (balance sheet), or 'cashflow' (cash-flow statement); the aliases 'is'/'p&l', 'bs' and 'cf' also work. Defaults to income.",
"type": "string",
"default": "income"
},
"year": {
"description": "Fiscal year, e.g. 2023. Defaults to the latest reported year.",
"type": [
"integer",
"null"
],
"default": null
},
"period": {
"description": "Fiscal period: 'FY' (annual) or 'Q1'..'Q4'. Defaults to the latest reported period. Most filers report no discrete Q4 income/cash-flow facts in XBRL (the fourth quarter is embedded in the full-year figure) — use 'FY' for annual figures.",
"type": "string",
"default": null
}
},
"required": [
"ticker"
]
}
ListFilings
List stored SEC filings and earnings-call transcripts newest first. Omit ticker for a market-wide feed or provide one ticker for a company-specific list. Returns company identity, document IDs, types, filing and reporting dates, SEC item numbers, line counts, and page totals. Supports date, document-type, and exact SEC item-number filters. Hidden document types remain excluded unless explicitly requested. Pass a returned ID to SearchDocument or ReadDocumentLines.
Parameters7
ticker
string
optional
Optional company ticker symbol (e.g., AAPL, MSFT). Omit for all companies.
page
integer
optional
Page number for pagination (default: 1)
maxItems
integer
optional
Maximum number of documents per page (default: 10)
startDate
string | null
optional
Optional start date filter in YYYY-MM-DD format
endDate
string | null
optional
Optional end date filter in YYYY-MM-DD format
documentType
string
optional
Document type filter. Accepts a registered type value — 'TenK', 'TenQ', 'EightK', 'TenKa', 'TenQa', 'EightKa', 'TwentyF', 'SixK', 'FortyF', 'TwentyFa', 'SixKa', or 'FortyFa' — or its display name (e.g. '10-K', '20-F/A'), plus any deployment-registered type, such as EarningsCallTranscript (display name: Earnings Call) for earnings-call transcripts where available. An unrecognized value returns an error listing every accepted value.
itemNumber
string
optional
Optional exact SEC current-report item number, e.g. 2.02, 5.02, or 1.01.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Optional company ticker symbol (e.g., AAPL, MSFT). Omit for all companies.",
"type": "string",
"default": null
},
"page": {
"description": "Page number for pagination (default: 1)",
"type": "integer",
"default": 1
},
"maxItems": {
"description": "Maximum number of documents per page (default: 10)",
"type": "integer",
"default": 10
},
"startDate": {
"description": "Optional start date filter in YYYY-MM-DD format",
"type": [
"string",
"null"
],
"format": "date-time",
"default": null
},
"endDate": {
"description": "Optional end date filter in YYYY-MM-DD format",
"type": [
"string",
"null"
],
"format": "date-time",
"default": null
},
"documentType": {
"description": "Document type filter. Accepts a registered type value — 'TenK', 'TenQ', 'EightK', 'TenKa', 'TenQa', 'EightKa', 'TwentyF', 'SixK', 'FortyF', 'TwentyFa', 'SixKa', or 'FortyFa' — or its display name (e.g. '10-K', '20-F/A'), plus any deployment-registered type, such as EarningsCallTranscript (display name: Earnings Call) for earnings-call transcripts where available. An unrecognized value returns an error listing every accepted value.",
"type": "string",
"default": null
},
"itemNumber": {
"description": "Optional exact SEC current-report item number, e.g. 2.02, 5.02, or 1.01.",
"type": "string",
"default": null
}
}
}
ReportProblem
Report an Equibles tool call you actually made when it failed, timed out, was unexpectedly empty (ToolFailed), or returned verifiably impossible or contradictory data (ImplausibleResult). Answer the user first, then retry or use a fallback; this report does not fix the current call. Report the call and response, never the person or their question. Omit private or user-provided argument values or replace them with [redacted]. Mention briefly that you flagged it. Do not report surprising-but-plausible data, missing tools, feature requests, or non-Equibles tools.
Parameters5
problemKind
string
required
Either 'ToolFailed' (error, timeout, or unexpectedly empty) or 'ImplausibleResult' (answered, but the data cannot be right).
toolName
string
required
The Equibles tool that misbehaved, e.g. GetCompanyKpis.
observation
string
required
What went wrong, in one or two sentences: the error text, or why the figures are not credible. Describe the call and its response only — never the user or their question. Do not submit placeholder-only text such as N/A.
expected
string
optional
Optional. What you expected instead, and how you know — a figure from another Equibles tool, a filing, or the tool's own documented behaviour. This is what makes an implausible-result report reproducible.
arguments
string
optional
Optional. The arguments you passed to the failing tool, as JSON or key=value pairs, so the call can be replayed. Omit or redact any user-provided or private text.
Raw schema
{
"type": "object",
"properties": {
"problemKind": {
"description": "Either 'ToolFailed' (error, timeout, or unexpectedly empty) or 'ImplausibleResult' (answered, but the data cannot be right).",
"type": "string"
},
"toolName": {
"description": "The Equibles tool that misbehaved, e.g. GetCompanyKpis.",
"type": "string"
},
"observation": {
"description": "What went wrong, in one or two sentences: the error text, or why the figures are not credible. Describe the call and its response only — never the user or their question. Do not submit placeholder-only text such as N/A.",
"type": "string"
},
"expected": {
"description": "Optional. What you expected instead, and how you know — a figure from another Equibles tool, a filing, or the tool's own documented behaviour. This is what makes an implausible-result report reproducible.",
"type": "string",
"default": null
},
"arguments": {
"description": "Optional. The arguments you passed to the failing tool, as JSON or key=value pairs, so the call can be replayed. Omit or redact any user-provided or private text.",
"type": "string",
"default": null
}
},
"required": [
"problemKind",
"toolName",
"observation"
]
}
GetSuperInvestors
Get the curated superinvestor directory — a hand-picked list of well-known value investors and fund managers (Buffett, Ackman, Burry, Klarman and more), each with their 13F filer CIK and latest reported portfolio value, position count, quarter-over-quarter change, and report date. Portfolio value covers long US-listed 13F positions only, not total firm AUM; as-of dates vary by filer, and rows lagging the group's latest quarter are marked (stale). Use the returned CIK with GetInstitutionPortfolio for a manager's full holdings, or GetInstitutionQuarterlyActivity for their latest buys and sells.
Parameters
No parameters.
Raw schema
{
"type": "object",
"properties": {}
}
GetLiveQuote
Get the latest available consolidated SIP intraday reading for active U.S. listings, including last trade, UTC timestamp, session freshness, and bid/ask. This needs a paid plan: Pro receives real-time readings and Plus receives 15-minute-delayed readings, while the Free plan covers end-of-day data only and is answered with an upgrade note. Stale=true means the returned trade predates the expected market session and must not be reported as current. This tool does not backfill historical intraday bars after hours. Missing readings are listed explicitly. Use GetLatestClosingPrices or GetStockPrices for settled daily bars.
Permanently delete one of the USER's own portfolios and every lot in it, open and closed. This cannot be undone and it destroys the recorded cost basis and realized-profit history. ALWAYS confirm with the user first, naming the portfolio and how many lots it holds. Call GetMyPortfolio if you do not already know.
Parameters1
name
string
required
The exact name of the portfolio to delete.
Raw schema
{
"type": "object",
"properties": {
"name": {
"description": "The exact name of the portfolio to delete.",
"type": "string"
}
},
"required": [
"name"
]
}
GetExecutiveChanges
Get a company's executive and director changes — CEO/CFO/officer/board appointments, resignations, terminations, and retirements — as disclosed in its 8-K Item 5.02 filings, newest filing first. Each change carries the person's name, the role text exactly as filed, a separate normalized role classification, the action, the effective date when stated, the verbatim disclosure, and the source filing (form + link). Changes are extracted from the filings' narrative text and verified before publication. Coverage is still back-filling: the output names the oldest covered filing date, and an empty answer distinguishes 'covered filings disclose no changes' from 'filings not yet processed'.
Parameters6
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT).
maxResults
integer
optional
Maximum changes to return (default 25, cap 100).
action
string
optional
Optional action filter: Appointed, Resigned, Terminated, or Retired.
startDate
string
optional
Optional oldest filed date, YYYY-MM-DD.
endDate
string
optional
Optional newest filed date, YYYY-MM-DD.
offset
integer
optional
Number of matching changes to skip before returning rows (default 0).
Search active exchange-traded funds and products by exact ticker, fund name, or sponsor. ETF identity comes from the authoritative security-type reference directory, while assets and holdings come from the linked SEC Form NPORT-P fund series when available. Use GetEtfProfile for analysis or GetEtfHoldings for a paged portfolio.
Parameters2
query
string
required
Ticker, fund name, or sponsor (for example SPY, S&P 500, or iShares).
maxResults
integer
optional
Maximum results to return (default 20, max 500).
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Ticker, fund name, or sponsor (for example SPY, S&P 500, or iShares).",
"type": "string"
},
"maxResults": {
"description": "Maximum results to return (default 20, max 500).",
"type": "integer",
"default": 20
}
},
"required": [
"query"
]
}
SearchInsiders
Search the tracked SEC corporate-insider set (directors, officers, 10% owners) by name. Search first requires every punctuation-independent whole query word in the filed legal name, then broadens to any whole word only when no strict row matches; a token inside a different word is not a match. Verified public-name aliases such as Jensen Huang resolve to the SEC owner identity. Returns CIK, role, latest filing company, and location, ordered by recent filing activity.
Parameters3
query
string
required
Search query for insider name
maxResults
integer
optional
Maximum number of results (default: 10, max: 500; values outside 1-500 are clamped)
offset
integer
optional
Number of matches to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Search query for insider name",
"type": "string"
},
"maxResults": {
"description": "Maximum number of results (default: 10, max: 500; values outside 1-500 are clamped)",
"type": "integer",
"default": 10
},
"offset": {
"description": "Number of matches to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.",
"type": "integer",
"default": 0
}
},
"required": [
"query"
]
}
GetOffExchangeVolume
Get weekly off-exchange (dark pool / OTC) trading volume for an exact stock or ETF listing from the FINRA OTC/ATS Transparency data. Each week shows ATS (alternative trading system / dark pool) volume and trade count, non-ATS OTC volume and trade count, and the total off-exchange volume (ATS + non-ATS OTC). The FINRA file does not include consolidated tape volume, so the off-exchange share of total market volume is not reported here; compute that share elsewhere against a consolidated-volume source. Weeks before 2025-08-11 may include volume from a case-variant sibling security because they predate the ordinal FINRA symbol-map fix and can no longer be re-imported from FINRA's rolling source window. FINRA publishes each week on a delay (2 weeks for Tier 1 NMS stocks, longer for other tiers), so the latest week lags today.
Parameters4
ticker
string
required
Listed security ticker (e.g., AAPL, VOO, GME)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 6 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of weeks to return — keeps the most recent N weeks in the range, displayed oldest to newest (default: 26, max: 500)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed security ticker (e.g., AAPL, VOO, GME)",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 6 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of weeks to return — keeps the most recent N weeks in the range, displayed oldest to newest (default: 26, max: 500)",
"type": "integer",
"default": 26
}
},
"required": [
"ticker"
]
}
UnwatchInstrument
Remove a stock or an option contract from one of the USER's portfolio watchlists. This only removes the watch entry: it never touches a holding, so a stock the portfolio also owns stays exactly as recorded. Confirm with the user before removing.
Address the instrument the way it appears in GetMyPortfolio's Watching section: the symbol shown for a stock (MIC:TICKER for another exchange, e.g. XPAR:AIR), or the OCC symbol in optionContract for an option.
Parameters3
portfolio
string
required
The portfolio whose watchlist to remove from, by name.
ticker
string
optional
The watched stock's symbol as shown, e.g. AAPL or XPAR:AIR. Omit when removing an option by its OCC symbol.
optionContract
string
optional
Optional. The watched option's OCC symbol, e.g. O:AAPL260724C00110000.
Raw schema
{
"type": "object",
"properties": {
"portfolio": {
"description": "The portfolio whose watchlist to remove from, by name.",
"type": "string"
},
"ticker": {
"description": "The watched stock's symbol as shown, e.g. AAPL or XPAR:AIR. Omit when removing an option by its OCC symbol.",
"type": "string",
"default": null
},
"optionContract": {
"description": "Optional. The watched option's OCC symbol, e.g. O:AAPL260724C00110000.",
"type": "string",
"default": null
}
},
"required": [
"portfolio"
]
}
GetInsiderSentimentScores
Rank stocks by a peer-relative 0-100 insider-accumulation score over 90 days: net buyers, net shares bought as a percent of shares outstanding, and net buy value. It uses qualifying open-market Forms 4/5 purchases and sales by officers and directors (a holder that is only a 10% owner is excluded); Form 3 establishes initial ownership, and disclosed Rule 10b5-1 trades are excluded. Filter for cluster buys or liquidity, request the bottom ranking for distribution, or pass ticker for one stock's factors and universe rank. Filters never renumber the universe rank. Use GetInsiderTransactions for the filings.
Parameters8
clusterBuysOnly
boolean
optional
Return only stocks flagged as cluster buys (three or more distinct insiders buying in the window).
minMarketCap
number
optional
Minimum market capitalization in US dollars (e.g. 300000000 = $300M; default 0 = no floor). Stocks with an unknown market cap are excluded when set.
minSharePrice
number
optional
Minimum share price in US dollars (e.g. 5 = $5; default 0 = no floor). Stocks with an unknown price are excluded when set.
minDollarVolume
number
optional
Minimum trailing 3-month average daily dollar volume in US dollars (e.g. 5000000 = $5M/day; default 0 = no floor). Stocks with unknown volume are excluded when set.
maxResults
integer
optional
Maximum number of stocks to return (default: 25, highest score first; clamped to 1-200).
bottom
boolean
optional
Return the LOWEST-scored stocks instead — the heaviest peer-relative net insider selling — lowest score first.
ticker
string
optional
Optional stock ticker (e.g. NVDA): returns that one stock's score, factor breakdown, and rank within the scored universe instead of the leaderboard. The other filters do not apply to a single-ticker lookup.
offset
integer
optional
Number of matching ranked stocks to skip before returning rows (default: 0; ignored for a single-ticker lookup).
Raw schema
{
"type": "object",
"properties": {
"clusterBuysOnly": {
"description": "Return only stocks flagged as cluster buys (three or more distinct insiders buying in the window).",
"type": "boolean",
"default": false
},
"minMarketCap": {
"description": "Minimum market capitalization in US dollars (e.g. 300000000 = $300M; default 0 = no floor). Stocks with an unknown market cap are excluded when set.",
"type": "number",
"default": 0
},
"minSharePrice": {
"description": "Minimum share price in US dollars (e.g. 5 = $5; default 0 = no floor). Stocks with an unknown price are excluded when set.",
"type": "number",
"default": 0
},
"minDollarVolume": {
"description": "Minimum trailing 3-month average daily dollar volume in US dollars (e.g. 5000000 = $5M/day; default 0 = no floor). Stocks with unknown volume are excluded when set.",
"type": "number",
"default": 0
},
"maxResults": {
"description": "Maximum number of stocks to return (default: 25, highest score first; clamped to 1-200).",
"type": "integer",
"default": 25
},
"bottom": {
"description": "Return the LOWEST-scored stocks instead — the heaviest peer-relative net insider selling — lowest score first.",
"type": "boolean",
"default": false
},
"ticker": {
"description": "Optional stock ticker (e.g. NVDA): returns that one stock's score, factor breakdown, and rank within the scored universe instead of the leaderboard. The other filters do not apply to a single-ticker lookup.",
"type": "string",
"default": null
},
"offset": {
"description": "Number of matching ranked stocks to skip before returning rows (default: 0; ignored for a single-ticker lookup).",
"type": "integer",
"default": 0
}
}
}
GetOnBalanceVolume
On-Balance Volume (OBV) for a stock. Running cumulative volume that adds the bar's volume on up-closes, subtracts on down-closes, and stays flat on equal closes. Useful for confirming or diverging from price trends with volume flow. OBV is anchored at 0 on the first bar of the requested range, so absolute values shift with startDate and are not comparable across calls - read the slope and divergences, not the level.
Parameters4
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 6 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of records to return (default: 60, max: 500); the newest rows are kept and listed newest first.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 6 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of records to return (default: 60, max: 500); the newest rows are kept and listed newest first.",
"type": "integer",
"default": 60
}
},
"required": [
"ticker"
]
}
GetInstitutionalOwnershipHistory
Get the historical trend of aggregate reported 13F exposure for an exact stock or ETF listing across multiple quarters. The legacy Total Shares field sums reported quantities across common-share rows, put/call notional-underlying rows, and any tracked principal-denominated rows, so it is not a pure share-ownership measure. Shows total reported quantity, published position value, and filer count. Changes are withheld when a relevant filer has no observed 13F in either compared quarter; missing filings and filer identity changes are not trades. Values normally use report-date closing prices, may fall back to filer values, and can include zero when unavailable. While the newest quarter's filing window is open, non-ETF primary stocks use a provisional combined view; ETF listings remain exact and as-filed because carry-forward is filer-wide.
Parameters2
ticker
string
required
Listed security ticker (e.g., AAPL, VOO)
maxPeriods
integer
optional
Maximum number of quarterly periods to return (default: 8, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed security ticker (e.g., AAPL, VOO)",
"type": "string"
},
"maxPeriods": {
"description": "Maximum number of quarterly periods to return (default: 8, clamped to 1-500)",
"type": "integer",
"default": 8
}
},
"required": [
"ticker"
]
}
ListWebDataFeeds
List the caller's own trackers (recurring, verified website data collections), with schedule, state, visibility, and most recent run. This is read-only and never contacts a source website. To create or manage one, tell the user to open the Equibles Portal and choose Dashboard → Trackers: https://www.equibles.com/trackers
Parameters
No parameters.
Raw schema
{
"type": "object",
"properties": {}
}
GetBuybackPrograms
Get a company's share-repurchase (buyback) picture: tracked repurchase programs (announcement date, authorized total, remaining availability, expiry, source filings), the latest program-authorization figures, and the repurchase history — cash spent, shares repurchased, and average price per fiscal year and recent quarters. Figures come from the company's own XBRL facts plus verified extractions of filings' narrative text; nothing is estimated, and figures a company stopped restating carry an explicit staleness label. For the dilution mirror-image — at-the-market (ATM) equity offering programs — use GetAtmPrograms.
Read analyst consensus forecasts for a company, including revenue, EPS, product, segment and operating metrics. Prefers consensus the company publishes itself through its investor-relations sources and falls back to a compiled consensus; every answer states which kind answered. Returns original units, accounting basis, mean/median/range/count labels, snapshot history and publication dates. Coverage varies by issuer. This reads stored verified data and never scrapes on demand.
Parameters9
ticker
string
required
Stock ticker symbol, e.g. SAP.
metric
string
optional
Exact source metric label; omit to read all metrics.
period
string
optional
Exact source forecast-period label; omit for all periods.
dimensions
string
optional
Exact source dimension label; omit for all products and segments.
snapshotId
string | null
optional
Snapshot identifier from a previous response; omit for latest verified capture.
asOf
string
optional
ISO-8601 UTC cutoff for a snapshot verified at or before this instant.
snapshotOffset
integer
optional
Zero-based snapshot history offset; history is returned in pages of 10.
limit
integer
optional
Maximum observations, default 25, range 1–100.
offset
integer
optional
Zero-based observation offset, default 0, maximum 100000.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol, e.g. SAP.",
"type": "string"
},
"metric": {
"description": "Exact source metric label; omit to read all metrics.",
"type": "string",
"default": null
},
"period": {
"description": "Exact source forecast-period label; omit for all periods.",
"type": "string",
"default": null
},
"dimensions": {
"description": "Exact source dimension label; omit for all products and segments.",
"type": "string",
"default": null
},
"snapshotId": {
"description": "Snapshot identifier from a previous response; omit for latest verified capture.",
"type": [
"string",
"null"
],
"format": "uuid",
"default": null
},
"asOf": {
"description": "ISO-8601 UTC cutoff for a snapshot verified at or before this instant.",
"type": "string",
"default": null
},
"snapshotOffset": {
"description": "Zero-based snapshot history offset; history is returned in pages of 10.",
"type": "integer",
"default": 0
},
"limit": {
"description": "Maximum observations, default 25, range 1–100.",
"type": "integer",
"default": 25
},
"offset": {
"description": "Zero-based observation offset, default 0, maximum 100000.",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
WatchInstrument
Put a stock or an option contract on one of the USER's portfolio watchlists, without recording any position. A watched instrument shows up in GetMyPortfolio's 'Watching (not held)' section with a current mark and nothing else - no quantity, no cost, no value.
For a stock, pass its ticker, or MIC:TICKER for another exchange (e.g. XPAR:AIR). For an option, pass BOTH the underlying ticker and the OCC symbol in optionContract, exactly as AddPortfolioLot takes them; the contract is verified against the live options data before anything is stored.
Watching something the portfolio already holds is allowed - the page shows one row, and selling out later keeps the instrument on the list.
Parameters3
portfolio
string
required
The portfolio whose watchlist to add to, by name.
ticker
string
required
Stock ticker, or MIC:TICKER for a listing on another exchange, e.g. XPAR:AIR. For an option, the UNDERLYING U.S. ticker, e.g. AAPL.
optionContract
string
optional
Optional. The OCC option symbol, e.g. O:AAPL260724C00110000. Provide it to watch an option contract; omit it for the stock itself.
Raw schema
{
"type": "object",
"properties": {
"portfolio": {
"description": "The portfolio whose watchlist to add to, by name.",
"type": "string"
},
"ticker": {
"description": "Stock ticker, or MIC:TICKER for a listing on another exchange, e.g. XPAR:AIR. For an option, the UNDERLYING U.S. ticker, e.g. AAPL.",
"type": "string"
},
"optionContract": {
"description": "Optional. The OCC option symbol, e.g. O:AAPL260724C00110000. Provide it to watch an option contract; omit it for the stock itself.",
"type": "string",
"default": null
}
},
"required": [
"portfolio",
"ticker"
]
}
GetInstitutionPortfolio
View the tracked stock positions of a specific institutional investor from an SEC 13F-HR filing. Shows the largest positions by published value (default 20, max 500), with share counts, value, percent of tracked 13F value, and position count. Values normally use report-date closing prices, may fall back to filer values, and can be zero when unavailable. Coverage is limited to tracked U.S.-listed common stocks and related put/call positions; use position type before treating options as ownership. Use SearchInstitutions first when the name is ambiguous.
Parameters4
institutionName
string
required
Institution name or SEC CIK. A unique partial name resolves; an ambiguous partial returns candidate CIKs instead of selecting silently.
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format (defaults to the holder's latest; an off-quarter date snaps to the nearest report on or before it)
maxResults
integer
optional
Maximum number of holdings to return (default: 20, clamped to 1-500)
offset
integer
optional
Number of ranked holding rows to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.
Raw schema
{
"type": "object",
"properties": {
"institutionName": {
"description": "Institution name or SEC CIK. A unique partial name resolves; an ambiguous partial returns candidate CIKs instead of selecting silently.",
"type": "string"
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format (defaults to the holder's latest; an off-quarter date snaps to the nearest report on or before it)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of holdings to return (default: 20, clamped to 1-500)",
"type": "integer",
"default": 20
},
"offset": {
"description": "Number of ranked holding rows to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.",
"type": "integer",
"default": 0
}
},
"required": [
"institutionName"
]
}
GetDebtInstrument
Get one durable debt instrument by its Equibles identifier. Returns current balances, linked filing observation, verified covenant bullets, exact source quotes, and governing or amending SEC documents. History, covenants, and documents are independently paged. Use GetDebtProfile first to obtain the instrument identifier.
Parameters10
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT).
instrumentId
string
required
Debt instrument identifier returned by GetDebtProfile.
maxHistory
integer
optional
Maximum filing-history rows to return (default 10, max 10).
historyOffset
integer
optional
Zero-based filing-history offset for paging.
maxCovenants
integer
optional
Maximum covenant rows to return (default 10, max 10).
covenantOffset
integer
optional
Zero-based covenant offset for paging.
maxDocuments
integer
optional
Maximum governing/update documents to return (default 10, max 10).
documentOffset
integer
optional
Zero-based document offset for paging.
maxEvidenceCharacters
integer
optional
Maximum exact-evidence characters to return for these history and covenant pages (default 0, max 12000). Use a positive value to read evidence losslessly in character pages.
evidenceOffset
integer
optional
Zero-based character offset into the exact evidence for these history and covenant pages.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT).",
"type": "string"
},
"instrumentId": {
"description": "Debt instrument identifier returned by GetDebtProfile.",
"type": "string",
"format": "uuid"
},
"maxHistory": {
"description": "Maximum filing-history rows to return (default 10, max 10).",
"type": "integer",
"default": 10
},
"historyOffset": {
"description": "Zero-based filing-history offset for paging.",
"type": "integer",
"default": 0
},
"maxCovenants": {
"description": "Maximum covenant rows to return (default 10, max 10).",
"type": "integer",
"default": 10
},
"covenantOffset": {
"description": "Zero-based covenant offset for paging.",
"type": "integer",
"default": 0
},
"maxDocuments": {
"description": "Maximum governing/update documents to return (default 10, max 10).",
"type": "integer",
"default": 10
},
"documentOffset": {
"description": "Zero-based document offset for paging.",
"type": "integer",
"default": 0
},
"maxEvidenceCharacters": {
"description": "Maximum exact-evidence characters to return for these history and covenant pages (default 0, max 12000). Use a positive value to read evidence losslessly in character pages.",
"type": "integer",
"default": 0
},
"evidenceOffset": {
"description": "Zero-based character offset into the exact evidence for these history and covenant pages.",
"type": "integer",
"default": 0
}
},
"required": [
"ticker",
"instrumentId"
]
}
GetFailsToDeliver
Get fails-to-deliver (FTD) data for an exact listed stock or exchange-traded fund from the SEC's twice-monthly FTD files. Quantity is the aggregate net fail-to-deliver position OUTSTANDING on each settlement date — a balance, not that day's new fails, so never sum Quantity across dates. Price is the previous trading day's closing price (SEC file convention, not a settlement price) and Value = Quantity × Price. Within the covered window (the output names the earliest fully covered settlement date), dates absent from the table had no reported fails; earlier dates are only partially covered, so their absence is not evidence of no fails. The SEC publishes each half-month batch with roughly a two-week lag, so the newest rows trail today. High or persistent FTD balances may indicate naked short selling or settlement issues.
Parameters4
ticker
string
required
Exact stock or ETF ticker symbol (e.g., AAPL, GME, SPY)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 3 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of records to return — keeps the most recent N settlement dates in the range, displayed oldest to newest (default: 90, max: 500)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Exact stock or ETF ticker symbol (e.g., AAPL, GME, SPY)",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 3 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of records to return — keeps the most recent N settlement dates in the range, displayed oldest to newest (default: 90, max: 500)",
"type": "integer",
"default": 90
}
},
"required": [
"ticker"
]
}
GetTopGovernmentContractors
Rank public companies by total federal contract dollars awarded over a date range (from USAspending.gov). Sums the total award value (obligated dollars plus unexercised ceiling) of prime contract awards of $1M or more that resolve to a listed company; smaller awards and unlisted recipients are excluded. Answers questions like 'which public companies won the most federal contracts last quarter'. Use GetGovernmentContracts for one company's individual awards.
Parameters3
startDate
string
optional
Start date in YYYY-MM-DD format, filtering on the award action date (defaults to 1 year ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to today)
maxResults
integer
optional
Maximum number of companies to return (default: 25, largest first)
Raw schema
{
"type": "object",
"properties": {
"startDate": {
"description": "Start date in YYYY-MM-DD format, filtering on the award action date (defaults to 1 year ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to today)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of companies to return (default: 25, largest first)",
"type": "integer",
"default": 25
}
}
}
GetIpoDetails
Get one S-1/F-1 registration's full picture by the filer's SEC CIK (as listed by GetIpoFeed): lifecycle status, verified offering classification, effective-prospectus accession and EDGAR link, proposed ticker and exchange, the offer price range and shares offered with their verbatim prospectus quotes, what the company does, how it will use the proceeds, the underwriting banks in cover order, the key summary risk factors (each with its verbatim prospectus sentence), the annual pre-IPO financials from the filer's own XBRL-tagged statements, and the complete S-1/amendment/prospectus filing chain with EDGAR links. Underwriter and risk-factor availability distinguishes pending/rejected extraction from a completed read that stated none. Everything extracted is verified against the filing text and never estimated.
Parameters1
cik
string
required
The filer's SEC CIK, with or without leading zeros (e.g. 1995137).
Raw schema
{
"type": "object",
"properties": {
"cik": {
"description": "The filer's SEC CIK, with or without leading zeros (e.g. 1995137).",
"type": "string"
}
},
"required": [
"cik"
]
}
GetGuidance
Get company guidance from written Item 2.02 earnings releases and earnings-call transcripts, newest release first, with range, unit, GAAP basis, fiscal period and source provenance. Closed target periods are marked ended. Revenue and diluted-EPS guidance includes the reported actual and verdict once comparable XBRL facts exist; non-GAAP guidance is never compared with GAAP actuals. Coverage notes distinguish unprocessed documents from sources that state no guidance.
Get recent proposed insider sales for a stock from SEC Form 144 notices. Each Form 144 is an affiliate's declaration of intent to sell restricted or control securities, showing the seller, their relationship to the company, the number of shares and aggregate market value to be sold, the proposed sale as a share of the issuer's current shares outstanding, the approximate sale date, the broker, and the filer's remarks (including any stated 10b5-1 plan). Results are the most recent notices first and a note flags when more exist than were returned; use fromDate/toDate to scope a period (heavy 10b5-1 filers can flood the recency window with small daily notices). A proposal may never execute; a completed sale may later appear on Form 4 or 5 only when it is reportable there.
Parameters5
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
maxResults
integer
optional
Maximum number of notices to return (default: 50, max: 500; values outside 1-500 are clamped)
fromDate
string
optional
Optional earliest filing date to include, ISO format yyyy-MM-dd (e.g., 2025-01-01)
toDate
string
optional
Optional latest filing date to include, ISO format yyyy-MM-dd (e.g., 2025-12-31)
offset
integer
optional
Number of matching notices to skip before returning rows (default: 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"maxResults": {
"description": "Maximum number of notices to return (default: 50, max: 500; values outside 1-500 are clamped)",
"type": "integer",
"default": 50
},
"fromDate": {
"description": "Optional earliest filing date to include, ISO format yyyy-MM-dd (e.g., 2025-01-01)",
"type": "string",
"default": null
},
"toDate": {
"description": "Optional latest filing date to include, ISO format yyyy-MM-dd (e.g., 2025-12-31)",
"type": "string",
"default": null
},
"offset": {
"description": "Number of matching notices to skip before returning rows (default: 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetInvestorEventSlideMetadata
Get metadata and access links for a captured investor-event slide deck by event id. Returns the same deck metadata as REST: event and ticker, call date, deck title and source, PDF versus image-slideshow kind, page count, capture time, MIME type, and either the PDF API path or ordered slide-image API paths. The binary PDF/image contents are not embedded in the response. Get the event id from ListInvestorEvents or GetEarningsCallEvent.
Parameters1
eventId
string
required
The investor event id (from ListInvestorEvents or GetEarningsCallEvent)
Raw schema
{
"type": "object",
"properties": {
"eventId": {
"description": "The investor event id (from ListInvestorEvents or GetEarningsCallEvent)",
"type": "string",
"format": "uuid"
}
},
"required": [
"eventId"
]
}
GetInsiderOwnership
Get a summary of insider ownership for a stock, ranked by total shares held. Shares come from each insider's most recent SEC Form 3/4/5 filing: the filing's closing balance per security and ownership bucket (actual shares only — options and other derivative holdings are excluded), summed into Direct and Indirect columns and restated onto today's split basis, so they can differ from the raw figures in older filings. Indirect can understate an insider holding through several vehicles, because a filing reports one balance per vehicle and only the last is kept. Former insiders may linger with stale dates or zero shares. Returns at most maxResults insiders (default 30). Use this to understand the insider ownership structure of a company; use GetInsiderTransactions for the underlying trades.
Parameters3
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
maxResults
integer
optional
Maximum number of insiders to return (default: 30, max: 500; values outside 1-500 are clamped)
offset
integer
optional
Number of ranked insiders to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"maxResults": {
"description": "Maximum number of insiders to return (default: 30, max: 500; values outside 1-500 are clamped)",
"type": "integer",
"default": 30
},
"offset": {
"description": "Number of ranked insiders to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetNonGaapBridge
Get a company's non-GAAP-to-GAAP reconciliations ('bridges') as extracted from its earnings releases and 10-K/10-Q periodic reports: for each stated non-GAAP measure (Adjusted EBITDA, adjusted EPS, adjusted operating income, FFO/AFFO, ...), the GAAP starting line, each stated adjustment in order, and the non-GAAP result, with the period, unit and the verbatim source quote. Verifier-approved, newest filing first. Use this to see exactly how a company builds its adjusted numbers; GetCompanyKpis carries the same bridge inline with a metric, this returns the reconciliations on their own.
Parameters3
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
limit
integer
optional
Maximum number of source filings to read, newest first (default 6, valid 1-20; out-of-range values are clamped)
offset
integer
optional
Number of approved source filings to skip before returning rows (default 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"limit": {
"description": "Maximum number of source filings to read, newest first (default 6, valid 1-20; out-of-range values are clamped)",
"type": "integer",
"default": 6
},
"offset": {
"description": "Number of approved source filings to skip before returning rows (default 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
CompareFinancialFact
Compare one financial concept across several companies for the same fiscal period — peer comparison. Returns one row per ticker with the latest-restated value; tickers with no data for the period are listed separately. Fiscal year/period follow each company's OWN fiscal calendar (e.g. NVDA's fiscal 2025 ended January 2025), so peer rows can cover very different calendar months — check the Period End column.
Parameters4
tickers
array
required
Ticker symbols to compare (max 25).
concept
string
required
Concept alias, e.g. 'revenue', 'net-income', 'eps-diluted'. Call with an unknown value to list supported aliases.
fiscalYear
integer
required
Fiscal year, e.g. 2023
fiscalPeriod
string
optional
Fiscal period: 'FY' (default) or 'Q1'..'Q4'
Raw schema
{
"type": "object",
"properties": {
"tickers": {
"description": "Ticker symbols to compare (max 25).",
"type": "array",
"items": {
"type": "string"
}
},
"concept": {
"description": "Concept alias, e.g. 'revenue', 'net-income', 'eps-diluted'. Call with an unknown value to list supported aliases.",
"type": "string"
},
"fiscalYear": {
"description": "Fiscal year, e.g. 2023",
"type": "integer"
},
"fiscalPeriod": {
"description": "Fiscal period: 'FY' (default) or 'Q1'..'Q4'",
"type": "string",
"default": "FY"
}
},
"required": [
"tickers",
"concept",
"fiscalYear"
]
}
GetOptionContract
Get the full snapshot for ONE option contract by its OCC symbol (e.g. O:AAPL260724C00110000): greeks, implied volatility, open interest, the latest daily price, and bid/ask when the plan entitles quotes. Last, day range and volume name the provider's trading-session timestamp when supplied and otherwise mark it unknown; open interest names its separate effective date when supplied; implied volatility and greeks are the provider's model values computed at fetch time and can differ slightly from a chain response. Bid/ask use consolidated real-time OPRA on Pro and a 15-minute delayed indicative feed on Plus; the Free plan covers end-of-day data only and is answered with an upgrade note.
Get scheduled FDA advisory-committee (AdComm) meetings, sourced from the FDA.gov advisory-committee calendar, each with a link to its FDA meeting page. Defaults to meetings in the next 90 days; pass a date range to look further ahead. This is a forward-looking calendar of announced meetings, not a historical archive — coverage starts in late 2025 — and entries are the FDA's own listings, not linked to stock tickers.
Parameters3
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to today)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to 90 days after the start)
maxResults
integer
optional
Maximum number of meetings to return (default: 60, soonest first)
Raw schema
{
"type": "object",
"properties": {
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to today)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to 90 days after the start)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of meetings to return (default: 60, soonest first)",
"type": "integer",
"default": 60
}
}
}
GetStochasticOscillator
Stochastic Oscillator (%K and %D) for a stock. %K measures the close relative to the high/low range over the lookback window; %D is the smoothed signal line (simple moving average of %K). Useful for spotting overbought (>80) and oversold (<20) conditions. The lookback window is warmed up on price history fetched before startDate, so values do not depend on the requested range's left edge.
Parameters6
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 6 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
kPeriod
integer
optional
Lookback window for %K (default: 14)
dPeriod
integer
optional
Smoothing window for %D (default: 3)
maxResults
integer
optional
Maximum number of records to return (default: 60, max: 500); the newest rows are kept and listed newest first.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 6 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"kPeriod": {
"description": "Lookback window for %K (default: 14)",
"type": "integer",
"default": 14
},
"dPeriod": {
"description": "Smoothing window for %D (default: 3)",
"type": "integer",
"default": 3
},
"maxResults": {
"description": "Maximum number of records to return (default: 60, max: 500); the newest rows are kept and listed newest first.",
"type": "integer",
"default": 60
}
},
"required": [
"ticker"
]
}
RemovePortfolioLot
Permanently delete a lot from the USER's portfolio, as if it had never been recorded. This is for a lot entered by mistake. It is NOT how a sale is recorded: deleting a lot that was sold destroys its realized profit; use ClosePortfolioLot for that. This cannot be undone, so confirm with the user first, naming the lot.
Parameters2
portfolio
string
required
The portfolio holding the lot, by name.
lotId
string
required
The lot id shown by GetMyPortfolio, e.g. a1b2c3d4.
Raw schema
{
"type": "object",
"properties": {
"portfolio": {
"description": "The portfolio holding the lot, by name.",
"type": "string"
},
"lotId": {
"description": "The lot id shown by GetMyPortfolio, e.g. a1b2c3d4.",
"type": "string"
}
},
"required": [
"portfolio",
"lotId"
]
}
GetDebtProfile
Get a company's source-linked reported debt balances, total debt history, and identified notes, loans, and revolving credit facilities. The latest annual report establishes the baseline; subsequent interim reports and event disclosures update durable instrument records instead of creating a new instrument from a similar-looking row. Results summarize each instrument and provide its ID; use GetDebtInstrument for paged covenants, filing observations, exact evidence, and governing SEC exhibits. Unmatched observations are disclosed and excluded.
Parameters7
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT).
maxResults
integer
optional
Maximum instruments to return (default 25, max 25).
offset
integer
optional
Zero-based instrument offset for paging (default 0, max 100000).
maxReportedTotals
integer
optional
Maximum company-reported totals to return (default 10, max 10).
reportedTotalOffset
integer
optional
Zero-based company-reported-total offset for paging.
maxEvidenceCharacters
integer
optional
Maximum exact-evidence characters to return for the selected company-reported totals (default 0, max 12000). Use a positive value to read evidence losslessly in character pages.
evidenceOffset
integer
optional
Zero-based character offset into the selected company-reported totals' exact evidence.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT).",
"type": "string"
},
"maxResults": {
"description": "Maximum instruments to return (default 25, max 25).",
"type": "integer",
"default": 25
},
"offset": {
"description": "Zero-based instrument offset for paging (default 0, max 100000).",
"type": "integer",
"default": 0
},
"maxReportedTotals": {
"description": "Maximum company-reported totals to return (default 10, max 10).",
"type": "integer",
"default": 10
},
"reportedTotalOffset": {
"description": "Zero-based company-reported-total offset for paging.",
"type": "integer",
"default": 0
},
"maxEvidenceCharacters": {
"description": "Maximum exact-evidence characters to return for the selected company-reported totals (default 0, max 12000). Use a positive value to read evidence losslessly in character pages.",
"type": "integer",
"default": 0
},
"evidenceOffset": {
"description": "Zero-based character offset into the selected company-reported totals' exact evidence.",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetMemberNetWorth
Get a congress member's net worth history from their annual financial disclosures. Disclosed values are ranges, so every year is a band (minimum-maximum), never a point estimate. Only electronically filed reports are read: a missing year means no electronic filing, not zero net worth. Use SearchCongressMembers to find member names.
Parameters2
memberName
string
required
Congress member name, case-insensitive (e.g., 'Nancy Pelosi', 'Marsha Blackburn'); use SearchCongressMembers to find the exact name
maxResults
integer
optional
Maximum number of years to return (default: 20, max: 500, newest first)
Raw schema
{
"type": "object",
"properties": {
"memberName": {
"description": "Congress member name, case-insensitive (e.g., 'Nancy Pelosi', 'Marsha Blackburn'); use SearchCongressMembers to find the exact name",
"type": "string"
},
"maxResults": {
"description": "Maximum number of years to return (default: 20, max: 500, newest first)",
"type": "integer",
"default": 20
}
},
"required": [
"memberName"
]
}
GetFundNcenReports
Get operational data for a registered investment company from its SEC Form N-CEN annual reports. Accepts an exchange-listed ticker or an exact fund identifier from SearchFunds, including a profile id, SEC series id, stored series ticker, or verified share-class alias. Each N-CEN shows the registrant's classification, Investment Company Act file number, reporting period, first/last-filing flags, latest service providers, and an exact filed-name provider history. N-CEN is filed at registrant level; this dataset currently ingests it through tracked issuer feeds, so a series inside an untracked multi-series trust can resolve correctly but still have no N-CEN report on record. Only registered funds file N-CEN; operating companies return no data.
Parameters2
fund
string
required
Fund or ETF ticker, profile id, SEC series id, or verified share-class alias (e.g., MXF, IVV, S000004344, VOO)
maxResults
integer
optional
Maximum number of annual reports to return (default: 10, max: 500)
Raw schema
{
"type": "object",
"properties": {
"fund": {
"description": "Fund or ETF ticker, profile id, SEC series id, or verified share-class alias (e.g., MXF, IVV, S000004344, VOO)",
"type": "string"
},
"maxResults": {
"description": "Maximum number of annual reports to return (default: 10, max: 500)",
"type": "integer",
"default": 10
}
},
"required": [
"fund"
]
}
GetInsiderTransactions
Get recent insider trading transactions for a stock from SEC Forms 4 and 5, newest first. Form 3 supplies initial ownership rather than a transaction. The Type column carries the SEC transaction code meaning: 'Buy'/'Sell' are open-market purchases/sales only, while Award, Conversion, Exercise, Tax Payment, Expiration, Gift, Inheritance, Discretionary and Other are compensation or derivative mechanics — not conviction trades. The 10b5-1 column marks trades made under a pre-arranged Rule 10b5-1 plan ('-' = filing predates the 2023 checkbox). Per-row Shares/Price/Value are as filed; Owned After is the post-transaction balance restated onto today's split basis, tracked per security kind and ownership form. Supports optional date-range, transaction-type and insider-name filters to reach history beyond the newest rows. Use this to understand insider buying/selling activity.
Parameters7
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
maxResults
integer
optional
Maximum number of transactions to return (default: 50, max: 500; values outside 1-500 are clamped)
fromDate
string
optional
Only include transactions on or after this date, format yyyy-MM-dd (optional)
toDate
string
optional
Only include transactions on or before this date, format yyyy-MM-dd (optional)
transactionType
string
optional
Only include one transaction type: Buy, Sell, Award, Conversion, Exercise, TaxPayment, Expiration, Gift, Inheritance, Discretionary or Other (optional)
insiderName
string
optional
Only include transactions by insiders whose SEC-filed name contains every word of this value, case-insensitive (e.g. 'Huang') (optional)
offset
integer
optional
Number of matching transactions to skip before returning rows (default: 0)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"maxResults": {
"description": "Maximum number of transactions to return (default: 50, max: 500; values outside 1-500 are clamped)",
"type": "integer",
"default": 50
},
"fromDate": {
"description": "Only include transactions on or after this date, format yyyy-MM-dd (optional)",
"type": "string",
"default": null
},
"toDate": {
"description": "Only include transactions on or before this date, format yyyy-MM-dd (optional)",
"type": "string",
"default": null
},
"transactionType": {
"description": "Only include one transaction type: Buy, Sell, Award, Conversion, Exercise, TaxPayment, Expiration, Gift, Inheritance, Discretionary or Other (optional)",
"type": "string",
"default": null
},
"insiderName": {
"description": "Only include transactions by insiders whose SEC-filed name contains every word of this value, case-insensitive (e.g. 'Huang') (optional)",
"type": "string",
"default": null
},
"offset": {
"description": "Number of matching transactions to skip before returning rows (default: 0)",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetCompanyKpis
Get company-stated operational and non-GAAP KPIs extracted from written 8-K earnings releases and 10-K/10-Q MD&A, with period, filing date, source quote and exactly comparable year-over-year change. Omit metric for each series' latest reading; pass a company metric label for its full history. Values retain the company's stated scale. Earnings-call transcripts are not figure sources. A disclosed GAAP-to-non-GAAP reconciliation includes its stated bridge.
Parameters2
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT).
metric
string
optional
Optional metric name to expand into its full history (e.g., 'subscribers', 'Adjusted EBITDA'). Matches the company's own metric labels case-insensitively; when the name matches several metrics the tool lists those candidates. Omit for the overview of every metric's latest reading.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT).",
"type": "string"
},
"metric": {
"description": "Optional metric name to expand into its full history (e.g., 'subscribers', 'Adjusted EBITDA'). Matches the company's own metric labels case-insensitively; when the name matches several metrics the tool lists those candidates. Omit for the overview of every metric's latest reading.",
"type": "string",
"default": null
}
},
"required": [
"ticker"
]
}
SearchInvestmentAdvisers
Search the tracked SEC Form ADV adviser set by firm name. Search first requires every punctuation-independent query word anywhere in the legal or business name, then broadens to any word only when no strict row matches. Returns CRD, main office, regulatory assets under management, employee count and as-of date, largest by assets first. Use the CRD with GetInvestmentAdviser.
Parameters2
query
string
required
Part of the firm's legal or business name (e.g., "Vanguard", "Renaissance")
maxResults
integer
optional
Maximum number of advisers to return (default: 20, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Part of the firm's legal or business name (e.g., \"Vanguard\", \"Renaissance\")",
"type": "string"
},
"maxResults": {
"description": "Maximum number of advisers to return (default: 20, clamped to 1-500)",
"type": "integer",
"default": 20
}
},
"required": [
"query"
]
}
GetMarketHolidayCalendar
List the US equity market holidays and early-close (1:00 p.m. ET) half days for a calendar year (NYSE/Nasdaq). Defaults to the current year. The calendar is curated for 2025 through 2027; a year outside that range reports so rather than guessing.
Parameters1
year
integer | null
optional
Calendar year, e.g. 2026. Defaults to the current year.
Raw schema
{
"type": "object",
"properties": {
"year": {
"description": "Calendar year, e.g. 2026. Defaults to the current year.",
"type": [
"integer",
"null"
],
"default": null
}
}
}
GetOptionChain
Get the option chain (calls and puts) for a stock for ONE expiration: strike, greeks (delta/gamma/theta/vega), implied volatility, open interest, and the latest daily price. Defaults to the nearest upcoming expiration; pass expiration=YYYY-MM-DD to pick another (use GetOptionExpirations to list them). When the chain is larger than maxResults the contracts nearest the money are returned, so an unfiltered call already lands where strategies trade. Narrow with minStrike/maxStrike and type (call/put) to reach the wings. Each row attributes its last price, day range and volume to its provider-stamped session and attributes open interest to its separate effective date, or marks either date unknown; implied volatility and greeks are the provider's model values computed at fetch time, so repeated calls can return different values. The daily figures are not live quotes. Bid/ask use real-time OPRA on Pro and a 15-minute delayed indicative feed on Plus; Free covers end-of-day data only.
Parameters6
ticker
string
required
Stock ticker, e.g. AAPL
expiration
string
optional
Expiration date in YYYY-MM-DD format (default: nearest upcoming)
minStrike
number | null
optional
Only include strikes at or above this price
maxStrike
number | null
optional
Only include strikes at or below this price
type
string
optional
Contract type: call or put (default: both)
maxResults
integer
optional
Maximum contracts to return (default: 60, max: 500)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker, e.g. AAPL",
"type": "string"
},
"expiration": {
"description": "Expiration date in YYYY-MM-DD format (default: nearest upcoming)",
"type": "string",
"default": null
},
"minStrike": {
"description": "Only include strikes at or above this price",
"type": [
"number",
"null"
],
"default": null
},
"maxStrike": {
"description": "Only include strikes at or below this price",
"type": [
"number",
"null"
],
"default": null
},
"type": {
"description": "Contract type: call or put (default: both)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum contracts to return (default: 60, max: 500)",
"type": "integer",
"default": 60
}
},
"required": [
"ticker"
]
}
GetCustomerConcentration
Get a company's customer-concentration risk disclosure — statements like "one customer accounted for 31% of revenue": each disclosed figure's basis (revenue or receivables), customer count, percentage, and period, with the source filing. Untagged disclosures come from verified narrative extraction with a verbatim quote; issuers that tag ConcentrationRiskPercentage in structured XBRL (e.g. NVDA, AAPL) return those customer-specific dimensioned facts directly. A miss is never a statement of no risk. Pass maxFilings > 1 to also see earlier filings' disclosures (the concentration trend).
Parameters2
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT).
maxFilings
integer
optional
How many of the newest disclosing filings to return (default 1 — the latest; cap 10).
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT).",
"type": "string"
},
"maxFilings": {
"description": "How many of the newest disclosing filings to return (default 1 — the latest; cap 10).",
"type": "integer",
"default": 1
}
},
"required": [
"ticker"
]
}
GetAtmPrograms
Get a company's at-the-market (ATM) equity offering programs — original agreement date and stated precision, latest amendment, money and/or share capacity, cumulative sales, remaining availability with per-figure as-of dates, expiry, derived exhausted/expired status, and source filings. Bare table figures are normalized only from an exact grounded filing scale header. ATM programs have no tagged XBRL equivalent, so figures come from verified extractions of the company's own 10-K, 10-Q and 8-K filings; only filings from roughly the last 13 months are scanned, so an empty result means no program was captured there — not proof the company runs no ATM program. Nothing is estimated.
Get the portfolio summary header for an institutional 13F filer — published tracked 13F value (not total firm AUM), position count, top-10 / top-25 concentration, QoQ turnover, and the latest / prior report dates with the count of quarters tracked in this database. Values normally use report-date closing prices, may fall back to filer values, and can include zero for unavailable valuations. Resolve exact CIKs with SearchInstitutions; ambiguous partial names return candidates rather than selecting a filer silently.
Parameters2
institutionName
string
required
Institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format (defaults to the holder's latest; an off-quarter date snaps to the nearest report on or before it)
Raw schema
{
"type": "object",
"properties": {
"institutionName": {
"description": "Institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)",
"type": "string"
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format (defaults to the holder's latest; an off-quarter date snaps to the nearest report on or before it)",
"type": "string",
"default": null
}
},
"required": [
"institutionName"
]
}
GetGoingConcernStatus
Get a company's going-concern doubt status: whether its latest examined SEC filing states substantial doubt about the company's ability to continue as a going concern, with the verbatim disclosure, the filing it came from, and the history of examined filings showing when doubt appeared, was alleviated, or cleared. Flags are extracted from each company's newest 10-K/10-Q narrative text and verified before publication; a filing without going-concern language counts as no doubt. Coverage starts when the extraction lane first examined the company — earlier filings are not analyzed, so absence from the history does not rule out prior doubt episodes.
Get the exact listed securities, including ETFs, with the largest daily short sale volume for a single trading day (defaults to the latest available), from FINRA's daily short sale volume files, sorted by short volume descending. Short % is the share of that day's FINRA-facility (off-exchange/TRF) volume sold short — 40-50% is a normal market-making baseline — NOT short interest (the open short position; use GetShortInterest/GetShortInterestSnapshot for positions and GetShortSqueezeScores for operating-stock squeeze candidates; use GetShortVolume for one listed security's daily history). Pass sortBy=shortPercent with a minTotalVolume floor to rank by short intensity instead of raw size.
Parameters6
date
string
optional
Trading day in YYYY-MM-DD format (defaults to the latest available day)
minShortVolume
integer
optional
Minimum short volume filter (default: 0)
maxResults
integer
optional
Maximum number of results to return (default: 50, max: 500)
offset
integer
optional
Number of ranked results to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.
sortBy
string
optional
Sort key: shortVolume (default) or shortPercent — with shortPercent set a minTotalVolume floor, otherwise illiquid names dominate
minTotalVolume
integer
optional
Minimum total FINRA-reported volume filter, in shares (default: 0 = no floor)
Raw schema
{
"type": "object",
"properties": {
"date": {
"description": "Trading day in YYYY-MM-DD format (defaults to the latest available day)",
"type": "string",
"default": null
},
"minShortVolume": {
"description": "Minimum short volume filter (default: 0)",
"type": "integer",
"default": 0
},
"maxResults": {
"description": "Maximum number of results to return (default: 50, max: 500)",
"type": "integer",
"default": 50
},
"offset": {
"description": "Number of ranked results to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.",
"type": "integer",
"default": 0
},
"sortBy": {
"description": "Sort key: shortVolume (default) or shortPercent — with shortPercent set a minTotalVolume floor, otherwise illiquid names dominate",
"type": "string",
"default": "shortVolume"
},
"minTotalVolume": {
"description": "Minimum total FINRA-reported volume filter, in shares (default: 0 = no floor)",
"type": "integer",
"default": 0
}
}
}
GetFinancialFact
Get a single financial concept (e.g. revenue, net income, diluted EPS, total assets, operating cash flow) over time for a company, sourced from SEC Company Facts (structured XBRL). Returns a time series, one row per fiscal period, using the latest restated value unless asOriginallyReported is set. Each row carries its actual period start/end; fiscal years/quarters follow the company's own fiscal calendar. Warns when the selected alias ends materially before the company's other structured facts, which can indicate an XBRL tag change. Dimensioned disclosures such as customer concentration are outside this consolidated-series tool. For a full statement use GetFinancialStatement; to compare peers use CompareFinancialFact.
Parameters8
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT)
concept
string
required
Concept alias, e.g. 'revenue', 'net-income', 'eps-diluted', 'total-assets', 'operating-cash-flow'. Call with an unknown value to list supported aliases.
form
string
optional
Optional SEC form filter, e.g. '10-K' or '10-Q'
fromDate
string
optional
Optional earliest period-end date, YYYY-MM-DD
toDate
string
optional
Optional latest period-end date, YYYY-MM-DD
maxResults
integer
optional
Maximum periods to return, newest first (default 40, max 200)
asOriginallyReported
boolean
optional
When true, show the earliest canonical periodic filing instead of the latest restatement within that source priority. Default false.
fiscalPeriod
string
optional
Optional fiscal-period filter: 'FY' (annual only) or 'Q1'..'Q4'. Note that discrete Q4 rows exist only where the filer reported a discrete fourth quarter (most large filers stopped after ~2021).
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"concept": {
"description": "Concept alias, e.g. 'revenue', 'net-income', 'eps-diluted', 'total-assets', 'operating-cash-flow'. Call with an unknown value to list supported aliases.",
"type": "string"
},
"form": {
"description": "Optional SEC form filter, e.g. '10-K' or '10-Q'",
"type": "string",
"default": null
},
"fromDate": {
"description": "Optional earliest period-end date, YYYY-MM-DD",
"type": "string",
"default": null
},
"toDate": {
"description": "Optional latest period-end date, YYYY-MM-DD",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum periods to return, newest first (default 40, max 200)",
"type": "integer",
"default": 40
},
"asOriginallyReported": {
"description": "When true, show the earliest canonical periodic filing instead of the latest restatement within that source priority. Default false.",
"type": "boolean",
"default": false
},
"fiscalPeriod": {
"description": "Optional fiscal-period filter: 'FY' (annual only) or 'Q1'..'Q4'. Note that discrete Q4 rows exist only where the filer reported a discrete fourth quarter (most large filers stopped after ~2021).",
"type": "string",
"default": null
}
},
"required": [
"ticker",
"concept"
]
}
GetInstitutionSectorAllocation
Get an institution's 13F portfolio allocation for a given report quarter (defaults to the latest), grouped by fine-grained industry (default) or rolled up by sector via `groupBy`. Returns a markdown table sorted by % of portfolio descending, with stocks lacking a classification collapsed into a single 'Unclassified' row at the end. Published values normally use report-date closing prices, may fall back to filer values, and can be zero when unavailable. Use SearchInstitutions for an exact CIK; ambiguous partial names return candidates instead of selecting silently.
Parameters3
institutionName
string
required
Institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format (defaults to the holder's latest; an off-quarter date snaps to the nearest report on or before it)
groupBy
string
optional
Grouping level: 'industry' (default, fine-grained) or 'sector' (broad rollup)
Raw schema
{
"type": "object",
"properties": {
"institutionName": {
"description": "Institution name or CIK (a unique partial resolves; ambiguous partials return candidate CIKs)",
"type": "string"
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format (defaults to the holder's latest; an off-quarter date snaps to the nearest report on or before it)",
"type": "string",
"default": null
},
"groupBy": {
"description": "Grouping level: 'industry' (default, fine-grained) or 'sector' (broad rollup)",
"type": "string",
"default": "industry"
}
},
"required": [
"institutionName"
]
}
GetShortSqueezeScores
Rank primary operating-company stocks by a peer-relative 0-100 short-squeeze score using short interest, capped days to cover, price versus trailing VWAP, short-volume trend, short-interest change, fails-to-deliver pressure, and bounded price/volume/earnings catalyst boosts. Optional liquidity floors filter the board without changing scores. Pass ticker for one stock's factor breakdown and universe rank. Exchange-traded products are excluded because issuer shares outstanding and earnings are not product-level facts; use GetShortInterest for an ETF's exact FINRA series.
Parameters5
minMarketCap
number
optional
Minimum market capitalization in US dollars (e.g. 300000000 = $300M; default 0 = no floor). Stocks with an unknown market cap are excluded when set.
minDollarVolume
number
optional
Minimum average daily dollar volume in US dollars, approximated as the FINRA average daily share volume times the market-cap-implied share price (e.g. 5000000 = $5M/day; default 0 = no floor). Stocks with unknown volume or market cap are excluded when set.
maxResults
integer
optional
Maximum number of stocks to return (default: 25, highest score first; clamped to 1-200).
ticker
string
optional
Optional stock ticker (e.g. GME): returns that one stock's score, factor breakdown, and rank within the scored universe instead of the board. The liquidity floors do not apply to a single-ticker lookup.
offset
integer
optional
Number of ranked results to skip before returning rows (default: 0, clamped to 0-100000; ignored for a single-ticker lookup). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-200) are returned, or the response's total has been reached.
Raw schema
{
"type": "object",
"properties": {
"minMarketCap": {
"description": "Minimum market capitalization in US dollars (e.g. 300000000 = $300M; default 0 = no floor). Stocks with an unknown market cap are excluded when set.",
"type": "number",
"default": 0
},
"minDollarVolume": {
"description": "Minimum average daily dollar volume in US dollars, approximated as the FINRA average daily share volume times the market-cap-implied share price (e.g. 5000000 = $5M/day; default 0 = no floor). Stocks with unknown volume or market cap are excluded when set.",
"type": "number",
"default": 0
},
"maxResults": {
"description": "Maximum number of stocks to return (default: 25, highest score first; clamped to 1-200).",
"type": "integer",
"default": 25
},
"ticker": {
"description": "Optional stock ticker (e.g. GME): returns that one stock's score, factor breakdown, and rank within the scored universe instead of the board. The liquidity floors do not apply to a single-ticker lookup.",
"type": "string",
"default": null
},
"offset": {
"description": "Number of ranked results to skip before returning rows (default: 0, clamped to 0-100000; ignored for a single-ticker lookup). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-200) are returned, or the response's total has been reached.",
"type": "integer",
"default": 0
}
}
}
SearchCongressMembers
Search the tracked congressional roster by name. Search first requires every punctuation-independent query word anywhere in the filed name, then broadens to any word only when no strict row matches. Verified public-name aliases such as Dan Crenshaw resolve to the roster name. Returns each match with its position; pass the returned exact Name to GetMemberTrades or GetMemberNetWorth.
Parameters3
query
string
required
Search query — partial or full name (e.g., 'Pelosi', 'Cruz', 'Dan')
position
string
optional
Filter by position: Senator or Representative (defaults to both)
maxResults
integer
optional
Maximum number of results to return (default: 20, max: 500)
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Search query — partial or full name (e.g., 'Pelosi', 'Cruz', 'Dan')",
"type": "string"
},
"position": {
"description": "Filter by position: Senator or Representative (defaults to both)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of results to return (default: 20, max: 500)",
"type": "integer",
"default": 20
}
},
"required": [
"query"
]
}
GetShortVolume
Get daily short sale volume history for an exact stock or ETF listing from FINRA's short sale volume files. Shows short volume, short-exempt volume, total volume, and short volume percentage per trading day. Volumes cover trades reported to FINRA facilities (off-exchange/TRF) only — NOT consolidated tape volume — and a 40-50% Short % is the normal baseline from market-maker liquidity provision, so it must not be quoted as a share of the stock's total traded volume. This daily flow metric is distinct from bi-monthly short interest positions: use GetShortInterest for positions, GetLargestShortVolume for a market-wide single-day ranking, and GetShortSqueezeScores for squeeze candidates.
Parameters4
ticker
string
required
Listed security ticker (e.g., AAPL, VOO, GME)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 3 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of records to return — keeps the most recent N trading days in the range, displayed oldest to newest (default: 90, max: 500)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed security ticker (e.g., AAPL, VOO, GME)",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 3 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of records to return — keeps the most recent N trading days in the range, displayed oldest to newest (default: 90, max: 500)",
"type": "integer",
"default": 90
}
},
"required": [
"ticker"
]
}
GetMarketWide13FActivity
Get the market-wide 13F leaderboards for a given quarter — which stocks were most bought, most sold, most initiated, or most exited across all 13F filers vs the prior quarter. The `bucket` argument selects one of: top-buys (Δ shares > 0 ranked by Δ value desc), top-sells (Δ shares < 0 ranked by Δ value asc), new-positions (stocks ranked by count of filers initiating a position), sold-out-positions (stocks ranked by count of filers exiting). Δ Value is the change in published position value: values normally use report-date closing prices, may fall back to filer values, and can be zero when unavailable. It includes price movement on held shares, so use Δ Shares to read the position change itself. The output publishes the first complete 13F report quarter and refuses comparisons that cross that corpus boundary. Use this to answer 'what's the consensus 13F move this quarter?'
Parameters3
bucket
string
required
Bucket: top-buys, top-sells, new-positions, or sold-out-positions
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format, e.g. 2026-03-31 (defaults to the latest available 13F quarter; an off-quarter date snaps to the nearest report on or before it)
maxResults
integer
optional
Maximum number of stocks to return (default: 20, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"bucket": {
"description": "Bucket: top-buys, top-sells, new-positions, or sold-out-positions",
"type": "string"
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format, e.g. 2026-03-31 (defaults to the latest available 13F quarter; an off-quarter date snaps to the nearest report on or before it)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of stocks to return (default: 20, clamped to 1-500)",
"type": "integer",
"default": 20
}
},
"required": [
"bucket"
]
}
GetVixHistory
Get CBOE Volatility Index (VIX) historical daily OHLC data. VIX measures expected 30-day S&P 500 volatility. Below 15 = low volatility/complacency, above 30 = high fear/uncertainty. Data available from 1990 to present.
Parameters3
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 3 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of records to return (default: 60, max: 500). When the range holds more rows the newest are kept; rows are always listed oldest to newest.
Raw schema
{
"type": "object",
"properties": {
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 3 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of records to return (default: 60, max: 500). When the range holds more rows the newest are kept; rows are always listed oldest to newest.",
"type": "integer",
"default": 60
}
}
}
GetExecutiveCompensation
Get a company's named-executive compensation as disclosed in its DEF 14A proxy statements' Summary Compensation Table — salary, bonus, stock and option awards, non-equity incentive, other compensation, and the company-reported total per executive per fiscal year, newest year first. Figures are exactly as the company disclosed them; Total is the filer's own figure, never a recomputation. Coverage is limited to US DEF 14A filers (foreign private issuers file 20-F and are not covered) and is still back-filling: the output states the newest proxy on file next to the newest imported year, so stale coverage is visible.
Parameters2
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT).
maxYears
integer
optional
Optional cap on how many of the newest fiscal years to return (default 0 = all imported years).
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT).",
"type": "string"
},
"maxYears": {
"description": "Optional cap on how many of the newest fiscal years to return (default 0 = all imported years).",
"type": "integer",
"default": 0
}
},
"required": [
"ticker"
]
}
GetEconomicIndicator
Get time series data for a FRED economic indicator. Returns historical observations for indicators like FEDFUNDS (fed funds rate), CPIAUCSL (CPI inflation), UNRATE (unemployment), GDP, T10Y2Y (yield spread), VIXCLS (VIX), SP500, MORTGAGE30US, M2SL (money supply), and more. Covers the curated ~40-series set Equibles tracks, not the full FRED catalog — use SearchEconomicIndicators to find available series.
Parameters4
seriesId
string
required
FRED series ID or standard indicator name (e.g., FEDFUNDS, fed funds rate, core CPI, jobless claims)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 1 year before the end date)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
maxResults
integer
optional
Maximum number of observations to return (default: 100, max: 500). When the range holds more, the newest maxResults are kept; rows are always listed in ascending date order.
Raw schema
{
"type": "object",
"properties": {
"seriesId": {
"description": "FRED series ID or standard indicator name (e.g., FEDFUNDS, fed funds rate, core CPI, jobless claims)",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 1 year before the end date)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of observations to return (default: 100, max: 500). When the range holds more, the newest maxResults are kept; rows are always listed in ascending date order.",
"type": "integer",
"default": 100
}
},
"required": [
"seriesId"
]
}
GetInvestmentAdviser
Get the full Form ADV profile for a single SEC-registered investment adviser by its Organization CRD number: legal and business names, SEC file number, main office, website, regulatory assets under management (discretionary, non-discretionary and total), employee count, and how the firm is compensated (fee structure). Find CRD numbers with SearchInvestmentAdvisers.
Read numbered lines from one SEC filing or earnings-call transcript. Use line numbers returned by SearchDocument or request a known range. Returns at most 2,000 lines and identifies the next startLine when truncated.
Parameters3
documentId
string
required
Document ID obtained from ListFilings
startLine
integer
required
First line to read (1-based, inclusive)
endLine
integer
required
Last line to read (1-based, inclusive). At most 2,000 lines are returned per call; a longer range is truncated with a note on how to continue.
Raw schema
{
"type": "object",
"properties": {
"documentId": {
"description": "Document ID obtained from ListFilings",
"type": "string",
"format": "uuid"
},
"startLine": {
"description": "First line to read (1-based, inclusive)",
"type": "integer"
},
"endLine": {
"description": "Last line to read (1-based, inclusive). At most 2,000 lines are returned per call; a longer range is truncated with a note on how to continue.",
"type": "integer"
}
},
"required": [
"documentId",
"startLine",
"endLine"
]
}
GetEarningsBrief
Get the AI 'Earnings Brief' for a company's recent earnings calls — a verifier-approved TL;DR, bullish and bearish points, and verbatim pull-quotes, plus a deterministic narrative shift against the immediately older available approved brief. When available, it also shows company guidance issued at the call, how that range changed from management's prior update, and the reported quarter versus the operative company guidance that preceded it. This is company guidance, not analyst consensus; actual comparisons use filed GAAP XBRL facts, never estimates. The shift is derived from approved bullets and is not separately verifier-approved. Newest quarter first. Only calls with an approved brief appear, so quarters can be missing from the sequence.
Parameters4
ticker
string
required
Company ticker symbol (e.g., AAPL, MSFT)
limit
integer
optional
Maximum number of quarterly briefs to return, newest first (default 2, max 8; values outside 1-8 are clamped)
fiscalYear
integer | null
optional
Company fiscal year. Omit both period fields for newest briefs; year alone filters that fiscal year.
fiscalQuarter
integer | null
optional
Company fiscal quarter, 1-4. Quarter alone filters that quarter across fiscal years; both fields select an exact period.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Company ticker symbol (e.g., AAPL, MSFT)",
"type": "string"
},
"limit": {
"description": "Maximum number of quarterly briefs to return, newest first (default 2, max 8; values outside 1-8 are clamped)",
"type": "integer",
"default": 2
},
"fiscalYear": {
"description": "Company fiscal year. Omit both period fields for newest briefs; year alone filters that fiscal year.",
"type": [
"integer",
"null"
],
"default": null
},
"fiscalQuarter": {
"description": "Company fiscal quarter, 1-4. Quarter alone filters that quarter across fiscal years; both fields select an exact period.",
"type": [
"integer",
"null"
],
"default": null
}
},
"required": [
"ticker"
]
}
GetOptionExpirations
List the available option expiration dates for a stock, with the contract count at each. Use this to pick an expiration for GetOptionChain.
Bollinger Bands for a stock. A middle band (simple moving average of close) with upper and lower bands set a number of standard deviations above and below it. Bands widen when volatility rises and contract when it falls; price touching the upper/lower band is a common overbought/oversold cue. Includes %B ((close-lower)/(upper-lower)) and bandwidth ((upper-lower)/middle) columns. The moving-average window is warmed up on price history fetched before startDate, so values do not depend on the requested range's left edge.
Parameters6
ticker
string
required
Stock ticker symbol (e.g., AAPL, MSFT). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 6 months ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to latest available)
period
integer
optional
Moving-average window (default: 20)
stdDev
number
optional
Standard deviations for the upper/lower bands (default: 2)
maxResults
integer
optional
Maximum number of records to return (default: 60, max: 500); the newest rows are kept and listed newest first.
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Stock ticker symbol (e.g., AAPL, MSFT). Class shares use a dash (BRK-B); the dot form (BRK.B) is also accepted.",
"type": "string"
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 6 months ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to latest available)",
"type": "string",
"default": null
},
"period": {
"description": "Moving-average window (default: 20)",
"type": "integer",
"default": 20
},
"stdDev": {
"description": "Standard deviations for the upper/lower bands (default: 2)",
"type": "number",
"default": 2
},
"maxResults": {
"description": "Maximum number of records to return (default: 60, max: 500); the newest rows are kept and listed newest first.",
"type": "integer",
"default": 60
}
},
"required": [
"ticker"
]
}
GetTopInstitutionalBuyersSellers
Get the institutions that moved the needle the most on a stock this quarter — biggest absolute share additions (Top Buyers) and biggest absolute share reductions (Top Sellers) versus the previous 13F report date. Includes new positions (Δ = full position) and sold-out positions (Δ = −prior position); entries and exits require observed 13F filings in both compared quarters, so missing filings or a CIK migration cannot become a full-position buy or sale. While the newest quarter's filing window is open, results cover only the funds that have already filed (noted in the output). Returns a markdown table with two sections. Use this to surface the most actionable quarterly signal from 13F filings.
Parameters3
ticker
string
required
Listed security ticker (e.g., AAPL, VOO)
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format, e.g. 2026-03-31 (defaults to the latest available; an off-quarter date snaps to the nearest report on or before it)
maxResults
integer
optional
Maximum number of buyers and sellers to return per section (default: 10, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"ticker": {
"description": "Listed security ticker (e.g., AAPL, VOO)",
"type": "string"
},
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format, e.g. 2026-03-31 (defaults to the latest available; an off-quarter date snaps to the nearest report on or before it)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of buyers and sellers to return per section (default: 10, clamped to 1-500)",
"type": "integer",
"default": 10
}
},
"required": [
"ticker"
]
}
SearchEconomicIndicators
Search the curated set of ~40 US macro FRED series Equibles tracks (rates, inflation, employment, GDP, housing, market indicators) — not the full FRED catalog. Search first requires every punctuation-independent query word anywhere across the series ID, title, or category, then broadens to any word only when that strict search has no rows. Standard names such as fed funds rate, jobless claims, payrolls, yield curve, and core CPI are recognized. An empty query lists every tracked series. Results include seasonal adjustment, the latest observation date, and the UTC time Equibles last synced the series.
Parameters2
query
string
required
Search query — series ID, title keyword, or category name (e.g., 'inflation', 'unemployment', 'GDP', 'FEDFUNDS'). Empty lists all tracked series.
maxResults
integer
optional
Maximum number of results to return (default: 20, max: 500)
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Search query — series ID, title keyword, or category name (e.g., 'inflation', 'unemployment', 'GDP', 'FEDFUNDS'). Empty lists all tracked series.",
"type": "string"
},
"maxResults": {
"description": "Maximum number of results to return (default: 20, max: 500)",
"type": "integer",
"default": 20
}
},
"required": [
"query"
]
}
GetMostHeldStocks
Get the cross-sectional ranking of stocks by institutional 13F breadth for a quarter. Rank by filer count (default), quarter-over-quarter filer-count change, or total published position value. Values normally use report-date closing prices, may fall back to filer values, and can include zero for unavailable valuations. Includes Δ filers, total value, Δ value, and share of the 13F universe. The first complete report quarter is published; earlier rankings and boundary-quarter deltas are unavailable. Only currently-held stocks rank; sold-out names use GetMarketWide13FActivity. During the newest quarter's open filing window, non-filers carry prior-quarter positions (noted in output).
Parameters3
reportDate
string
optional
Quarter-end 13F report date in YYYY-MM-DD format, e.g. 2026-03-31 (defaults to the latest available 13F quarter; an off-quarter date snaps to the nearest report on or before it)
sort
string
optional
Sort by: 'filers' (default, # of 13F filers desc), 'filersDelta' (QoQ filer-count delta desc — warming names), 'filersDeltaAsc' (QoQ filer-count delta asc — cooling names), or 'value' (current total published position value desc)
maxResults
integer
optional
Maximum number of stocks to return (default: 25, clamped to 1-500)
Raw schema
{
"type": "object",
"properties": {
"reportDate": {
"description": "Quarter-end 13F report date in YYYY-MM-DD format, e.g. 2026-03-31 (defaults to the latest available 13F quarter; an off-quarter date snaps to the nearest report on or before it)",
"type": "string",
"default": null
},
"sort": {
"description": "Sort by: 'filers' (default, # of 13F filers desc), 'filersDelta' (QoQ filer-count delta desc — warming names), 'filersDeltaAsc' (QoQ filer-count delta asc — cooling names), or 'value' (current total published position value desc)",
"type": "string",
"default": "filers"
},
"maxResults": {
"description": "Maximum number of stocks to return (default: 25, clamped to 1-500)",
"type": "integer",
"default": 25
}
}
}
GetMemberTrades
Get a congress member's disclosed securities transactions (newest first, last year by default). Shows tickers, transaction and filing dates, disclosed amount ranges, and the filed Asset identifying the instrument (such as stock, option, or bond). Use SearchCongressMembers to find member names, and GetCongressionalTrades for all members' transactions in one ticker.
Parameters7
memberName
string
required
Congress member name, case-insensitive (e.g., 'Nancy Pelosi', 'Dan Crenshaw'); use SearchCongressMembers to find the exact name
transactionType
string
optional
Filter by transaction type: Purchase or Sale; the synonyms Buy/Sell are accepted (defaults to all)
startDate
string
optional
Start date in YYYY-MM-DD format (defaults to 1 year ago)
endDate
string
optional
End date in YYYY-MM-DD format (defaults to today)
maxResults
integer
optional
Maximum number of trades to return (default: 50, max: 500, newest first)
offset
integer
optional
Number of trades to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.
ticker
string
optional
Optional stock ticker to combine with the member filter (e.g., AAPL)
Raw schema
{
"type": "object",
"properties": {
"memberName": {
"description": "Congress member name, case-insensitive (e.g., 'Nancy Pelosi', 'Dan Crenshaw'); use SearchCongressMembers to find the exact name",
"type": "string"
},
"transactionType": {
"description": "Filter by transaction type: Purchase or Sale; the synonyms Buy/Sell are accepted (defaults to all)",
"type": "string",
"default": null
},
"startDate": {
"description": "Start date in YYYY-MM-DD format (defaults to 1 year ago)",
"type": "string",
"default": null
},
"endDate": {
"description": "End date in YYYY-MM-DD format (defaults to today)",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of trades to return (default: 50, max: 500, newest first)",
"type": "integer",
"default": 50
},
"offset": {
"description": "Number of trades to skip before returning rows (default: 0, clamped to 0-100000). For the next page, add the returned row count to the clamped current offset; if the next offset exceeds 100000, narrow the filters instead. Stop when fewer than the effective page size (maxResults clamped to 1-500) are returned, or the response's total has been reached.",
"type": "integer",
"default": 0
},
"ticker": {
"description": "Optional stock ticker to combine with the member filter (e.g., AAPL)",
"type": "string",
"default": null
}
},
"required": [
"memberName"
]
}
SearchDocuments
Search SEC filings and earnings-call transcripts with hybrid keyword and semantic retrieval. Omit ticker to search every company, or provide one ticker to search only that company. Returns excerpts with document IDs for SearchDocument or ReadDocumentLines. Use excludeTickers and maxResultsPerCompany only for market-wide discovery; use ListFilings to browse filings newest first without a text query.
Parameters9
query
string
required
Search query — plain keywords or a short natural-language phrase. When too few excerpts match every word, the search automatically broadens to match any of the words; concise, filing-phrased terms (e.g. 'Data Center revenue') still rank best.
ticker
string
optional
Optional company ticker. Omit to search across all companies.
maxResults
integer
optional
Maximum number of results to return (default: 5, max: 500)
documentTypes
array
optional
Optional document types. Accepts registered values such as TenK, TenQ, EightK, TwentyF, SixK, FortyF, or deployment-registered types such as EarningsCallTranscript. Display names such as 10-K are also accepted; an invalid value returns the full accepted list.
startDate
string | null
optional
Optional start date filter in YYYY-MM-DD format
endDate
string | null
optional
Optional end date filter in YYYY-MM-DD format
excludeTickers
array
optional
Optional tickers to exclude from a market-wide search (max 25). Cannot be combined with ticker.
maxResultsPerCompany
integer
optional
Maximum results from any single company (default: 0 = unlimited). Set a small value (e.g. 2) to spread results across more companies for discovery-style queries.
maxExcerptChars
integer
optional
Maximum characters per excerpt (default: 0 = full excerpt). Set a small value (e.g. 400) for a compact scan across many results; truncated excerpts end with an explicit note.
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Search query — plain keywords or a short natural-language phrase. When too few excerpts match every word, the search automatically broadens to match any of the words; concise, filing-phrased terms (e.g. 'Data Center revenue') still rank best.",
"type": "string"
},
"ticker": {
"description": "Optional company ticker. Omit to search across all companies.",
"type": "string",
"default": null
},
"maxResults": {
"description": "Maximum number of results to return (default: 5, max: 500)",
"type": "integer",
"default": 5
},
"documentTypes": {
"description": "Optional document types. Accepts registered values such as TenK, TenQ, EightK, TwentyF, SixK, FortyF, or deployment-registered types such as EarningsCallTranscript. Display names such as 10-K are also accepted; an invalid value returns the full accepted list.",
"type": "array",
"items": {
"type": "string"
},
"default": null
},
"startDate": {
"description": "Optional start date filter in YYYY-MM-DD format",
"type": [
"string",
"null"
],
"format": "date-time",
"default": null
},
"endDate": {
"description": "Optional end date filter in YYYY-MM-DD format",
"type": [
"string",
"null"
],
"format": "date-time",
"default": null
},
"excludeTickers": {
"description": "Optional tickers to exclude from a market-wide search (max 25). Cannot be combined with ticker.",
"type": "array",
"items": {
"type": "string"
},
"default": null
},
"maxResultsPerCompany": {
"description": "Maximum results from any single company (default: 0 = unlimited). Set a small value (e.g. 2) to spread results across more companies for discovery-style queries.",
"type": "integer",
"default": 0
},
"maxExcerptChars": {
"description": "Maximum characters per excerpt (default: 0 = full excerpt). Set a small value (e.g. 400) for a compact scan across many results; truncated excerpts end with an explicit note.",
"type": "integer",
"default": 0
}
},
"required": [
"query"
]
}
Equibles — Stock Market & Financial Data MCP Server
130 MCP tools for AI agents like Claude, ChatGPT and Cursor: SEC filings, fundamentals, 13F institutional holdings, insider and congressional trades, earnings call transcripts, options chains, live quotes, IPO filings, short interest, macro data, and your own portfolio. Free hosted tier, or self-host the open-source stack.
The Model Context Protocol (MCP) lets AI assistants call external data tools instead of guessing from training data. Equibles exposes US stock market and financial data as an MCP server: use it hosted at https://mcp.equibles.com/mcp (free API key, or OAuth with no key at all), or run it yourself from the open-source stack. Everything is parsed from the primary sources (SEC EDGAR, FINRA, FRED, CFTC, CBOE, USAspending, company IR sites), not from third-party estimates.
Connect your client with the URL https://mcp.equibles.com/mcp (see below).
ChatGPT and Claude (web and Desktop) can skip the key entirely and sign in over OAuth.
Connect your AI client
Plugin packages
This repository includes an Agent Plugins package for compatible clients such as Cursor (plugin.json and mcp.json), a Grok Build package (.grok-plugin/plugin.json and .mcp.json), a Codex plugin and marketplace (.codex-plugin/plugin.json, .agents/plugins/marketplace.json and .mcp.json), a Claude Code plugin and marketplace (.claude-plugin/plugin.json and .claude-plugin/marketplace.json), and a Gemini CLI extension (gemini-extension.json). The skills/ folder holds one research skill that any package loader which discovers skills picks up, including the Codex and Claude Code plugins and Agent Plugins clients. These files configure the hosted MCP endpoint; they do not contain the server implementation. Marketplace availability is separate from these installable packages.
The packages use client-managed OAuth through https://mcp.equibles.com/mcp?auth=oauth, except the Claude Code plugin, which uses https://mcp.equibles.com/mcp to match the Claude directory connector. For the other packages, the query parameter requests authentication during discovery, so the client prompts for sign-in before attempting a data query. Sign in to your Equibles account when prompted. In Gemini CLI, use /mcp auth equibles if needed. If your client does not support OAuth, use the API-key configuration below instead.
Install the Gemini CLI extension from this repository:
For a local checkout of this package, use gemini extensions link /absolute/path/to/stock-market-mcp-server. After reviewing the package, Grok Build users can run grok plugin install /absolute/path/to/stock-market-mcp-server --trust, then grok plugin enable equibles and start a new session.
Install the Codex plugin from this repository's marketplace:
The only MCP endpoints configured by these packages are https://mcp.equibles.com/mcp?auth=oauth and, in the Claude Code plugin, https://mcp.equibles.com/mcp. OAuth discovery and sign-in use https://equibles.com/. Queries and explicitly requested portfolio changes are sent to Equibles under the signed-in account. Keep the client's normal tool confirmations enabled: portfolio tools can create, change, or delete your saved holdings, and feedback tools send reports to Equibles. The packages contain no executable scripts, lifecycle hooks, embedded credentials, or telemetry code. Report security problems as described in SECURITY.md. Hosted usage is subject to account entitlements and the service terms.
Cline
Create an Equibles account and an API key using the Quickstart above. In Cline, open MCP Servers → Configure MCP Servers and merge this entry into the mcpServers object, replacing eq_your_api_key with your own key:
Keep the key in your local client configuration and never commit it. Save the configuration, confirm Equibles is connected, and ask Cline to call GetMarketStatus as a read-only connection check. If authentication fails, check the key or sign in through the client's OAuth flow. See the Cline MCP documentation for client setup.
Claude Desktop / Claude web (claude.ai)
Settings → Connectors → Add custom connector → URL https://mcp.equibles.com/mcp → sign in over OAuth (no key needed).
Key alternative: use the URL https://mcp.equibles.com/mcp?api_key=eq_your_api_key.
Claude Code
bash
claude mcp add --transport http equibles https://mcp.equibles.com/mcp
Then run /mcp and choose Authenticate to sign in over OAuth.
Or install the plugin, which adds the same server plus the research skill:
Use the HTTP transport with URL https://mcp.equibles.com/mcp, authenticating with an Authorization: Bearer eq_... header or a ?api_key=eq_... query parameter.
"Which hedge funds bought the most NVIDIA last quarter?"
"Summarize the risk factors in Tesla's latest 10-K."
"Show recent insider selling at Microsoft, and has any member of Congress traded it this year?"
"What did NVIDIA guide for next quarter, and what KPIs did it report?"
"Which stocks have the highest short-squeeze scores today?"
"Screen for profitable software stocks under a 20 P/E."
"What's the latest CPI and unemployment rate?"
Tools
130 tools, grouped by dataset. 120 read market data; the 10 marked ✏️ write to your own portfolios, watchlist or feedback.
Filings & documents
Tool
Description
SearchDocuments
Hybrid keyword and semantic search across the filing corpus.
SearchDocument
Runs search inside one document identified by the UUID returned from ListFilings.
ListFilings
Lists stored filings and transcripts newest first (by filing date, then EDGAR acceptance time) and paginated.
ReadDocumentLines
Reads a specific range of numbered lines from a document.
GetFormDOfferings
Lists a company's recent Regulation D private placements from its SEC Form D notices, newest first.
Fundamentals & valuation
Tool
Description
GetFinancialFact
A single XBRL financial concept (revenue, net income, diluted EPS, total assets, operating cash flow, and the like) returned as a time series drawn from SEC Company Facts: one row per fiscal period for flows such as revenue, and one row per as-of date for balances and share counts, so a cover-page share count and the balance-sheet count at the period end both appear.
CompareFinancialFact
Compares one financial concept across several companies for the same fiscal period, a peer table with one row per ticker, each showing the latest-restated value; tickers with no data for the period are listed separately.
GetFinancialStatement
A full income statement, balance sheet, or cash-flow statement for one fiscal year and period, from SEC Company Facts (XBRL).
GetRevenueBreakdown
Revenue disaggregated by business segment, geography, and product/service, built from the dimensional XBRL facts the issuer tags in its own filings.
GetCompanyKpis
The company's own key performance indicators, extracted from its written Item-2.02 8-K earnings releases and 10-K/10-Q MD&A.
GetNonGaapBridge
The GAAP-to-non-GAAP reconciliation "bridge" for each stated non-GAAP measure, such as Adjusted EBITDA, adjusted EPS or adjusted operating income, extracted from a company's earnings releases and 10-K/10-Q periodic reports: the GAAP starting line, each stated adjustment in order, and the non-GAAP result, with the period, unit and verbatim source quote, verifier-approved and newest filing first.
GetGuidance
Forward guidance ranges issued by management, extracted from Item-2.02 8-K earnings releases and earnings-call transcripts (some issuers, e.g.
GetValuationMultiples
Trailing-twelve-month EV/Revenue, EV/EBIT and P/E, each shown against a subject-excluded peer median, quartiles, and the actual peer sample for that ratio.
GetValuationMultiplesHistory
EV/Revenue, EV/EBIT, EV/EBITDA and P/E recomputed at each past quarter's filing date, one row per quarter, up to ~10 years.
GetCustomerConcentration
A company's disclosed customer-concentration risk, statements like "one customer accounted for 26% of revenue." The tool serves both authoritative filing shapes directly.
GetGoingConcernStatus
Whether the company's latest examined SEC filing states substantial doubt about its ability to continue as a going concern (with the verbatim disclosure, the source filing, and the history of examined filings showing when doubt appeared, was alleviated, or cleared.
Debt profiles
Tool
Description
GetDebtProfile
Returns the company's issuer-reported debt-total history and a current-state summary of each identified note, loan, and revolving credit facility.
GetDebtInstrument
Returns one durable instrument from the profile, including its current reported balance and as-of date, paged linked filing-observation history, currently operative verified covenant terms, and governing, amending, refinancing, or retirement documents.
Earnings calls & investor relations
Tool
Description
GetEarningsBrief
A verifier-approved qualitative read of a company's most recent earnings calls, newest quarter first.
GetEarningsCallToneAndThemes
The AI-scored read of a company's recent earnings calls, newest first.
GetEarningsCallThemeHistory
How a company's call themes move quarter over quarter.
GetTranscriptPhraseTrend
How often a word or phrase comes up on a company's last earnings calls, oldest call first.
GetEarningsCallEvent
The single event record that groups one fiscal quarter's earnings-call artefacts (audio, transcript, slide deck, and the 8-K earnings release) under one entry.
GetEarningsCallTranscript
The speaker-labelled transcript of a company's earnings call for a given fiscal quarter.
GetEarningsCallQuestions
The analyst questions asked in a call's Q&A, one entry per analyst turn at the microphone with any follow-ups, in the order they were asked.
GetInvestorEventSlideMetadata
Metadata and access links for a captured investor-event slide deck.
ListInvestorEvents
A company's recent investor events (earnings calls plus the other events it webcasts (conferences, investor/analyst days, shareholder meetings)) newest first.
GetInvestorEventTranscript
The speaker-labelled transcript of a specific investor event by its event id.
GetInvestorRelationsNews
Recent investor-relations press releases for a stock, scraped straight from the company's own IR website, headline, publish date, a one-line summary when the source provides one, and link, in reverse-chronological order.
GetUpcomingInvestorEvents
The forward investor-relations calendar for a stock (earnings webcasts, conference appearances, presentations and shareholder meetings scraped from the company's IR website, scheduled from now onward, soonest first (NVIDIA had none as of this capture, so the example below uses Microsoft).
GetShareholderVoteResults
A company's shareholder meeting vote results, read from the Item 5.07 section of its SEC 8-K filings, latest meeting first.
Analyst estimates
Tool
Description
GetAnalystEstimates
Reads stored analyst consensus forecasts for one company.
Institutional holdings (13F)
Tool
Description
GetTopHolders
Ranks the largest tracked institutional holding rows for a stock from the latest 13F filings.
GetInstitutionalOwnershipHistory
Shows how aggregate reported 13F exposure to a stock has trended across recent quarters, the number of filers, total reported quantity, aggregate published position value, and the like-for-like quarter-over-quarter change: only filers with an observed 13F in both quarters count, and each quarter lists the filers and shares it excluded (late or confidential filings, first filings, CIK changes whose books do not match), because a missing filing is not a trade.
GetHolderMix
Splits a stock's 13F holders by one dimension, quarter by quarter.
GetTopInstitutionalBuyersSellers
Surfaces the institutions that moved the needle most on a stock this quarter, two ranked tables, the biggest absolute share additions (Top Buyers) and the biggest absolute reductions (Top Sellers) versus the prior 13F report date.
GetInstitutionPortfolio
Lists a specific institution's largest reported 13F positions by published value, with each row's type, share count, value and percent of the tracked portfolio.
GetInstitutionSummary
Returns the header-level portfolio summary for a 13F filer, published tracked portfolio value, position count, top-10 and top-25 concentration, quarter-over-quarter turnover, and the latest/prior report dates with the number of quarters on file.
GetInstitutionStyleHistory
How a 13F filer's book behaves, quarter by quarter, measured from its filed common-share positions.
GetInstitutionSectorAllocation
Breaks an institution's latest 13F portfolio down by industry/sector, sorted by weight, with the position count, published dollar value, and percent of tracked portfolio for each sector.
GetInstitutionQuarterlyActivity
Diffs an institution's 13F against the immediately prior quarter and groups the changes into four buckets (Initiated, Increased, Reduced, and Exited) each sorted by absolute change in value.
SearchInstitutions
Searches the tracked 13F filer set by filed-name words or CIK prefix and includes verified brand aliases for current flagship filers.
GetMarketWide13FActivity
Returns a market-wide 13F leaderboard for one chosen bucket, ranking stocks across all filers by their aggregate move versus the prior quarter.
GetHolderTypeFlows
Market-wide money flows by kind of 13F filer for a closed quarter.
GetMostHeldStocks
Ranks stocks by institutional 13F breadth for a quarter, by default the number of filers reporting each name, or by quarter-over-quarter change in filer count (a warming/cooling heat map), or by total published position value.
GetSuperInvestors
Returns the curated super-investor directory, a hand-picked roster of well-known value investors and fund managers (Warren Buffett, Bill Ackman, Michael Burry, Seth Klarman and more), each with their 13F filer CIK, latest published tracked portfolio value, position count, quarter-over-quarter change, and report date.
ETFs
Tool
Description
SearchEtfs
Search active exchange-traded funds and products by ticker, fund name, or sponsor.
GetEtfProfile
Return an ETF-specific profile with exact-ticker settled price and total-return performance, 52-week range, average volume, SEC-reported assets, top-ten concentration, allocation, and ten largest holdings.
GetEtfHoldings
Return the ETF's stored portfolio from its latest Form NPORT-P report, ranked by value.
Funds & advisers
Tool
Description
SearchFunds
Searches the tracked directory of registered management investment companies and UIT ETFs that file SEC Form NPORT-P by fund-name, registrant, identifier, or ticker words in any order.
GetFundProfile
Returns a registered fund's profile and largest holdings from its most recent SEC Form NPORT-P.
GetFundNcenReports
Returns operational data for a registered investment company from its SEC Form N-CEN annual reports.
GetFundsHoldingStock
Returns the registered funds and ETFs holding a given stock or ETF listing, from SEC Form NPORT-P portfolio reports.
GetEuropeanFundHoldings
European investment funds reporting a position in one listing outside the US, written MIC:TICKER, matched by that security's ISIN.
CompareInstitutionPortfolios
Returns the 13F portfolio overlap between two institutional managers for their latest common report date, union and shared position counts, Jaccard similarity, a dollar-weighted overlap, and a side-by-side table of stocks with each manager's share count and percent of tracked portfolio.
GetInstitutionConsensusHoldings
Returns the consensus / combined portfolio of 2–25 institutional managers for their latest common report date.
GetInstitutionCloneBacktest
Backtests how cloning an institutional filer's reported 13F portfolio would have performed against a market benchmark over a trailing window.
SearchInvestmentAdvisers
Searches SEC-registered and exempt reporting investment advisers (Form ADV) by firm name.
GetInvestmentAdviser
Returns the full Form ADV profile for a single SEC-registered or exempt reporting investment adviser by its Organization CRD number.
Insider trading
Tool
Description
GetInsiderTransactions
Returns the most recent insider transactions for a stock, straight from SEC Forms 4 and 5.
GetInsiderOwnership
Returns a roster of a company's insiders (directors, officers, and 10% owners) each with their role, total shares held, and the type and date of their most recent transaction, ranked from the largest holder down.
GetForm144ProposedSales
Returns recent Form 144 notices for a stock, an affiliate's advance declaration of intent to sell restricted or control shares.
GetInsiderSentimentScores
Ranks the entire scored universe by a composite 0-100 insider-sentiment score over a trailing 90-day window, a peer-relative blend of three direction-aware factors (net distinct insiders buying, net shares bought as a percent of shares outstanding, and net insider buy value in dollars), built only from open-market Forms 4/5 purchases and sales.
SearchInsiders
Looks up tracked corporate insiders (directors, officers, and 10% owners) by whole name words, never arbitrary substrings.
GetEuropeanDirectorTransactions
Director and related-person (PDMR) transactions a European regulator published for one listing outside the US, written MIC:TICKER.
Congressional trading
Tool
Description
GetCongressionalTrades
Returns the disclosed congressional trades for one ticker, newest first.
GetMemberTrades
Returns one member of Congress's disclosed trades, newest first.
GetMemberNetWorth
Returns a member's net-worth history reconstructed from their annual financial-disclosure reports.
GetMarketWideCongressionalActivity
Aggregates congressional trading across every member and every ticker over a trailing window, "what did Congress buy (or sell) lately" without needing a ticker or a member name.
SearchCongressMembers
Searches the tracked congressional roster by punctuation-independent name words in any order.
Short selling
Tool
Description
GetShortVolume
FINRA's daily short-sale volume for one stock.
GetShortInterest
FINRA's bi-monthly short-interest report for one stock.
GetOffExchangeVolume
Weekly off-exchange trading volume for one stock from FINRA's OTC/ATS Transparency data.
GetFailsToDeliver
Returns SEC fails-to-deliver (FTD) records for a stock or ETF, listed oldest to newest.
GetShortInterestSnapshot
A market-wide leaderboard at the latest FINRA short-interest settlement date, ranked by days-to-cover (descending) so the most squeeze-prone names surface first.
GetLargestShortVolume
The listed securities, ETFs included, with the largest short-sale volume on a single trading day (the latest available by default), ranked by short volume descending, with ticker, short volume, short-exempt volume, total volume, and short percentage.
GetShortSqueezeScores
A market-wide leaderboard of the highest composite short-squeeze scores (0–100), ranked peer-relative across primary operating-company stocks with short interest at the latest settlement date.
GetEuropeanShortPositions
Net short positions disclosed to European regulators for one listing outside the US, written MIC:TICKER, matched by that security's ISIN or, for issuer-level sources such as Sweden's, the issuer's LEI.
Capital, executives & screening
Tool
Description
GetBuybackPrograms
A company's share-repurchase picture (tracked programs (authorized total, remaining, expiry), the latest authorization, and the repurchase history (cash spent, shares, average price) by fiscal year) from XBRL facts plus verified extractions of the filings' narrative.
GetAtmPrograms
At-the-market (ATM) equity programs: executed sales/distribution agreements under which a company sells new shares directly into the market.
GetExecutiveChanges
Executive and director appointments and departures, extracted from Item-5.02 8-K filings (each with the person, role text exactly as filed, a separate normalized role classification, the nature of the change, its effective date, the verbatim disclosure, and a link to the source 8-K.
GetExecutiveCompensation
Named-executive pay from the company's DEF 14A Summary Compensation Table, salary, bonus, stock and option awards, non-equity incentive, other, and the company-reported total, per fiscal year.
ScreenStocks
Screen US listings, or European, Chinese and Hong Kong listings with market, by combining range filters across datasets.
GetGovernmentContracts
Federal contract awards won by a company, from USAspending, each with the award date, the recipient as the government named it, awarding agency, award type, total value, period-of-performance end, award ID, and description.
GetTopGovernmentContractors
The companies that have won the most federal contract dollars over a window, ranked by total awarded, with the award count.
GetFdaAdvisoryCommitteeMeetings
Scheduled FDA advisory-committee meetings, soonest first, with the date, meeting title, FDA center, type, and a link to the per-meeting FDA page (the only place that names the product and sponsor under review).
Prices & technicals
Tool
Description
GetStockPrices
Daily OHLCV bars for one stock, one row per trading day with open, high, low, close and positive share volume, listed oldest to newest.
GetLatestClosingPrices
The most recent traded closing price, one-session change, share volume, and trailing 52-week range for up to 25 tickers in one call.
GetDividendHistory
Stored declared cash dividends for an exact stock or ETF listing, newest ex-dividend date first.
GetLiveQuote
GetLiveQuote checks the live service's current in-memory snapshot first.
GetBollingerBands
Bollinger Bands for one stock.
GetStochasticOscillator
The stochastic oscillator for one stock.
GetAverageTrueRange
Wilder's Average True Range (ATR) for one stock (a volatility measure built from the true range (the greatest of high−low, /high−prev close/ and /low−prev close/) and smoothed recursively over period days) shown alongside each day's close, newest first.
GetOnBalanceVolume
On-Balance Volume (OBV) for one stock.
GetCorrelatedStocks
The stocks whose daily returns move most (or least) with one stock.
Options
Tool
Description
GetOptionExpirations
The listed expiration dates for an underlying, ascending, with the number of active contracts at each.
GetOptionChain
The calls-and-puts chain for one expiration: strike, type, last daily price, dated open interest, implied volatility and greeks (delta, gamma, theta, vega).
GetOptionContract
A single option contract by its OCC symbol: last daily price and range, dated open interest, implied volatility, greeks, and tier-appropriate bid/ask.
Economic, futures & sentiment
Tool
Description
GetEconomicIndicator
The observation history for one FRED economic series, one row per period with its value, plus the series title, units, frequency, and seasonal-adjustment flag.
GetLatestEconomicIndicators
The latest reading for every tracked FRED series, grouped by category, as a one-glance macro dashboard.
SearchEconomicIndicators
Search the tracked FRED series by exact ID, verified common alias, or title/topic words in any order.
GetEconomicCalendar
The economic-release calendar: upcoming release dates by default, and recent ones when startDate is in the past.
GetMarketStatus
Whether the US equity market is open right now, the current session, and the next open and close, computed from the exchange's curated holiday and early-close calendar, in Eastern Time.
GetMarketHolidayCalendar
The US market's holidays and early-close (1:00 p.m.
GetCftcPositioning
The weekly Commitments of Traders (COT) positioning for one futures contract.
GetLatestCftcPositioning
The latest COT snapshot across every tracked contract, grouped by category (Agriculture, Energy, Metals, Equity Indices, Interest Rates, Currencies), with open interest and net commercial / non-commercial positioning at a glance.
SearchCftcMarkets
Search the tracked CFTC futures-contract set by exact market code, verified standard symbol/common alias, or name words in any order.
GetPutCallRatios
The CBOE put/call ratio history for one ratio type (equity by default): call and put volume, total, and the P/C ratio per date.
GetVixHistory
The CBOE VIX daily OHLC series (the market's "fear gauge"), available back to 1990.
IPOs
Tool
Description
GetIpoFeed
Returns the tracked registrations, newest filing activity first.
GetIpoDetails
Returns one registration's full picture by SEC CIK.
Stock indexes
Tool
Description
GetIndexComposition
Returns one index's current constituent list, heaviest first, with each company's share of the index and the tracking fund's position in it.
GetIndexChanges
Returns the companies that have joined or left an index, newest first.
GetIndexForecast
Applies an index's own published entry rules to every company we track.
Your portfolio
Tool
Description
GetMyPortfolio
Your positions, priced, with cost basis, unrealized profit and the realized profit from lots you have closed.
CreateMyPortfolio ✏️
Creates a new, empty portfolio.
AddPortfolioLot ✏️
Records one purchase or sale.
UpdatePortfolioLot ✏️
Corrects a lot you already recorded: a mistyped quantity, price, date, note or exchange rate.
ClosePortfolioLot ✏️
Records that you sold, covered, or let a lot expire, at a price and on a date.
RemovePortfolioLot ✏️
Permanently deletes a lot, as if it had never been recorded.
WatchInstrument ✏️
Puts a stock or an option contract on a portfolio's watchlist, without recording any position.
UnwatchInstrument ✏️
Removes an instrument from a portfolio's watchlist.
DeleteMyPortfolio ✏️
Permanently deletes a portfolio and every lot in it, open and closed, including the realized-profit history.
Trackers
Tool
Description
ListWebDataFeeds
Lists the caller's trackers with their identifiers, active or paused state, visibility, source access, schedule, next collection, and latest run status.
GetWebDataFeed
Reads the latest independently verified successful result and its captured source URLs by default.
Supply chains
Tool
Description
GetSupplyChain
A company's supply chain.
GetSupplyChainOverlap
Which of a company's suppliers and customers also supply or buy from its listed competitors, from the same 10-K readings as GetSupplyChain.
GetOrganization
An organization that no market we cover lists: the U.S.
Agent feedback
Tool
Description
ReportProblem ✏️
Report an Equibles tool call you actually made when it failed, timed out, was unexpectedly empty (ToolFailed), or returned verifiably impossible or contradictory data (ImplausibleResult).
SuggestToolImprovement ✏️
Suggest the smallest actionable contract improvement to an existing Equibles tool you actually called when it worked as documented but lacked a useful operation, filter, parameter or output option.
One shared daily counter across both the MCP server and the REST API; it resets at 00:00 UTC.
Rate-limit headers are exposed on responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and Retry-After (on 429).
When you go over the limit, the MCP server answers in-band with a normal tool result explaining the limit rather than returning an opaque error, so your agent can read and react to it.
git clone https://github.com/daniel3303/Equibles
cd Equibles
docker compose up
The MCP server comes up at http://localhost:8081/mcp. No API key is required by default; set the MCP_API_KEY environment variable to require an Authorization: Bearer <key> header. When self-hosting, the Bearer header is the only auth method (no query parameter, no OAuth).
The self-hosted server exposes the 64-tool open-source subset: 13F holdings, insider trading, SEC filings and fundamentals, funds/ETFs/advisers, FRED, CFTC, CBOE, congressional trades, short data, stock prices, government contracts, and the FDA calendar. The hosted server adds 44 more on top: earnings calls, guidance, KPIs, the screener, valuation multiples, buybacks, executive data, live quotes, options chains, IPO filings, and your own portfolio.
Note: the self-hosted stack runs its own scrapers against the primary sources, so the databases start empty and fill up over time after you start it.
REST API
Everything is also available as a conventional REST API at https://api.equibles.com/v1, sharing the same API key and daily limit as the MCP server. Docs at https://equibles.com/docs.
Data sources & methodology
Every dataset is parsed from the primary source, never from third-party estimates:
SEC EDGAR — filings, XBRL fundamentals, 13F holdings, Forms 3/4/5/144, NPORT, ADV, N-CEN, Form D
FINRA — short volume, short interest, dark-pool / off-exchange volume
FRED — economic indicators and macro series
CFTC — Commitments of Traders futures positioning
CBOE — put/call ratios and VIX
USAspending.gov — federal government contract awards
Company IR sites — investor-relations news and events
Congressional disclosures — member trades and net worth