Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

Signal8

NPM · @SIGNAL8AI/MCP · 2 COMPONENTS · SCANNED AUG 3

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

+19 this week 70 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (121 of 123), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (121 of 123), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability78
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 16449 tokens (~176/item across 93 items; 92 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @signal8ai/mcp

# add to Claude Code
claude mcp add ai-signal8-mcp -- npx -y @signal8ai/mcp
# add to Codex CLI
codex mcp add ai-signal8-mcp -- npx -y @signal8ai/mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-signal8-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@signal8ai/mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add ai-signal8-mcp --command npx --arg -y --arg @signal8ai/mcp
# ~/.hermes/config.yaml
mcp_servers:
  ai-signal8-mcp:
    command: "npx"
    args: ["-y", "@signal8ai/mcp"]
// mcp.json
{
  "mcpServers": {
    "ai-signal8-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@signal8ai/mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +30
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Schema quality: unverified → excellent functional
    • License: unverified → pass functional
    • Maintenance: unverified → pass functional
    • Stability: unverified → 0.27 functional
    • MCP protocol: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Licence: MIT functional
  • 2 Aug 26 +15
    • Malware scan: unverified → pass security
  • 31 Jul 26 +19
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −74
    • Install scripts: pass → unverified security
    • Provenance: fail → unverified security
    • Malware scan: pass → unverified security
    • Known CVEs: partial → unverified security
    • Dependency health: partial → unverified functional
    • Schema quality: 100 → unverified functional
    • License: pass → unverified functional
    • Maintenance: pass → unverified functional
    • Tool coverage: 100 → unverified functional
    • Licence: MIT functional
    • Package version: 0.13.0 → 0.14.0 functional
  • 28 Jul 26 +29
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Dependency health: unverified → partial functional
    • Schema quality: unverified → good functional
    • Maintenance: unverified → pass functional
    • License: unverified → pass functional
    • Licence: MIT functional
  • 27 Jul 26 51

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@signal8ai/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 121 packages

121 packages in the resolved dependency tree · 121 deprecated · 35 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 92 exposed · ~16,181 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
get_accumulation_snapshot ~88

Get intraday accumulation/distribution metrics for the current or most recent trading session. Returns session VWAP, volume above/below VWAP, estimated buy vs sell volume (tick rule), volume by time period (morning/midday/afternoon), and comparison to average volume. Use for assessing real-time buying/selling pressure.

NameTypeReqDescription
tickerstringyesStock ticker symbol
NameTypeReqDescription
data

No examples provided.

get_analyst_consensus ~70

Get analyst ratings consensus for a company including average target price, number of analysts, buy/hold/sell breakdown, and consensus recommendation. Use when evaluating Wall Street sentiment or price targets.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_analyst_coverage ~55

Get aggregated analyst coverage for a ticker — consolidated view of grades, targets, and coverage breadth across covering firms.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_analyst_estimates ~118

Get forward analyst estimates for a company including EPS, revenue, EBITDA, and net income (low/high/avg) with analyst counts. Supports annual and quarterly periods. Use when analyzing forward earnings expectations or revenue forecasts.

NameTypeReqDescription
limitintegerMaximum number of estimate periods to return (1-40). Defaults to 8.
periodstringEstimate period: "annual" (default) or "quarter".
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_analyst_grades ~83

Get recent analyst grade actions (upgrades, downgrades, initiations) for a ticker, including the grading firm and previous/new grade.

NameTypeReqDescription
limitnumberMaximum results to return (default: 10, max: 50)
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_cash_history ~100

Get up to 10 years of quarterly cash position history from SEC XBRL filings (data.sec.gov company-facts). Returns an array of {periodEnd, usd, formType, isAnnual} sorted chronologically. Deduped by period with annual filings preferred over quarterly. Not feature-gated — works for any company with SEC filings.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_cash_position ~112

Get the Signal8 AI cash position model for a company. Returns the cash anchor (from latest 10-K/10-Q), prorated burn rate, post-anchor capital raises, material cash events, and three runway scenarios (closed, pending, announced). Use when analyzing a company's current cash situation, runway, or capital raise activity. Returns 404 when no cash-position model is available for the requested ticker.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_cash_runway_calendar ~173

Find companies projected to run out of cash within a date window. Similar to lockup expiration calendars but for cash depletion events. Returns companies sorted by urgency (lowest runway first). Runway is an estimate based on current burn rate — actual depletion depends on future capital raises and operational changes. Default window is today to 90 days out.

NameTypeReqDescription
fromstringStart date (YYYY-MM-DD, default: today)
industrystringFilter by company industry (exact match, e.g. "Biotechnology")
limitnumberMaximum results to return (default: 25, max: 100)
offsetnumberOffset for pagination (default: 0)
tostringEnd date (YYYY-MM-DD, default: today + 90 days)
NameTypeReqDescription
data

No examples provided.

get_clinical_trials ~88

Get clinical trial data for a biotech/pharma company including trial phase, status, conditions, and interventions. Use when analyzing a biotech company's pipeline or upcoming catalyst events.

NameTypeReqDescription
limitintegerMaximum number of clinical trials to return (1-50). Defaults to 10.
tickerstringyesStock ticker symbol (e.g., "MRNA", "PFE")
NameTypeReqDescription
data

No examples provided.

get_company_profile ~115

Get an enriched company profile by ticker symbol. Returns CIK, exchange, sector, industry, market cap, employee count, description, and other fundamental data. This is a lightweight lookup (1 credit) -- use this when you only need basic company info rather than the full bundle. Always includes halted/haltCode/haltedAt trading-halt status (false/null when trading normally); a halted-but-listed ticker reports delisted:false.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., AAPL, TSLA)
NameTypeReqDescription
data

No examples provided.

get_compliance ~83

Get full compliance rules evaluation for a company. Runs Nasdaq/NYSE deficiency detection, bid price tracking, and delinquent filing detection. Returns a comprehensive compliance picture combining SEC filing data, market data, and exchange rules. This is the most thorough compliance check available (25 credits).

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., AAPL, TSLA)
NameTypeReqDescription
data

No examples provided.

get_donor_aggregates ~159

Get market-wide campaign-finance rollups across ALL tracked politicians for a cycle: total raised, top 10 individual donors, top 10 PACs, party/chamber/cycle splits, and a most-funded politician leaderboard. Use for "who are the biggest donors in 2024?" or "which party raised more?" type questions. For a single politician, use get_politician_donor_summary.

NameTypeReqDescription
chamberstringFilter by chamber: 'senate' or 'house'
cyclestringElection cycle as 4-digit year (e.g. "2024"). Defaults to most recent cycle.
partystringFilter by party: 'D', 'R', or 'I'
NameTypeReqDescription
data

No examples provided.

get_earnings ~88

Get historical earnings data for a company including EPS actual vs estimate, revenue actual vs estimate, and surprise percentages. Use when analyzing earnings beats/misses or upcoming earnings expectations.

NameTypeReqDescription
limitintegerMaximum number of earnings periods to return (1-40). Defaults to 8.
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_earnings_calendar ~172

Get upcoming and recent earnings releases between two dates. Optionally restrict to a list of tickers. Returns ticker, date, time (BMO/AMC), EPS estimate, and revenue estimate when available. Supports market cap filtering to focus on large-cap or small-cap earnings only.

NameTypeReqDescription
fromstringyesStart date inclusive (YYYY-MM-DD)
maxMarketCapnumberMaximum market cap in USD (e.g., 2000000000 for under $2B)
minMarketCapnumberMinimum market cap in USD (e.g., 10000000000 for $10B+)
tickersarrayOptional ticker filter, e.g. ["AAPL","NVDA"]
tostringyesEnd date inclusive (YYYY-MM-DD)
NameTypeReqDescription
data

No examples provided.

get_economic_calendar ~120

Get scheduled macro/economic events (CPI, FOMC, jobs reports, GDP, etc.) between two dates. Optionally filter to a single country (ISO-3166 alpha-2, e.g. "US"). Defaults to US when omitted.

NameTypeReqDescription
countrystringOptional ISO-3166 alpha-2 country code (e.g. "US", "GB", "JP")
fromstringyesStart date inclusive (YYYY-MM-DD)
tostringyesEnd date inclusive (YYYY-MM-DD)
NameTypeReqDescription
data

No examples provided.

get_etf_bundle ~158

Get aggregated ETF data in a single call. Combines multiple data sources (profile, holdings, sector weightings, country exposure, performance, news, analyst coverage, and comparables) into one response. Each data type is cached independently. Specify which types to include or omit to get above-the-fold defaults (profile, stock-summary, holdings, sectors).

NameTypeReqDescription
includestringComma-separated list of data types to include. Available: profile,holdings,sectors,countries,stock-summary,performance,news,analyst,comparables. Default (when omitted): profile,stock-summary,holdings…
tickerstringyesETF ticker symbol (e.g., SPY, QQQ, IWM)
NameTypeReqDescription
data

No examples provided.

get_executives ~58

Get key executives and officers of a company including name, title, compensation, and tenure. Use when researching company leadership or management quality.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_exhibit_content ~113

Get the full text/HTML content of a single exhibit from an SEC filing. Returns the exhibit text along with exhibit_type, description, company_name, accession_number, and form_type. Use the maxLength parameter to truncate large exhibits. Find exhibit IDs using get_filing_exhibits first.

NameTypeReqDescription
idstringyesExhibit ID (numeric). Find via get_filing_exhibits.
maxLengthnumberTruncate content to this many characters. Response includes a "truncated" boolean.
NameTypeReqDescription
data

No examples provided.

get_filing_calendar ~140

Get the forward-looking 10-K / 10-Q SEC filing-deadline calendar within a date window. Optionally restrict to a universe (sp500/ndx/dji/all) and/or a list of form types (default both 10-K and 10-Q).

NameTypeReqDescription
formTypesarrayOptional SEC form types subset, e.g. ["10-Q"]
fromstringStart date inclusive (YYYY-MM-DD, default today)
tostringEnd date inclusive (YYYY-MM-DD, default today + 45d)
universestringOptional index-universe filter (default "all")
NameTypeReqDescription
data

No examples provided.

get_filing_document ~147

Get the full raw text/HTML content of an SEC filing by its internal filing ID. Returns the complete filing document which can be very large (10-K filings can be 1MB+). Use the maxLength parameter to truncate content for previews. The response includes company_name, form_type, filing_date, cik, and accession_number alongside the content. Find filing IDs using search_sec_filings first.

NameTypeReqDescription
filingIdstringyesInternal filing ID (numeric). Find via search_sec_filings.
maxLengthnumberTruncate content to this many characters. Useful for previewing large filings. Response includes a "truncated" boolean when truncation is applied.
NameTypeReqDescription
data

No examples provided.

get_filing_exhibits ~79

List all exhibits (individual documents) within an SEC filing. Returns exhibit metadata including exhibit type, description, and content size. Use this to identify which exhibits to read with get_exhibit_content. Excludes XML/XBRL exhibits.

NameTypeReqDescription
filingIdstringyesInternal filing ID (numeric). Find via search_sec_filings.
NameTypeReqDescription
data

No examples provided.

get_financials ~124

Get income statement, balance sheet, and cash flow data for a company. Supports annual, quarterly, and trailing-twelve-month views. Use when analyzing revenue, profitability, debt, or cash position.

NameTypeReqDescription
limitintegerMaximum number of periods to return (1-40). Defaults to 8.
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
typestringFinancial period type: "annual", "quarter", or "ttm" (trailing twelve months). Defaults to annual.
NameTypeReqDescription
data

No examples provided.

get_float ~62

Get float and share structure data for a company including shares outstanding, public float, insider ownership percentage, and institutional ownership. Use when analyzing share supply and ownership concentration.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_float_history ~219

Get the POINT-IN-TIME float history for a company — one sample per trade date (float shares, shares outstanding, and the source the float came from). Use to answer "what was the float on date X" or to see float expand across a dilution event, which the latest-only get_float cannot show. IMPORTANT: this series is FORWARD-ONLY — it began accumulating in mid-2026 and is NOT backfilled, so early/absent history is expected and an empty rows array is a normal result, not an error or a delisted company. Each row carries "source" ("polygon" | "computed" | "sec_10k" | "fmp") because float quality varies by provider — weigh rows accordingly rather than treating all sources as equal. Charged per your API tier.

NameTypeReqDescription
daysintegerLookback window in trade dates. Default 90, clamped to 1-730.
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_historical_prices ~196

Get historical OHLCV price candles for a stock. Supports daily, weekly, and monthly resolutions. Use period shorthand (1M, 3M, 6M, 1Y, 5Y, ALL) or explicit from/to UNIX timestamps. Default is 1 year of daily candles. Use this to compute price returns, chart price history, or analyze volume trends over time.

NameTypeReqDescription
fromintegerStart date as UNIX timestamp (overrides period)
periodstringLookback period shorthand (default: "1Y"). Ignored if from/to are provided.
resolutionstringCandle resolution: "D" (daily, default), "W" (weekly), "M" (monthly)
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
tointegerEnd date as UNIX timestamp (overrides period)
NameTypeReqDescription
data

No examples provided.

get_insider_cluster_buys ~73

Detect cluster buying patterns for a company. Identifies periods where 3+ distinct insiders purchased shares within a 14-day window -- a strong bullish signal that often precedes positive corporate announcements or price appreciation.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., AAPL, TSLA)
NameTypeReqDescription
data

