Signal8
NPM · @SIGNAL8AI/MCP · 2 COMPONENTS · SCANNED AUG 3
SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.
Available components
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
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 2 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
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
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
claude mcp add ai-signal8-mcp -- npx -y @signal8ai/mcp
codex mcp add ai-signal8-mcp -- npx -y @signal8ai/mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ai-signal8-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@signal8ai/mcp"
],
"enabled": true
}
}
} openclaw mcp add ai-signal8-mcp --command npx --arg -y --arg @signal8ai/mcp
mcp_servers:
ai-signal8-mcp:
command: "npx"
args: ["-y", "@signal8ai/mcp"] {
"mcpServers": {
"ai-signal8-mcp": {
"command": "npx",
"args": [
"-y",
"@signal8ai/mcp"
]
}
}
} 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.
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.
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.
get_accumulation_snapshot 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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_analyst_consensus 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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_analyst_coverage Get Analyst Coverage ~55
Get aggregated analyst coverage for a ticker — consolidated view of grades, targets, and coverage breadth across covering firms.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_analyst_estimates 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum number of estimate periods to return (1-40). Defaults to 8. |
| period | string | — | Estimate period: "annual" (default) or "quarter". |
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_analyst_grades Get Analyst Grades ~83
Get recent analyst grade actions (upgrades, downgrades, initiations) for a ticker, including the grading firm and previous/new grade.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Maximum results to return (default: 10, max: 50) |
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_cash_history Get 10-Year 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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_cash_position Get AI 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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_cash_runway_calendar Get Cash Runway Depletion 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.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | — | Start date (YYYY-MM-DD, default: today) |
| industry | string | — | Filter by company industry (exact match, e.g. "Biotechnology") |
| limit | number | — | Maximum results to return (default: 25, max: 100) |
| offset | number | — | Offset for pagination (default: 0) |
| to | string | — | End date (YYYY-MM-DD, default: today + 90 days) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_clinical_trials 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum number of clinical trials to return (1-50). Defaults to 10. |
| ticker | string | yes | Stock ticker symbol (e.g., "MRNA", "PFE") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_company_profile 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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., AAPL, TSLA) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_compliance Get Compliance Evaluation ~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).
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., AAPL, TSLA) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_donor_aggregates 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.
| Name | Type | Req | Description |
|---|---|---|---|
| chamber | string | — | Filter by chamber: 'senate' or 'house' |
| cycle | string | — | Election cycle as 4-digit year (e.g. "2024"). Defaults to most recent cycle. |
| party | string | — | Filter by party: 'D', 'R', or 'I' |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_earnings Get Earnings History ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum number of earnings periods to return (1-40). Defaults to 8. |
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_earnings_calendar 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.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | yes | Start date inclusive (YYYY-MM-DD) |
| maxMarketCap | number | — | Maximum market cap in USD (e.g., 2000000000 for under $2B) |
| minMarketCap | number | — | Minimum market cap in USD (e.g., 10000000000 for $10B+) |
| tickers | array | — | Optional ticker filter, e.g. ["AAPL","NVDA"] |
| to | string | yes | End date inclusive (YYYY-MM-DD) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_economic_calendar 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.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | — | Optional ISO-3166 alpha-2 country code (e.g. "US", "GB", "JP") |
| from | string | yes | Start date inclusive (YYYY-MM-DD) |
| to | string | yes | End date inclusive (YYYY-MM-DD) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_etf_bundle 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).
| Name | Type | Req | Description |
|---|---|---|---|
| include | string | — | Comma-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… |
| ticker | string | yes | ETF ticker symbol (e.g., SPY, QQQ, IWM) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_executives Get Company Executives ~58
Get key executives and officers of a company including name, title, compensation, and tenure. Use when researching company leadership or management quality.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_exhibit_content 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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Exhibit ID (numeric). Find via get_filing_exhibits. |
| maxLength | number | — | Truncate content to this many characters. Response includes a "truncated" boolean. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_filing_calendar Get SEC 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).
| Name | Type | Req | Description |
|---|---|---|---|
| formTypes | array | — | Optional SEC form types subset, e.g. ["10-Q"] |
| from | string | — | Start date inclusive (YYYY-MM-DD, default today) |
| to | string | — | End date inclusive (YYYY-MM-DD, default today + 45d) |
| universe | string | — | Optional index-universe filter (default "all") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_filing_document 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.
| Name | Type | Req | Description |
|---|---|---|---|
| filingId | string | yes | Internal filing ID (numeric). Find via search_sec_filings. |
| maxLength | number | — | Truncate content to this many characters. Useful for previewing large filings. Response includes a "truncated" boolean when truncation is applied. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_filing_exhibits 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.
| Name | Type | Req | Description |
|---|---|---|---|
| filingId | string | yes | Internal filing ID (numeric). Find via search_sec_filings. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_financials Get Financial Statements ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum number of periods to return (1-40). Defaults to 8. |
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| type | string | — | Financial period type: "annual", "quarter", or "ttm" (trailing twelve months). Defaults to annual. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_float Get Float Data ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_float_history 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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | — | Lookback window in trade dates. Default 90, clamped to 1-730. |
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_historical_prices Get Historical Stock 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.
| Name | Type | Req | Description |
|---|---|---|---|
| from | integer | — | Start date as UNIX timestamp (overrides period) |
| period | string | — | Lookback period shorthand (default: "1Y"). Ignored if from/to are provided. |
| resolution | string | — | Candle resolution: "D" (daily, default), "W" (weekly), "M" (monthly) |
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| to | integer | — | End date as UNIX timestamp (overrides period) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_insider_cluster_buys 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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., AAPL, TSLA) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_insider_cross_company Get Cross-Company Insider Trading ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| endDate | string | — | End date for transaction range in ISO format (e.g., "2025-12-31") |
| insiderName | string | — | Filter by insider name (partial match, e.g., "Musk" or "Cohen") |
| limit | number | — | Maximum results to return (default: 10, max: 100) |
| offset | number | — | Offset for pagination (default: 0) |
| startDate | string | — | Start date for transaction range in ISO format (e.g., "2025-01-01") |
| transactionType | string | — | Filter by transaction type: "P" (purchase), "S" (sale), "A" (grant/award), "M" (conversion) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_insider_positions 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.
| Name | Type | Req | Description |
|---|---|---|---|
| cik | string | yes | SEC CIK number of the insider OR the issuer (company). Tried as issuer first, then falls back to insider. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_insider_positions_by_ticker 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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_insider_transactions 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Maximum results to return (default: 20, max: 100) |
| month | integer | — | Filter by transaction month (1-12, requires year) |
| offset | number | — | Offset for pagination (default: 0) |
| ticker | string | yes | Stock ticker symbol (e.g., AAPL, TSLA) |
| transactionCode | string | — | Filter 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. |
| year | integer | — | Filter by transaction year (e.g., 2025) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_insiders Get Insider Trading Intelligence ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum results to return (default: 20, max: 100) |
| offset | integer | — | Offset for pagination (default: 0) |
| ticker | string | yes | Stock ticker symbol (e.g., AAPL, TSLA) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institution_activity Get Institution Activity ~72
Get an institution's position changes over recent 13F periods by CIK. Reads the number of trailing periods to include.
| Name | Type | Req | Description |
|---|---|---|---|
| cik | string | yes | SEC CIK number of the institution |
| periods | number | — | Number of trailing quarters to include (default: 4, max: 12) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institution_derivatives Get Institution Derivatives ~121
Get an institution's reported PUT/CALL derivative positions by CIK (13F options), with pagination and sorting.
| Name | Type | Req | Description |
|---|---|---|---|
| cik | string | yes | SEC CIK number of the institution |
| limit | number | — | Maximum results to return (default: 20) |
| offset | number | — | Offset for pagination (default: 0) |
| period | string | — | Filing period to filter (e.g., "2025-Q1") |
| sortBy | string | — | Column to sort by |
| sortOrder | string | — | Sort direction |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institution_detail 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.
| Name | Type | Req | Description |
|---|---|---|---|
| cik | string | yes | SEC CIK number of the institution (e.g., "0001067983" for Berkshire Hathaway) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institution_filings Get Institution Filings ~79
Get the list of 13F filings for an institution by CIK, with pagination.
| Name | Type | Req | Description |
|---|---|---|---|
| cik | string | yes | SEC CIK number of the institution |
| limit | number | — | Maximum results to return (default: 20, max: 50) |
| offset | number | — | Offset for pagination (default: 0) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institution_holdings 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.
| Name | Type | Req | Description |
|---|---|---|---|
| cik | string | yes | SEC CIK number of the institution |
| limit | number | — | Maximum results to return (default: 20, max: 100) |
| offset | number | — | Offset for pagination (default: 0) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institution_portfolio_analytics Get Institution Portfolio Analytics ~43
Get sector allocation and top holdings analytics for an institution's portfolio by CIK.
| Name | Type | Req | Description |
|---|---|---|---|
| cik | string | yes | SEC CIK number of the institution |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institution_position_changes 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.
| Name | Type | Req | Description |
|---|---|---|---|
| cik | string | yes | SEC CIK number of the institution (e.g., "0001067983" for Berkshire Hathaway) |
| limit | integer | — | Maximum results to return (default: 50, max: 100) |
| offset | integer | — | Offset for pagination (default: 0) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institution_top_aum Get Top Institutions by 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Maximum results to return (default: 25, max: 100) |
| minAum | number | — | Minimum AUM in USD to filter institutions (e.g., 1000000000 for $1B+) |
| offset | number | — | Offset for pagination (default: 0) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institutions Get Institutional Holders ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Maximum results to return (default: 20, max: 100) |
| offset | number | — | Offset for pagination (default: 0) |
| ticker | string | yes | Stock ticker symbol (e.g., AAPL, TSLA) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_institutions_leaderboards Get Institution 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Maximum results per section (default: 10, max: 50) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_intraday_bars Get Intraday Price 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.
| Name | Type | Req | Description |
|---|---|---|---|
| extended | boolean | — | Include extended-hours bars (premarket 04:00–09:30 ET and after-hours 16:00–20:00 ET). Only supported with resolution "1". |
| from | integer | yes | Start time as UNIX timestamp |
| resolution | string | yes | Bar resolution in minutes |
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| to | integer | yes | End time as UNIX timestamp |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_legislative_calendar 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).
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | — | Earliest vote-window date inclusive (YYYY-MM-DD, default: today) |
| limit | number | — | Maximum results to return (default: 25, max: 100) |
| minRelevance | string | — | Minimum market relevance: 'low' (default), 'medium', 'high', or 'none' (explicit opt-in to the full audit trail incl. non-market items — rarely useful) |
| offset | number | — | Pagination offset (default: 0) |
| to | string | — | Latest vote-window date inclusive (YYYY-MM-DD, default: today + 14 days) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_market_breadth 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.
| Name | Type | Req | Description |
|---|---|---|---|
| universe | string | — | Universe to aggregate over: sp500, ndx, or all (default sp500) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_market_metrics 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.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_market_news Get Market News (Top Stories) ~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).
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum items to return (1-50). Defaults to 10. |
| significance | string | — | CSV of levels to include, e.g. "critical,major" (default) or "critical,major,standard". |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_news Get Company 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum number of articles to return (1-20). Defaults to 10. |
| pressReleasesOnly | boolean | — | When true, return only official company press releases (exclude third-party news). |
| ticker | string | yes | Stock ticker symbol (e.g., "AAPL", "TSLA") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_ownership Get Comprehensive 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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum holders to return in allHolders (default: 100, max: 100) |
| offset | integer | — | Offset for pagination (default: 0) |
| ticker | string | yes | Stock ticker symbol (e.g., AAPL, TSLA) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_policy_events 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).
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | — | Earliest signing date inclusive (YYYY-MM-DD) |
| limit | number | — | Maximum results to return (default: 25, max: 100) |
| offset | number | — | Pagination offset (default: 0) |
| q | string | — | Free-text search over event titles |
| sector | string | — | Filter by canonical affected sector (one of the 11 canonical sector strings, e.g. "Healthcare", "Financial Services", "Energy") |
| to | string | — | Latest signing date inclusive (YYYY-MM-DD) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.
get_policy_trade_leaderboard 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).
| Name | Type | Req | Description |
|---|---|---|---|
| direction | string | — | Which side of the signing date to include: 'before' (default), 'after', or 'both' |
| limit | number | — | Maximum results to return (default: 50, max: 100) |
| offset | number | — | Pagination offset (default: 0) |
| sort | string | — | Ranking order: 'usd' (default — estimated USD value) or 'count' (flagged-trade count) |
| window | number | — | Match window in days around the EO signing date (default: 14, max: 30) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | — |
No examples provided.