No examples provided.

get_insider_cross_company ~241

Discover insider trading patterns across multiple companies. Unlike get_insiders which shows insider activity for a single ticker, this tool searches the entire universe to find insiders active across multiple companies, cluster buying patterns, and large transactions. Filter by insider name, transaction type, or date range. Useful for detecting coordinated insider activity, cross-company insider networks, and market-wide buying/selling trends.

NameTypeReqDescription
endDatestringEnd date for transaction range in ISO format (e.g., "2025-12-31")
insiderNamestringFilter by insider name (partial match, e.g., "Musk" or "Cohen")
limitnumberMaximum results to return (default: 10, max: 100)
offsetnumberOffset for pagination (default: 0)
startDatestringStart date for transaction range in ISO format (e.g., "2025-01-01")
transactionTypestringFilter by transaction type: "P" (purchase), "S" (sale), "A" (grant/award), "M" (conversion)
NameTypeReqDescription
data

No examples provided.

get_insider_positions ~139

Get current open insider positions for a CIK (either an insider or an issuer). If an issuer (company) CIK is supplied, returns all insiders' positions for that company. If an insider (reporting-person) CIK is supplied, returns that insider's open positions across all issuers they have filed Form 4 for. The response includes a `lookupMode` field (`"issuer"` or `"insider"`) indicating which interpretation matched. Derived from Form 4 filings.

NameTypeReqDescription
cikstringyesSEC CIK number of the insider OR the issuer (company). Tried as issuer first, then falls back to insider.
NameTypeReqDescription
data

No examples provided.

get_insider_positions_by_ticker ~66

Get per-insider lifetime position aggregates for a given ticker — which insiders hold positions in the stock and their aggregate cost/value. Derived from Form 4 filings.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_insider_transactions ~239

Get detailed insider transaction history for a company from Form 4 filings. Returns individual buy/sell transactions with insider name, title, shares, price, and transaction codes. Supports pagination for companies with extensive insider activity. Filter by year/month to narrow results, or use transactionCode to find only purchases (P), sales (S), etc. Useful for identifying "first insider buy since X" patterns.

NameTypeReqDescription
limitnumberMaximum results to return (default: 20, max: 100)
monthintegerFilter by transaction month (1-12, requires year)
offsetnumberOffset for pagination (default: 0)
tickerstringyesStock ticker symbol (e.g., AAPL, TSLA)
transactionCodestringFilter by SEC transaction code: P=Purchase, S=Sale, A=Grant/Award, M=Exercise/Conversion, F=Tax withholding, G=Gift, C=Conversion, W=Will, D=Disposition to issuer, etc.
yearintegerFilter by transaction year (e.g., 2025)
NameTypeReqDescription
data

No examples provided.

get_insiders ~182

Get insider trading discovery data for a company. Includes cluster buying detection, entity-centric insider model, and Form 4 cross-referencing. Shows insider transactions with buying/selling patterns that may signal upcoming corporate actions. Each insider includes a transactionBreakdown by SEC code (P=Purchase, S=Sale, F=Tax withholding, M=Exercise, G=Gift, A=Award), netSharesSold12m (code S only, excludes tax withholding), and isPrimarilyTaxWithholding flag to distinguish routine RSU vesting from discretionary selling. Supports pagination with limit/offset.

NameTypeReqDescription
limitintegerMaximum results to return (default: 20, max: 100)
offsetintegerOffset for pagination (default: 0)
tickerstringyesStock ticker symbol (e.g., AAPL, TSLA)
NameTypeReqDescription
data

No examples provided.

get_institution_activity ~72

Get an institution's position changes over recent 13F periods by CIK. Reads the number of trailing periods to include.

NameTypeReqDescription
cikstringyesSEC CIK number of the institution
periodsnumberNumber of trailing quarters to include (default: 4, max: 12)
NameTypeReqDescription
data

No examples provided.

get_institution_derivatives ~121

Get an institution's reported PUT/CALL derivative positions by CIK (13F options), with pagination and sorting.

NameTypeReqDescription
cikstringyesSEC CIK number of the institution
limitnumberMaximum results to return (default: 20)
offsetnumberOffset for pagination (default: 0)
periodstringFiling period to filter (e.g., "2025-Q1")
sortBystringColumn to sort by
sortOrderstringSort direction
NameTypeReqDescription
data

No examples provided.

get_institution_detail ~84

Get detailed information about a specific institutional investor by their SEC CIK number. Returns the institution name, total AUM, number of holdings, and filing history. Use get_institutions first to find the CIK for an institution.

NameTypeReqDescription
cikstringyesSEC CIK number of the institution (e.g., "0001067983" for Berkshire Hathaway)
NameTypeReqDescription
data

No examples provided.

get_institution_filings ~79

Get the list of 13F filings for an institution by CIK, with pagination.

NameTypeReqDescription
cikstringyesSEC CIK number of the institution
limitnumberMaximum results to return (default: 20, max: 50)
offsetnumberOffset for pagination (default: 0)
NameTypeReqDescription
data

No examples provided.

get_institution_holdings ~101

Get the full portfolio holdings for a specific institution by CIK. Returns all positions from their latest 13F filing with shares, value, and portfolio weight. Supports pagination for institutions with large portfolios.

NameTypeReqDescription
cikstringyesSEC CIK number of the institution
limitnumberMaximum results to return (default: 20, max: 100)
offsetnumberOffset for pagination (default: 0)
NameTypeReqDescription
data

No examples provided.

get_institution_portfolio_analytics ~43

Get sector allocation and top holdings analytics for an institution's portfolio by CIK.

NameTypeReqDescription
cikstringyesSEC CIK number of the institution
NameTypeReqDescription
data

No examples provided.

get_institution_position_changes ~151

Diff two quarterly 13F snapshots for an institution. Compares the latest filing against the prior quarter and returns per-position changes: new positions, increased, decreased, and exited. Sorted by |changePercent| descending so the biggest moves surface first. Much more efficient than calling get_institution_holdings twice and diffing client-side — the server computes everything in a single SQL query.

NameTypeReqDescription
cikstringyesSEC CIK number of the institution (e.g., "0001067983" for Berkshire Hathaway)
limitintegerMaximum results to return (default: 50, max: 100)
offsetintegerOffset for pagination (default: 0)
NameTypeReqDescription
data

No examples provided.

get_institution_top_aum ~142

Discover top institutional holders across the entire company universe ranked by assets under management (AUM). Unlike get_ownership which shows institutions for a single company, this tool searches across all companies to find the largest institutional players. Optionally set a minimum AUM. Useful for identifying smart money flows and major institutional positioning trends.

NameTypeReqDescription
limitnumberMaximum results to return (default: 25, max: 100)
minAumnumberMinimum AUM in USD to filter institutions (e.g., 1000000000 for $1B+)
offsetnumberOffset for pagination (default: 0)
NameTypeReqDescription
data

No examples provided.

get_institutions ~112

Get institutional holders (13F filers) for a company. Returns institutions that hold positions in this stock based on SEC 13F filings, including shares held, portfolio weight, and filing dates. Useful for understanding institutional ownership concentration.

NameTypeReqDescription
limitnumberMaximum results to return (default: 20, max: 100)
offsetnumberOffset for pagination (default: 0)
tickerstringyesStock ticker symbol (e.g., AAPL, TSLA)
NameTypeReqDescription
data

No examples provided.

get_institutions_leaderboards ~95

Two market-wide institution leaderboards in one call: topByAum (largest holders by assets under management, name-deduped) and mostActive (highest 13F position-change volume). No CIK required. For the full paginated AUM list use get_institution_top_aum.

NameTypeReqDescription
limitnumberMaximum results per section (default: 10, max: 50)
NameTypeReqDescription
data

No examples provided.

get_intraday_bars ~205

Get intraday OHLCV candles at 1, 5, 15, 30, or 60-minute resolution. Use for intraday price action analysis, volume patterns, and short-term technical analysis. Returns open, high, low, close, and volume for each bar. Set extended=true (1-minute resolution only) to include premarket (04:00–09:30 ET) and after-hours (16:00–20:00 ET) bars.

NameTypeReqDescription
extendedbooleanInclude extended-hours bars (premarket 04:00–09:30 ET and after-hours 16:00–20:00 ET). Only supported with resolution "1".
fromintegeryesStart time as UNIX timestamp
resolutionstringyesBar resolution in minutes
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
tointegeryesEnd time as UNIX timestamp
NameTypeReqDescription
data

No examples provided.

get_legislative_calendar ~434

Forward-looking legislative catalyst calendar: upcoming House/Senate floor votes (bills and Senate cloture motions) filtered to items that can move tickers. Each item includes the predicted vote window (start/end/granularity/confidence/provenance), marketRelevance (low/medium/high), significance (1-5), affected sectors with direction + mechanism, verified affected tickers with evidence quotes, pass outlook, considerationProcedure (suspension-calendar bills pass ~98% of the time), a conflictBadge when the sponsor traded a verified affected ticker, and tweet/plain summaries. An EMPTY calendar is a normal state — it means nothing market-relevant is scheduled in the window, not an error. Defaults: from=today, to=+14 days, minRelevance=low. IMPORTANT: affectedTickers contains VERIFIED rows only — every ticker carries a verbatim evidenceQuote substring-verified against the actual bill text (no hallucinated tickers). sponsorTradeFacts are restatements of public STOCK Act disclosures with verbatim amount brackets and BOTH transactionDate AND disclosureDate — always cite both dates together (disclosures lag trades by up to 45 days), and never present a fact as evidence of wrongdoing. Vote windows are predictions: check window.provenance for trust level ('uc_explicit' is exact; 'rule_xxii_computed' is a medium-confidence estimate) and window.granularity for how precise the window is (exact time vs day vs week).

NameTypeReqDescription
fromstringEarliest vote-window date inclusive (YYYY-MM-DD, default: today)
limitnumberMaximum results to return (default: 25, max: 100)
minRelevancestringMinimum market relevance: 'low' (default), 'medium', 'high', or 'none' (explicit opt-in to the full audit trail incl. non-market items — rarely useful)
offsetnumberPagination offset (default: 0)
tostringLatest vote-window date inclusive (YYYY-MM-DD, default: today + 14 days)
NameTypeReqDescription
data

No examples provided.

get_market_breadth ~101

Get market breadth aggregates (advance/decline counts and ratio, percent of constituents above their 50DMA and 200DMA, and counts of new 52-week highs/lows) for a chosen universe (sp500, ndx, or all). Use to add market-state context to commentary, tweets, or daily summaries.

NameTypeReqDescription
universestringUniverse to aggregate over: sp500, ndx, or all (default sp500)
NameTypeReqDescription
data

No examples provided.

get_market_metrics ~63

Get computed market metrics for a company including volume averages, volatility, SMAs, and trend direction. Use when analyzing trading patterns or technical indicators beyond the basic quote.

NameTypeReqDescription
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_market_news ~156

Get the latest market-wide news across ALL tickers, most recent first. Every item is significance-classified at ingest (critical | major | standard); the default filter of critical,major is the "top stories" view. Use for "what is happening in the market right now" — for news about one company, use get_news with a ticker instead. Requires the /news/latest public endpoint (added 2026-07-29; 404 until that backend deploy).

NameTypeReqDescription
limitintegerMaximum items to return (1-50). Defaults to 10.
significancestringCSV of levels to include, e.g. "critical,major" (default) or "critical,major,standard".
NameTypeReqDescription
data

No examples provided.

get_news ~111

Get recent news articles and press releases for a company. Use when researching recent developments, catalysts, or sentiment drivers. Set pressReleasesOnly to return only official company press releases.

NameTypeReqDescription
limitintegerMaximum number of articles to return (1-20). Defaults to 10.
pressReleasesOnlybooleanWhen true, return only official company press releases (exclude third-party news).
tickerstringyesStock ticker symbol (e.g., "AAPL", "TSLA")
NameTypeReqDescription
data

No examples provided.

get_ownership ~158

Get unified ownership breakdown for a company combining Form 4 insider holdings, 13F institutional holdings, and 13D/13G activist positions. All entities are resolved across the three SEC form types into a single view with counterparty resolution. The allHolders array is paginated via limit/offset (default 100). Aggregate stats (institutional/insider/beneficial/retail totals and percentages) are always included in full.

NameTypeReqDescription
limitintegerMaximum holders to return in allHolders (default: 100, max: 100)
offsetintegerOffset for pagination (default: 0)
tickerstringyesStock ticker symbol (e.g., AAPL, TSLA)
NameTypeReqDescription
data

No examples provided.

get_policy_events ~298

List mirrored executive orders (policy events) from the Federal Register feed. Filter by signing-date range, affected sector, or free-text title query. Each event includes its Federal Register document number (externalId), title, signing date (eventDate), normalized affected sectors, full-text URL, and flaggedTradeCount — the number of official trades that occurred in an affected sector near the signing date. IMPORTANT: matches are sector-level co-occurrence — the official traded a stock in a sector the executive order affects, within a window of its signing date. Sector matches are broad and many trades will coincide with policy activity by chance; a match is a starting point for research, not evidence of foreknowledge. The matchBasis field describes match strength only ('sector' = broad sector match), never culpability, and matchCount shows how many EOs matched in the window (a noise indicator).

NameTypeReqDescription
fromstringEarliest signing date inclusive (YYYY-MM-DD)
limitnumberMaximum results to return (default: 25, max: 100)
offsetnumberPagination offset (default: 0)
qstringFree-text search over event titles
sectorstringFilter by canonical affected sector (one of the 11 canonical sector strings, e.g. "Healthcare", "Financial Services", "Energy")
tostringLatest signing date inclusive (YYYY-MM-DD)
NameTypeReqDescription
data

No examples provided.

get_policy_trade_leaderboard ~316

Rank politicians (Congress + executive branch) by trades that occurred near executive-order signings in sectors the orders affect. Each row includes the politician, flaggedTradeCount, totalEstimatedUsd, topSector, and an exampleEvent. Use for "who trades most around policy activity" style questions. Defaults to the same "traded 1-14 days before signing" lens as get_policy_trade_overlap; same-day trades are always excluded. IMPORTANT: matches are sector-level co-occurrence — the official traded a stock in a sector the executive order affects, within a window of its signing date. Sector matches are broad and many trades will coincide with policy activity by chance; a match is a starting point for research, not evidence of foreknowledge. The matchBasis field describes match strength only ('sector' = broad sector match), never culpability, and matchCount shows how many EOs matched in the window (a noise indicator).

NameTypeReqDescription
directionstringWhich side of the signing date to include: 'before' (default), 'after', or 'both'
limitnumberMaximum results to return (default: 50, max: 100)
offsetnumberPagination offset (default: 0)
sortstringRanking order: 'usd' (default — estimated USD value) or 'count' (flagged-trade count)
windownumberMatch window in days around the EO signing date (default: 14, max: 30)
NameTypeReqDescription
data

No examples provided.