servers / signal8
Signal8 MCP server
communitystreamable_httpremotewrite capablehealthy
SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.
01Tools · 117
How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.
| Tool | Risk | Side effects | Approval |
|---|---|---|---|
| define_term Free: works without an API key or Pro plan (the hosted server only needs a signed-in account). Looks up a term in the Signal8 Academy glossary (signal8.ai/learn/glossary): dilution, SEC filing and trading jargon such as "ATM offering", "baby shelf", "full ratchet", "pre-funded warrant", "going concern", "LULD", "days to cover", "Form 25". Accepts a glossary slug ("atm-offering"), the term itself, or a common alias ("ATM", "price reset"); matching is case- and punctuation-insensitive. Returns the term, a one-line short definition, the long definition as Markdown, related terms, the Academy guides that use it, and the public url. A TERM_NOT_FOUND error means the glossary has no entry for that wording, not that the concept does not exist; the Academy guide search may still cover it. | read | false | unknown |
| get_accumulation_snapshot Get intraday accumulation/distribution metrics for the current or most recent trading session: session VWAP, volume above and below VWAP, estimated buy vs sell volume (tick rule), volume by time period (morning/midday/afternoon) and comparison to average volume, as a measure of real-time buying and selling pressure. | read | false | unknown |
| get_analyst_consensus Get the analyst ratings consensus for a company: average target price, number of analysts, buy/hold/sell breakdown and consensus recommendation. | read | false | unknown |
| get_analyst_coverage Get aggregated analyst coverage for a ticker: a consolidated view of grades, targets and coverage breadth across covering firms. | read | false | unknown |
| get_analyst_estimates Get forward analyst estimates for a company: EPS, revenue, EBITDA and net income (low/high/avg) with analyst counts, for annual or quarterly periods. | read | false | unknown |
| get_analyst_grades Get recent analyst grade actions (upgrades, downgrades, initiations) for a ticker, including the grading firm and previous/new grade. | read | false | unknown |
| get_baby_shelf_capacity SEC Form S-3 General Instruction I.B.6 "baby shelf" capacity: how much the issuer may raise off an effective shelf now, under the one-third-of-public-float cap that applies below a $75M non-affiliate float, less trailing-twelve-month takedowns. Returns the float basis, the cap, takedowns counted and the remaining raisable amount. `constraintApplies: false`: the cap does not bind (float >= $75M, primary offerings unlimited under I.B.1); this is neither "no capacity" nor a favourable finding. `constraintApplies: null` with `suppressedReason: "float_unmeasured"`: the float value was not measured, so whether the cap binds is unknown; it does not mean the cap does not bind and does not mean unlimited. A `suppressed` figure is withheld (e.g. an issuer delisted to OTC cannot run an S-3 primary): the capacity is not stateable, which is not $0 raisable. `suppressedReason: "ib6_pool_unattributed"`: the cap applies but trailing sales could not all be attributed, so $0 is a lower bound; `remainingCapacity` is null and capacity lies between `capacityLowerBoundDollars` and `capacityUpperBoundDollars` (at most the upper bound). `remainingCapacityBasis: "lower_bound"`: the figure counts unattributed rows whole, so capacity is at least `remainingCapacity` and at most `capacityUpperBoundDollars`. `staleIssuerStatement`: the issuer's own $0 statement dated `asOf` was not used because sales its window counted have since left today's window; it is what the issuer stated as of that date, not today's capacity. `poolDerivations`: ATM periods split by differencing the issuer's own stated sub-periods, each with its accession. `suppressedReason: "issuer_not_ib6_limited"`: the issuer's current prospectus offers more than the cap with no I.B.6 limitation (`issuerUnlimitedOffer`); whether the cap applies is not measured, and is neither $0, constrained nor unlimited. `floatValueBasis: "issuer_stated"`: the issuer's own printed I.B.6 float (`issuerStatedFloat`, prospectus <= 60 days old) was lower than the live valuation and was used. A null remaining capacity is not measured, not zero. Returns HTTP 200 for unavailable data; the `available` and `reason` fields say why. `not_covered` means this company has not been analysed yet, not that it has no dilution; an outage is a 5xx. A null, absent or withheld value means the figure was not measured; it does not mean "no dilution", "no warrants", "no shelf" or zero. A numeric 0 is a measured zero, so availability is carried by the availability, withheld and reason fields, not by the value. Figures are as of `meta.asOfDate`, from filings read through `meta.filingsThrough` (a stale date predates anything filed since). Instrument and summary share counts and per-share prices are rebased onto the current split basis (each instrument row's `basis` gives the factor applied, `presentedBasis` ("as_of_<asOf>"), `splitsApplied` [{effectiveDate, ratio}] (the splits multiplied in) and `asFiled`, the as-filed value of every field that was rebased, so a rebased figure can be audited against the filing). Rebased share counts are rounded to whole shares in the output only; `asFiled` carries the unrounded filed figure. A withheld row has `asFiled: {}` and `splitsApplied: null` (not measured). A row that cannot be rebased is still returned, with its share and price figures null and `basis.withheld: true` plus a reason, and summary totals omit it and count it rather than mix split bases. ATM and equity-line share figures (sold-to-date, sales history) are as reported at the time of each sale, not rebased. Historical series (get_dilution_history, and `osGrowthFacts` with `basis: "as_filed"`) are as filed, not rebased. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with `requiredTier: "pro"` (a tier upgrade; there is no add-on to buy). | read | false | unknown |
| get_cash_history Up to 10 years of quarterly cash and cash equivalents for a company, as reported in its SEC XBRL financial statements (data.sec.gov). Returns `history`: one point per period end {periodEnd, usd, formType, isAnnual}, oldest first. When a 10-K and a 10-Q cover the same date, the annual figure is kept. Works for any company that files XBRL financials with the SEC. Only figures reported in US dollars are included, so a filer that reports in another currency returns an empty history: an empty history means not measured, never zero cash. | read | false | unknown |
| get_cash_position Signal8 cash position model for a company, derived from the dilution snapshot pipeline: anchor cash and anchor date, monthly burn, post-anchor capital raises (with SEC filing citations), known outflows, estimated current cash and runway months. Returns HTTP 200 for unavailable data; the `available` and `reason` fields say why. Coverage is partial: `available: false` with reason `snapshot_not_generated` means this company has not been analysed yet, which is different from it having no cash data and different from an outage (an outage is a 5xx). An unavailable response says nothing about whether the company has cash or runway. The `scenarios` envelope is kept for compatibility but only `scenarios.closed` is populated: `pending` and `announced` are null with reason `scenario_not_modelled`, because the extraction records only realized cash-raising events and does not model speculative raises; shelf or ATM capacity is not a modelled raise. Currency: amounts are in the filer's reporting currency, which is not always USD (Canadian, European, Japanese and Chinese filers report in their own currency). Top-level `currency` is ISO 4217 (null = not determined), and `currencySource: "presumed_usd"` means no foreign-currency marker was found, not a measurement. Every money object is {usd, native: {amount, currency}}: `usd` (and scenarios.closed.estimatedCashUsd / adjustedEstimatedCashUsd / netCapitalRaisesUsd) is null when the block is not in USD, and nothing is converted, so `native.amount` is in `native.currency`, not dollars. monthsOfCashLeft is currency-neutral and stays populated. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with `requiredTier: "pro"` (a tier upgrade; there is no add-on to buy). | read | false | unknown |
| get_cash_runway_calendar Companies projected to run out of cash within a date window, a cash-depletion counterpart to a lockup expiration calendar. Returns companies sorted by urgency (lowest runway first). Runway is an estimate based on the current burn rate; actual depletion depends on future capital raises and operational changes. The default window is today to 90 days out. When the window starts today or earlier it also lists, first, companies whose estimated cash is already exhausted (cash_runway_months null, cashRunwayReason "estimate_would_be_negative", cashRunwayAsOf = the date of the cash figure that was rolled forward): an estimate, not a reported zero balance. | read | false | unknown |
| get_clinical_trials Get the ClinicalTrials.gov trials Signal8 has matched to a company: phase, status, conditions, interventions and key dates. The list includes trials the company leads and trials where it is only a collaborator on another organisation's study. Each trial carries metadata.sponsorRole ("lead", "collaborator", or null = not determined) and metadata.sponsor (the lead sponsor). Only lead trials are the company's own pipeline; a collaborator trial is a trial run by the named lead sponsor that the company collaborates on. `sponsorRole: "lead"` filters to the company's own trials. The response's total, leadTotal and collaboratorTotal count the full list, so a total above the returned count means the list was truncated. Dates of type ESTIMATED are sponsor projections, not facts. | read | false | unknown |
| get_company_profile Get an enriched company profile by ticker symbol, former ticker or SEC CIK. Returns CIK, exchange, sector, industry, market cap, employee count, description, and other fundamental data in a lightweight response. Includes halted/haltCode/haltedAt trading-halt status on every call (false/null when trading normally); a halted-but-listed ticker reports delisted:false. `sharesOutstanding` is dated: `sharesOutstandingAsOf` + `sharesOutstandingAsOfKind` ("stated" = the issuer's statement date; "checked" = when it was last confirmed against a vendor; "none" = date not recorded) and a vendor-free `sharesOutstandingSource`. The count is only meaningful with its date. A null count means not measured; it does not mean zero. `cik: null` is a foreign issuer listed on US OTC that files nothing with the SEC (e.g. PGPHF): name, exchange and country come from reference data and every field Signal8 lacks is null. | read | false | unknown |
| get_compliance Get full compliance rules evaluation for a company: Nasdaq/NYSE deficiency detection, bid price tracking, and delinquent filing detection, combining SEC filing data, market data and exchange rules. Rules cover bid price, equity, reverse-split limit, market value of publicly held shares, publicly held shares, holders, timely periodic filings, annual meeting and audit committee, per exchange tier. Standards that could not be judged from any measurement are listed in `notEvaluated`: they are neither passing nor failing. Neither a `notEvaluated` standard nor the absence of a deficiency notice is evidence of compliance. | read | false | unknown |
| get_dilution_coverage Coverage pre-check for whether Signal8 holds a dilution analysis for a company (a lighter read than the full dilution payloads): coverage status (verified / stale / not_covered), extraction state (never_extracted / running / failed / timeout / complete), last attempt and last success timestamps, the coverage tier, and whether the ticker is out of scope. `outOfScope` is a statement about the product (dilution analysis covers small-cap issuers only) and says nothing about that company's dilution. `stale` means the analysis is real but predates recent filings; `statusDetail` refines it: `newer_filing_unread` (`unreadFilings` names the material filings since: new or amended instrument, 424B5 pricing, split, 10-K) or `delisting_filed` (`delistingFiled` names the Form 25/25-NSE/15). A stale analysis describes the company as it stood before that filing, not as of today. A null `unreadFilings` means not measured, not "nothing filed since". Returns HTTP 200 for unavailable data; the `available` and `reason` fields say why. `not_covered` means this company has not been analysed yet, not that it has no dilution; an outage is a 5xx. A null, absent or withheld value means the figure was not measured; it does not mean "no dilution", "no warrants", "no shelf" or zero. A numeric 0 is a measured zero, so availability is carried by the availability, withheld and reason fields, not by the value. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with `requiredTier: "pro"` (a tier upgrade; there is no add-on to buy). | read | false | unknown |
| get_dilution_history Shares outstanding and cash over time for one company, from its SEC XBRL filings, with the offerings and cash events from its dilution snapshot so each raise can be lined up against the share count and cash around it. Response fields: `sharesOutstanding[]` and `cash[]` (SEC filing data, returned for any company with SEC filings); `fullyDiluted`, `cashEstimate`, `offerings[]` and `cashEvents[]` (from the dilution snapshot, null when the company has not been analysed yet, in which case `offeringMarkers` is "not-covered"); `coverage` (`available`, `unavailableReason`, `status`); and the withheld-row fields. `degraded: true` means an SEC request failed and the series may be incomplete. Each `sharesOutstanding` point is the count as filed, on the split basis in force when it was reported and not rebased to today, so a reverse split shows as a step and a growth rate measured across a split is not meaningful. Each point carries `asOf` (the date the count is stated as of; `periodEnd` is a deprecated alias), `dateKind` ("cover": the cover-page date; "period_end": a balance-sheet date; "stated": a stored count, see below), `filedAt`, `form` (an amendment keeps its "/A"), `accession` and `source`: "sec_xbrl" (the class-less XBRL series), "xbrl_multiclass" (the filing's XBRL instance summed over its common share classes, for issuers that report shares per class), or "stored_count" (the newest count Signal8 holds that the issuer stated as of a date, appended only when newer than every XBRL point and read from a filing not already in the series; it carries that filing's `filedAt`, `form` and `accession`, and `storedSource` names its source). Each filing contributes one point: its cover-page count, or its balance-sheet count when the filing has no cover count. A count Signal8 only confirmed against a market-data figure has no reported date and is not a point. A new 10-Q, 10-K, 20-F or 40-F appears on the next request once SEC's data API lists it, usually within minutes of the filing. A count dated more than about 400 days before its own filing is dropped as a stale recital. `sharesOutstandingCoverage` explains the series: `xbrlReason` is non-null when there is no XBRL point ("sec_unreachable", "no_share_facts_filed", "multiclass_periods_incomplete", "all_facts_before_window" for anything older than `windowStart`, or "all_facts_stale"), and `storedCount` says whether a stored count was appended and if not why. An empty series is not a count of zero. `offerings[]` rows carry `eventDate` (an offering's closing date, else its pricing date, never a filing date; `eventDateKind` says which) and `primarySource` {accession, formType, filingDate, url, sourceKind}, the offering prospectus or current report among the row's citations where one exists (`sourceKind: "later_report"` = only a periodic report cites it). Their `accessionNumber`, `formType` and `filingDate` are deprecated copies of `primarySource`. Offering share counts and prices are on the current split basis; ATM sales and note conversions are as reported. `fullyDiluted` is on the current split basis. A gap in the series means no filing covered that period, not that the count was unchanged. Returns HTTP 200 when the snapshot is unavailable (read `coverage`); 404 only when the ticker maps to no SEC filer. A null, absent or withheld value means the figure was not measured; it does not mean "no dilution", "no warrants", "no shelf" or zero. A numeric 0 is a measured zero, so availability is carried by the availability, withheld and reason fields, not by the value. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with `requiredTier: "pro"` (a tier upgrade; there is no add-on to buy). | read | false | unknown |
| get_dilution_instruments One instrument family's rows with per-field SEC citations (accession number, filing date and the verbatim sentence each figure was read from). Families: warrants, convertibles, preferred, shelfs, atms, elocs, s1_offerings, equity_plans, exchangeables, recent_offerings, rights; each call returns one family. `withheldRows` / `withheldRowCount`: rows that could not be verified were blanked, so every family total is a lower bound. An empty rows array on a covered company is a measured "none found in the filings read"; an unavailable response is not. `disputed` status (warrants / convertibles / preferred / exchangeables): the issuer's latest filing disputes the instrument; it is shown and excluded from totals (`summary.disputedInstrumentCount` / `disputedInstrumentShares`), and it is a disputed claim, neither outstanding nor retired. `contingencyTrigger: "event_of_default"`: the instrument is still outstanding and counted; it converts only on an event of default, which does not make it non-dilutive. Convertibles with `principalBasis` `aggregate_only` / `fair_value_only` / `conflict` / `undisclosed_since_issue`: the current balance is not measured (`principalOutstanding` null), and `principalOriginal` is the original principal, not the current balance. `conversionBasis: "formula_unanchored"`: no share count is computable, so the share count is unquantified, not zero. Convertibles / preferred `sharesIssuableBasis: "conflict_upper_bound"`: `sharesIssuableIfConverted` is an upper bound (up to that many shares) and `sharesIssuableIssuerStated` is the issuer's own count; the higher figure is not the issuer's count. Warrants with null `sharesUnderlying` beside `aggregateExerciseValueDollars` / `exercisePriceFloor` / `sharesCeilingAsFiled` are dollar-denominated or capped: `summary.warrantSharesCeiling` is a ceiling, not a count, and is not in `potentialNewShares`. `warrantCount` counts warrants, not shares. Shelfs: `babyShelfCurrentCapacityDollars` is a stored, dated figure, not today's headroom: it is as of `babyShelfCapacityAsOf` (null = undated, not current), `babyShelfCapacityBasis` names its float, and it is not the live raisable-now computation. Rights (SPAC unit rights): `rightsCount` counts rights, not shares; `sharesPerRight` is the printed fraction of a share per right; `sharesUnderlying` is the share count (null = unsized, not 0), delivered on the initial business combination and lapsing if none closes. A snapshot stored before this family existed returns `examined: false` for rights, meaning not analysed, not "no rights". Sources and dates: rows of recent_offerings, warrants, convertibles, preferred, atms, elocs, shelfs and s1_offerings carry `primarySource` {accession, formType, filingDate, url, sourceKind}, chosen from the row's own citations: offering prospectuses (424B4, 424B1, 424B5, 424B2, 424B7) first, then 8-K / 6-K, then other 424Bs, then registration statements, then periodic reports, earliest filing within a rank (shelfs and s1_offerings rank the registration statement first). `sourceKind: "later_report"` means only a 10-Q / 10-K / 20-F / 40-F cites the row, so its filingDate is when the row was reported, not when the deal was announced. `citations` is unchanged and its first entry is not the primary source. recent_offerings rows also carry `eventDate` (the closing date, else the pricing date, never a filing date) and `eventDateKind` ("closing", "pricing", or null when neither is stated). recent_offerings rows also carry `closingStatus` and `closingSource` {accession, formType, filingDate, url}: `closingSource` is the earliest citation on the row whose quote states, in the past tense, that the deal closed ("closed on", "completed", "consummated"); an "expected to close" sentence never qualifies, so it is not the announcement in `primarySource`. `closingStatus` is "confirmed" (a closingSource exists), "unconfirmed" (the row has a `closingDate` but no citation states a completed closing: the date is the extraction's reading, not corroborated by a cited sentence), "expected" (the only filing statement is forward-looking, so any `closingDate` is an expected date, never a closing) or "not_reported" (no `closingDate`). ATMs: `terminationBasis` is `terminated` (ended on `terminationDate`), `scheduled_end` (the agreement's own end date, `terminationDate`), `no_fixed_end` (runs until sold out or terminated), `not_stated` (the filings read state no end date) or `not_recorded` (extracted before this field existed, not "no end"); `terminationDate` is null unless a date was stated. A salesHistory point with `cumulativeSharesSoldStatus: "not_stated"` carries `cumulativeSharesSold: 0` as a placeholder, not a measured zero. Returns HTTP 200 for unavailable data; the `available` and `reason` fields say why. `not_covered` means this company has not been analysed yet, not that it has no dilution; an outage is a 5xx. A null, absent or withheld value means the figure was not measured; it does not mean "no dilution", "no warrants", "no shelf" or zero. A numeric 0 is a measured zero, so availability is carried by the availability, withheld and reason fields, not by the value. Figures are as of `meta.asOfDate`, from filings read through `meta.filingsThrough` (a stale date predates anything filed since). Instrument and summary share counts and per-share prices are rebased onto the current split basis (each instrument row's `basis` gives the factor applied, `presentedBasis` ("as_of_<asOf>"), `splitsApplied` [{effectiveDate, ratio}] (the splits multiplied in) and `asFiled`, the as-filed value of every field that was rebased, so a rebased figure can be audited against the filing). Rebased share counts are rounded to whole shares in the output only; `asFiled` carries the unrounded filed figure. A withheld row has `asFiled: {}` and `splitsApplied: null` (not measured). A row that cannot be rebased is still returned, with its share and price figures null and `basis.withheld: true` plus a reason, and summary totals omit it and count it rather than mix split bases. ATM and equity-line share figures (sold-to-date, sales history) are as reported at the time of each sale, not rebased. Historical series (get_dilution_history, and `osGrowthFacts` with `basis: "as_filed"`) are as filed, not rebased. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with `requiredTier: "pro"` (a tier upgrade; there is no add-on to buy). | read | false | unknown |
| get_dilution_performance Post-offering price performance: for each recorded offering, how the stock traded after it priced or closed, i.e. how the market absorbed this issuer's past financings. This is history, not a forecast: it describes what happened after prior offerings and is not an expectation, a price target or a prediction about the company. An empty or unavailable series means no offering performance was measured, not that offerings had no effect and not that there were no offerings. Returns HTTP 200 for unavailable data; the `available` and `reason` fields say why. `not_covered` means this company has not been analysed yet, not that it has no dilution; an outage is a 5xx. A null, absent or withheld value means the figure was not measured; it does not mean "no dilution", "no warrants", "no shelf" or zero. A numeric 0 is a measured zero, so availability is carried by the availability, withheld and reason fields, not by the value. Figures are as of `meta.asOfDate`, from filings read through `meta.filingsThrough` (a stale date predates anything filed since). Instrument and summary share counts and per-share prices are rebased onto the current split basis (each instrument row's `basis` gives the factor applied, `presentedBasis` ("as_of_<asOf>"), `splitsApplied` [{effectiveDate, ratio}] (the splits multiplied in) and `asFiled`, the as-filed value of every field that was rebased, so a rebased figure can be audited against the filing). Rebased share counts are rounded to whole shares in the output only; `asFiled` carries the unrounded filed figure. A withheld row has `asFiled: {}` and `splitsApplied: null` (not measured). A row that cannot be rebased is still returned, with its share and price figures null and `basis.withheld: true` plus a reason, and summary totals omit it and count it rather than mix split bases. ATM and equity-line share figures (sold-to-date, sales history) are as reported at the time of each sale, not rebased. Historical series (get_dilution_history, and `osGrowthFacts` with `basis: "as_filed"`) are as filed, not rebased. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with `requiredTier: "pro"` (a tier upgrade; there is no add-on to buy). | read | false | unknown |
| get_dilution_risk Dilution pressure score: 0-100 with a seven-component breakdown (shelf capacity, ATM/equity-line capacity, warrants in the money, convertible proximity, cash burn urgency, historical dilution, toxic financing), plus four risk levels: overall, offering ability, overhead supply, cash need. Score: components whose inputs could not be measured are dropped from the denominator, so `score` is out of `scoreMaxMeasured`, not out of 100 (58 may be 58 out of 85), and `scoreUnmeasuredComponents` names the excluded components. A low numerator over a reduced denominator is not a low-risk reading. `scoreDenominatorThin: true` (under 70 measured points) marks a partial reading (N of M measured). A non-null `scoreWithheldReason` (e.g. `no_dilution_snapshot`) means there is no score, not a score of zero. With no filed share count, the share-count and market-cap components rest on `details.sharesOutstandingEstimate` {shares, kind, asOf, source}, and `details.marketCapSource` is `"derived_price_x_estimated_os"`: those components rest on an estimate. Levels: when `levelsAreLowerBound` (always present) is true, the levels named in `levelsLowerBoundScope` are a lower bound (floors), not measurements: "medium" means at least medium. Levels outside that scope are measured. `levelsLowerBoundReason` determines which levels are floored: `unquantified_live_instruments` floors overall and overheadSupply; `offering_capacity_unknown` and `market_cap_unmeasured` floor overall and offeringAbility, not `overheadSupply`; `os_growth_span_short`, `os_growth_issuance_floor` and `os_growth_rebased_partial` floor historical and overall; `overhead_capacity_unquantified` floors overheadSupply and overall. `details.levelBounds` per level: `floor` (unsized instruments at zero), `ceiling` (at filed maximum; null when some instrument has none), `exact`, `bestEstimate`, `estimated`, `estimateBasis`. An estimated level is a best estimate between its floor and ceiling, not a measurement. A null `overall` with a non-null `levelsWithheldReason` is withheld, not low. `offeringAbility` is a capability profile, not pressure today: a live ATM or equity line with a measured $0 drawable (e.g. clamped by the I.B.6 cap) reads medium while the score prices the $0, and it does not mean the company cannot raise. `atmRemainingBasis` / `elocRemainingBasis` values `total_minus_reported_sales` and `total_no_sales_reported` mark "up to" figures. `overheadSupply` is potential dilution excluding shelf as a % of shares outstanding: warrants, convertibles and preferred at gross counts, plus live ATM remaining (baby-shelf clamped) and equity-line remaining at the current price, plus live S-1 shares, plus `details.registeredResaleOverhangShares`. Low up to 20%, Medium 20-50%, High over 50%. `details.overheadSupplyBasis` itemises the components (null = not measured) and `unquantified`; it is not the treasury-netted `inTheMoneySupplyPct` / `totalDilutiveShares`. When `details.osGrowthRate` is null, `details.osGrowthFacts` {fromShares, fromDate, toShares, toDate, splitsInWindow, basis} is a fact, not a rating; with `basis: "as_filed"` the two counts are on different split bases and are not a growth comparison. Returns HTTP 200 for unavailable data; the `available` and `reason` fields say why. `not_covered` means this company has not been analysed yet, not that it has no dilution; an outage is a 5xx. A null, absent or withheld value means the figure was not measured; it does not mean "no dilution", "no warrants", "no shelf" or zero. A numeric 0 is a measured zero, so availability is carried by the availability, withheld and reason fields, not by the value. Figures are as of `meta.asOfDate`, from filings read through `meta.filingsThrough` (a stale date predates anything filed since). Instrument and summary share counts and per-share prices are rebased onto the current split basis (each instrument row's `basis` gives the factor applied, `presentedBasis` ("as_of_<asOf>"), `splitsApplied` [{effectiveDate, ratio}] (the splits multiplied in) and `asFiled`, the as-filed value of every field that was rebased, so a rebased figure can be audited against the filing). Rebased share counts are rounded to whole shares in the output only; `asFiled` carries the unrounded filed figure. A withheld row has `asFiled: {}` and `splitsApplied: null` (not measured). A row that cannot be rebased is still returned, with its share and price figures null and `basis.withheld: true` plus a reason, and summary totals omit it and count it rather than mix split bases. ATM and equity-line share figures (sold-to-date, sales history) are as reported at the time of each sale, not rebased. Historical series (get_dilution_history, and `osGrowthFacts` with `basis: "as_filed"`) are as filed, not rebased. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with `requiredTier: "pro"` (a tier upgrade; there is no add-on to buy). | read | false | unknown |
| get_dilution_snapshot Dilution snapshot header (the largest dilution payload): summary totals (potential new shares, their % of shares outstanding, per-family totals), the cash position (anchor cash, monthly burn, estimated current cash, runway months), the float block, and `meta` provenance. Instrument rows are not included. Cash is in the filer's reporting currency: `cashPosition.currency` is ISO 4217 (null = not determined), and `cashPosition.currencySource: "presumed_usd"` is a presumption, not a measurement. Runway months are currency-neutral. Float: a non-null `floatWithheldReason` means the tradeable float was not measured, and no float figure is stated. A declined float block (`available: false`) may carry `refusal.withheldReason`, the same value the standalone float data serves. `float.otherShareClasses[]` (present on both a published and a declined float block; null = not measured, [] = none stated) lists each other class of common equity: `sharesAsStated` (the filed count), `asOf`, `basis` ("as_stated" = no split since, "rebased" = `sharesCurrent` is the count moved onto today's basis by `splitsApplied`, "pre_split_statement" = a later split exists and the count was not moved, so `sharesCurrent` is null and the count is only what the filing stated on `asOf`, "not_stated"), `splitsSinceAsOf` and `source` {accession, formType, filingDate}. A pre_split_statement is not a current share count. `tradeableFloatCeiling` is an upper bound, not a float: the float is at most that figure, and the ceiling is not an input to a market capitalisation, percent-of-float, short-interest ratio or comparison. Bounded totals: a null total (`potentialNewShares`, `totalWarrantShares`, `totalConvertibleShares`, `totalEquityPlanShares`, `totalExchangeableShares`, `totalRightsShares`, `potentialDilutionPercent`) may sit beside `<key>Bound: "ceiling"`, `<key>Ceiling` and `<key>Floor`: the total is at most the ceiling, the floor is the measured part, and the ceiling is not the total. With `potentialDilutionPercentBoundReason: "stated_count_denominator"` there is no floor: the ceiling divides by the last stated share count (as of `potentialDilutionPercentCeilingShareCountAsOf`), so the figure is at most that percentage against the count stated as of that date. Approximate totals: `<total>Approximate: true` (e.g. `potentialNewSharesApproximate`, `potentialDilutionPercentApproximate`, `totalWarrantSharesApproximate`) means that total includes an issuer-stated approximate count ("approximately 16.1 million shares"): state it as approximately / ≈ that figure, never as exact. `statedCountSizedRows[]` lists every row sized from its own cited filing text (rule, shares, approximate, quote, accession). `notMeasuredReasons[]` ({field, code, text, detail, expected {form, dueDate, status}}) gives the reason a figure is null; it is an explanation, not a value. `expectedFilings[]` lists the next periodic report(s): `status: "late"` means due by `dueDate` with none on file as of `checkedOn` and carries no information about why; `dueDate: null` means not computed. A `kind: "annual_meeting"` row (Nasdaq 5620(a) / NYSE 302.00) with status "late" means no 8-K Item 5.07 vote results are on file, not that a meeting was missed. SPAC rights: `totalRightsShares` (present only when the snapshot examined rights) is the shares delivered to holders of SPAC unit rights on the initial business combination; it is included in `potentialNewShares`, and the rights lapse if no combination closes. `rightsOverlapWarrantRows` > 0 means a warrant row also names rights, so the rights total and the headline are withheld (null) rather than counted twice. A runway figure beside `goingConcern: true` is a contradiction the auditors flagged: the going-concern doubt qualifies the runway. Returns HTTP 200 for unavailable data; the `available` and `reason` fields say why. `not_covered` means this company has not been analysed yet, not that it has no dilution; an outage is a 5xx. A null, absent or withheld value means the figure was not measured; it does not mean "no dilution", "no warrants", "no shelf" or zero. A numeric 0 is a measured zero, so availability is carried by the availability, withheld and reason fields, not by the value. Figures are as of `meta.asOfDate`, from filings read through `meta.filingsThrough` (a stale date predates anything filed since). Instrument and summary share counts and per-share prices are rebased onto the current split basis (each instrument row's `basis` gives the factor applied, `presentedBasis` ("as_of_<asOf>"), `splitsApplied` [{effectiveDate, ratio}] (the splits multiplied in) and `asFiled`, the as-filed value of every field that was rebased, so a rebased figure can be audited against the filing). Rebased share counts are rounded to whole shares in the output only; `asFiled` carries the unrounded filed figure. A withheld row has `asFiled: {}` and `splitsApplied: null` (not measured). A row that cannot be rebased is still returned, with its share and price figures null and `basis.withheld: true` plus a reason, and summary totals omit it and count it rather than mix split bases. ATM and equity-line share figures (sold-to-date, sales history) are as reported at the time of each sale, not rebased. Historical series (get_dilution_history, and `osGrowthFacts` with `basis: "as_filed"`) are as filed, not rebased. Included in Signal8 Pro: without it the call returns 403 FEATURE_NOT_AVAILABLE with `requiredTier: "pro"` (a tier upgrade; there is no add-on to buy). | read | false | unknown |
| get_donor_aggregates Get market-wide campaign-finance rollups across every tracked politician for a cycle: total raised, top 10 individual donors, top 10 PACs, party/chamber/cycle splits, and a most-funded politician leaderboard. Answers questions like "who are the biggest donors in 2024?" or "which party raised more?". | read | false | unknown |
| get_earnings Get historical earnings data for a company: EPS actual vs estimate, revenue actual vs estimate, and surprise percentages (beats and misses). | read | false | unknown |
| get_earnings_calendar 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. | read | false | unknown |
| get_economic_calendar 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. One call covers at most 366 days: a longer window is shortened to that span and the response says so in windowClamped. | read | false | unknown |
| get_ended_reverse_splits Reverse-split episodes across companies that ended without the split taking effect, from Signal8's SEC-filing tracker: outcome "vote_failed" (shareholders did not approve), "abandoned" (the company said it will not proceed), "authority_expired" (an approval lapsed unused past its stated deadline) or "postponed_indefinitely". Splits that did happen are not in this list, and it is cross-company rather than one company's full history. Newest end first. Each row is the Reverse Splits page row (ticker, companyName, hasPage, ratio / ratioMin / ratioMax, trackerState, meetingDate, approvedDate, exchange, securityType, marketCapUsd, cik, approvalPath, domicile, splitAuthority, authorityTerms, verification) plus sourceUrl / sourceAccession and sourceDocuments (every document behind the episode, each with accession or URL) and an "ended" block: outcome, outcomeLabel, endedOn, endedOnBasis, closedReason (the tracker's own note, verbatim), voteDate, closingAccession / closingUrl (the filing that closed it, when one did). endedOnBasis says what endedOn is: "vote_date" or "meeting_date" = the vote as stated; "authority_expiry" = the stated last day of the authority; "closing_filing" = the ET day of the filing that closed it; "recorded" = none of those, the day the tracker recorded the close, which can be later than the event. Null means not measured or not stated. An empty list is what the tracker has on file for the window, not evidence that no company abandoned a split; completeness "tracked_episodes" = what the tracker has read from filings since it started, not every company. boundReached: true = the window held more episodes than one read returns (a narrower from / to window returns the rest). Locked rows are withheld, not absent. The facts are part of Signal8 Pro: a key not owned by a Pro account gets rows with locked: true and only ticker, companyName, hasPage and exchange (access "preview", lockedCount); a locked row means the facts were withheld from this caller. outcome, from and to are Pro-only filters: on a non-Pro key they apply to unlocked rows only and locked rows are left out (filtersLimitedToUnlocked: true). exchange applies to every row. Paging uses limit and the nextCursor of the previous response (null = last page). available: false (reason "tracker_not_enabled") = the tracker is switched off; an HTTP 503 FEATURE_DISABLED = the Reverse Splits page is switched off. In both cases the response says nothing about any company. The data describes what is on file and carries no view on the company, its price, or what anyone should do. | read | false | unknown |
| get_etf_bundle 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). | read | false | unknown |
| get_executives Get the key executives and officers of a company: name, title, compensation and tenure. | read | false | unknown |
| get_exhibit_content Get the full text/HTML content of a single exhibit from an SEC filing, by exhibit id. Returns the exhibit text along with exhibit_type, description, company_name, accession_number, and form_type. maxLength truncates large exhibits. Exhibit ids appear as `exhibitId` in a filing's document list, as `id` in a filing's exhibit list, and as `exhibit_id` on full-text search matches. | read | false | unknown |
| get_filing_calendar 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). | read | false | unknown |
| get_filing_document Get the full raw text/HTML content of an SEC filing by its internal filing ID (the `id` on filing search rows, or `filingId` from an accession-number lookup or a filing's document list). Returns the complete filing document, which can be very large (10-K filings can be 1MB+); maxLength truncates content for previews. The response includes company_name, form_type, filing_date, cik, and accession_number alongside the content. Record-only filings (bodyStored: false) have no body here; the document is on sec.gov. Content is the whole submission as filed. Coverage: Signal8's SEC EDGAR archive, updated through the day, in its held range (see `archiveFrom` in each response; currently from late 2021, expanding back to 2016 as the history backfill fills in). Before archiveFrom it holds only a scatter, so absence before archiveFrom is not evidence a filing was never filed; SEC EDGAR itself covers earlier periods. Record-only rows (bodyStored: false) have no stored body; the document is at its sec.gov URL. | read | false | unknown |
| get_filing_documents List every document in one SEC filing by accession number (the primary document, each exhibit, XML and XBRL files, graphics) with seq, type (e.g. "8-K", "EX-99.1"), description, size in bytes, `stored` and `secUrl`. Also returns the filing's cik, companyName, formType, filingDate, acceptedAt, bodyStored, primaryDocument, indexUrl, and `filingId`. A document with an `exhibitId` has readable stored text under that exhibit id; `filingId` identifies the whole submission text. `exhibitId: null` means the document has no readable text row here (XML/XBRL/graphics, or text not held); its `secUrl` still opens it. When `readableIdsResolved` is false the id lookup failed and exhibitId is omitted (unknown, not "none"). `stored: false` means Signal8 holds the filing record but not that document's body; it exists on EDGAR at `secUrl`. A filing not held in the archive returns a not-found error; its documents are still on EDGAR. Coverage: Signal8's SEC EDGAR archive, updated through the day, in its held range (see `archiveFrom` in each response; currently from late 2021, expanding back to 2016 as the history backfill fills in). Before archiveFrom it holds only a scatter, so absence before archiveFrom is not evidence a filing was never filed; SEC EDGAR itself covers earlier periods. Record-only rows (bodyStored: false) have no stored body; the document is at its sec.gov URL. | read | false | unknown |
| get_filing_exhibits List the readable exhibits (individual documents with stored text) within an SEC filing, by internal filing ID. Returns each exhibit's `id` (the exhibit id for reading that exhibit's text), exhibit type, description, content size and sec_url. Excludes XML/XBRL and documents with no stored text. | read | false | unknown |
| get_filing_structured Parsed, machine-readable data from an ownership or holdings filing, by accession number. `kind`: "ownership" (Form 3/4/5 and amendments): issuer, reporting owners with relationship (director, officer title, 10% owner, or the filer's own "Other" text) and `parsed.transactions` (per transaction: table nonDerivative/derivative, securityTitle, transactionDate, code, acquiredDisposed A/D, shares, pricePerShare, sharesOwnedAfter, ownership D/I; derivatives add exercisePrice, exerciseDate, expirationDate, underlyingTitle, underlyingShares); "thirteen_f" (13F-HR): period, holdings with cusip, issuer, shares/principal, put/call, discretion and voting; "schedule13" (XML SCHEDULE 13D/G, 2025 onward): reporting persons, percent of class, items. 13F VALUES: `valueThousands` is the raw filed number, whose unit changed from thousands to whole dollars for filings on/after 2023-01-03; `valueUsd` / `totalMarketValueUsd` are normalised to dollars (null when the unit cannot be determined) and `valueUnit` names the unit. Holdings are capped at holdingsLimit (default 200); `holdingsTotal` is the full count, `holdingsTruncated` says whether rows were cut. A null value means not stated in the filing; it does not mean zero (a gift with no price has pricePerShare null; `directShares` is null on a derivative-only Form 4). `parsed.transactions` absent (not empty) means the table could not be read; totals still apply. `parsed: null` on a 13F means no information table (e.g. 13F-NT), not zero holdings. Unsupported forms, pre-2025 Schedule 13D/G and filings not in the archive return a not-found error with `details.reason`; their raw text remains readable as a filing document. Coverage: Signal8's SEC EDGAR archive, updated through the day, in its held range (see `archiveFrom` in each response; currently from late 2021, expanding back to 2016 as the history backfill fills in). Before archiveFrom it holds only a scatter, so absence before archiveFrom is not evidence a filing was never filed; SEC EDGAR itself covers earlier periods. Record-only rows (bodyStored: false) have no stored body; the document is at its sec.gov URL. | read | false | unknown |
| get_financials Get income statement, balance sheet and cash flow data for a company (revenue, profitability, debt, cash position) from SEC XBRL filings. The response carries BOTH the annual and the quarterly series (no separate trailing-twelve-month series: sum the last four quarters for TTM flow figures). HTTP 404 "Company not found" / "No SEC XBRL financials" means the issuer has no SEC XBRL financials in Signal8 (e.g. a foreign OTC issuer that files nothing with the SEC): a coverage gap, not a bad call. costOfRevenueBasis states what costOfRevenue measures: "excludes_depreciation_amortization" when the filer tags only a cost line without depreciation and amortization, so a margin from it is on that basis. grossProfit and grossMargin are null when not measured (no GrossProfit tag and no cost-of-revenue tag, as at banks and most REITs); a null margin is not a 100% margin. grossProfitSource is "reported" or "revenue_minus_cost". | read | false | unknown |
| get_float Get float data for a company: floatShares, floatDefinition, the as-of date and, when the headline float is withheld, the bounds and labelled stand-ins that replace it. Null, absent or withheld means not measured; it does not mean "no float", "no restricted shares" or zero. A numeric 0 is a measured zero, so the reason and marker fields ("floatWithheldReason", "restrictedBlockCount", "provenance", "direction") carry the verdict, not the value alone. The share count the float was judged against ("basisSharesOutstanding") is dated by "sharesOutstandingAsOf" and "sharesOutstandingAsOfKind" ("stated", "checked", or "none" = date not recorded) and "sharesOutstandingSource". "floatDefinition": "tradeable" (shares outstanding minus affiliates minus restricted/unregistered blocks; filing-derived snapshot tickers), "non_affiliate" (the SEC I.B.6 figure, which includes restricted shares held by non-affiliates and is not a trader's float), "non_affiliate_estimate" (from ownership filings), "free_float" (vendor). "floatDefinition" and "source" appear only on snapshot results; an absent floatDefinition means the figure is not a filing-derived tradeable float. "nonAffiliateFloatShares" (snapshot tickers) is the input that baby-shelf / I.B.6 math rests on; it is not tradeable supply, and the tradeable float is not an I.B.6 input. Precedence: when the snapshot carries any figure ("floatEstimate", "tradeableFloatCeiling", an "affiliateBasis" range), "floatShares" stays null and that figure is the answer. A lower tier fills "floatShares" (its own "source" and definition, with "snapshotFloatWithheldReason" as provenance context, not a second refusal) only when the snapshot has no figure, or its only figure is a trivial ceiling (at or above 99% of the share count), which is stripped. Floors, points, every "shares_outstanding_ceiling" and an "affiliate_sizing_estimate" (with its "reason" and "unsizedAffiliates") are kept. A lower tier that also answered appears as "otherSourceFloat" {floatShares, source, provenance:"other_source", floatDefinition, asOfDate}: a secondary other-source figure, not the float and not an input to arithmetic. A lower-tier figure that predates a split the snapshot names, predates recorded issuances of 10% or more of it, or falls outside the snapshot's bounds is refused: "fallbackRefusal" {reason, refusedSource, detail}. "floatShares" null with "floatWithheldReason" set and no lower-tier figure means no source could answer. A point (bound "point", or a "floatEstimate" with "statedAsOf" {asOf, source, events[]}) is a plain number as of asOf, with the unsized later issuances in "statedAsOf.events" as its caveat. A ceiling, floor or range is not a float figure: it means the filings put the float at most or at least N. Stand-ins on a withheld result are not floats and are not inputs to a market cap, percent-of-float, short-interest ratio, screen, sort or comparison. (1) "tradeableFloatCeiling": the tradeable float is at most this (null = no bound, not 0). (2) "affiliateBasis.floatLowerBound" / "floatUpperBound": a range for the non-affiliate float (still including non-affiliate restricted shares); each end is null independently; on a published float it is context only. (3) "floatEstimate" {shares, basis, direction, confidence, rung, bound, asOf, reason, qualifier, offBasis, statedAsOf, staleness}: "basis" says what it rests on; "direction" "overstates" = the true float is at most shares, "understates" = at least, "unknown"; "rung" names the ladder step; rung "best_estimate" is the most likely figure when every filing rung withheld ("basisKind" = what it rests on, "assumptions" = how each unsized holder was treated), an estimate and not a measurement; "qualifier" is the caveat that belongs with the figure. "offBasis": "pre_split_as_filed" (as of asOf, before "splitsAfter" [{ratio, effectiveDate, status}]), "ordinary_shares_unconverted" (ordinary shares, not ADSs), "count_predates_issuances" (dated cover count "countSource", later issuances uncounted); an offBasis figure is accurate only with its label and is not comparable with a price, market cap, another float or a threshold. "staleness" flags a point older than 12 months or post-dated by a known issuance. An estimate never becomes floatShares. Unrelated to the boolean "floatEstimated" (a published floatShares back-derived from a USD public-float disclosure). (4) "vendorFallback" {floatShares, provenance:"vendor", floatDefinition:"free_float", asOfDate, splitAdjusted}: a third-party free float as of its date, not Signal8's float. "restrictedShares" null means not measured (a block exists whose size the filings leave unstated), not zero; "restrictedBlockCount" 0 is a measured answer. "affiliateBasisStale" (basisSpanDays, affiliateAnchorDate) labels an affiliate table materially older than the share count. "tradeableBasis": "convention_conservative" means a published convention resolved the figure (see "tradeableConvention"), so it is not exact. "otherShareClasses" (null = not measured, [] = none stated) lists each other class of common equity the issuer's filings state: {designation, listing, sharesAsStated, asOf, basis, sharesCurrent, rebased, splitsSinceAsOf, splitsApplied, basisRefusal, source}. "basis" "as_stated": no split since asOf; "rebased": "sharesCurrent" is the filed count moved onto today's split basis by "splitsApplied"; "pre_split_statement": a later split exists and the count was not moved ("sharesCurrent" null), so "sharesAsStated" is only what the filing stated on "asOf" and is not a current count; "not_stated": no positive count. The classes publish even when the float itself is withheld. Dates: "asOfDate" is YYYY-MM-DD or null and "asOfDateKind" says what it is ("newest_filing_read", "stated_measurement_date", "public_float_measurement_date", "prospectus_filing_date", "ownership_table_filing_date" with the form in "asOfDateForm", "newest_ownership_filing", "vendor_effective_date"; with no date: "not_stated" or "not_recorded"; "no_figure"). A third-party figure with no stated date carries "retrievedOn", the day it was last fetched, which is not an as-of date. "nonAffiliateFloatShares" is dated by "nonAffiliateFloatAsOf"; "floatEstimate", "vendorFallback" and "otherSourceFloat" carry their own "asOfDateKind". Units: "listedSecurity" ("ads" or "shares") is what trades under the ticker; "floatUnit" ("ads", "shares", or null with "floatUnitReason") is what the headline figures count; "adsRatio" is ordinary shares per ADS as the issuer's filings state it (null with "adsRatioReason" when not established). A null unit means not established, never either unit: a third-party or ownership-derived float on an ADS listing is null. "otherSourceFloat" and "vendorFallback" carry their own "unit". | read | false | unknown |
| get_float_history Get a company's float on past dates. Two series, chosen with "basis". "daily" (default): one sample per trade date (float shares, shares outstanding, and the source the float came from), recorded going forward since mid-2026 and not backfilled, so early or absent history is expected and an empty rows array is a normal result. Each row carries "source" ("computed", "sec_10k" or a market-data vendor tier) because float quality varies. "filings": a float history rebuilt from SEC filings back to 2023, one point per filing date: shares outstanding minus shares held by affiliates (officers and directors, holders filing Schedule 13D, and 10%+ holders with no passive Schedule 13G; passive 13G holders stay in the float). Each point is the float as of its own date, on that date's split basis (not adjusted for later splits). Every point carries "calc" (the subtraction, line by line) and "sources" (the filings it is built from, with verbatim quotes and links). "source" is "ownership_table" (a proxy or 10-K ownership table), "snapshot" (a dated dilution analysis) or "rolled" (a later quarterly share count, minus the last table's holdings adjusted for insider Form 4 trades and Schedule 13D changes). A point with floatLow/floatHigh and no floatShares is a range whose two bounds are the measurement; it has no midpoint value. "flags" state the assumptions behind a point (for example affiliated holders carried at their last table level). A date with no point was not measured, which is not a float of zero or an unchanged float. | read | false | unknown |
| get_historical_prices Get historical OHLCV price candles for a stock at daily, weekly or monthly resolution, for a period shorthand (1M, 3M, 6M, 1Y, 5Y or the full history) or an explicit from/to UNIX timestamp window. The default is one year of daily candles. | read | false | unknown |
| get_insider_cluster_buys Detect cluster buying for a company: periods where 3+ distinct insiders bought shares (Form 4 open-market purchases, code P) within a 14-day window, over a lookback of 7, 30 or 90 days (default 90). Returns clusterBuyingDetected, the strongest clusterWindow, a summary (totalValue is null when no purchase disclosed a price, and is a floor when unpricedPurchaseCount > 0) and the deduped purchases. `asOf` and `lookback` state the date range covered; clusterBuyingDetected false means none in that range only. | read | false | unknown |
| get_insider_cross_company Discover insider trading patterns across multiple companies (the whole universe, not a single ticker): insiders active across multiple companies, cluster buying patterns, and large transactions. Optional filters: insider name, transaction type, or date range. Cluster buying is computed only for purchases (transactionType P, the default). Useful for detecting coordinated insider activity, cross-company insider networks, and market-wide buying/selling trends. | read | false | unknown |
| get_insider_positions 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. | read | false | unknown |
| get_insider_positions_by_ticker Get per-insider position aggregates for a ticker: which insiders hold positions in the stock and their aggregate cost and value, derived from Form 4 filings. The figures are not lifetime totals: they cover only the Form 4 history Signal8 holds, which starts at the response's `coverageStart` date (repeated on each row), so every figure is "since coverageStart". Each row carries `costBasisStatus`: `complete` (every share the history knows was bought inside coverage), `partial` (the holding predates coverage, so `weightedAvgCost` averages only in-coverage priced buys and is not the cost of the position), or `unknown` (the first in-coverage event was a sale, or there was no priced buy; `weightedAvgCost` and `costBasisTotal` are null, which means not measured, not zero cost). | read | false | unknown |
| get_insider_transactions 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. Optional year/month and transactionCode filters (purchases P, sales S, etc.) narrow results. Each row's sharesOwnedFollowing is the holding on that row's ownership line only (securityTitle + directOrIndirect + natureOfOwnership), not the insider's total position; insiders often report several lines, so one row is not a basis for a "% of position" figure. holdingsByInsider lists every line with its as-of filing; its sumOfReportedLines is not beneficial ownership (lines can be stale). A trade re-reported in a later filing is listed once. plan10b5_1Box is the filing's Rule 10b5-1(c) checkbox as filed (true/false). null means Signal8 has not yet read the box for that filing, which is neither "no plan" nor unknowable: a Form 4 filed since April 2023 prints the box on the form itself, readable from the filing document by its accession. footnoteMentions10b5_1 says a footnote or remark mentions Rule 10b5-1 (a mention, not a mark). | read | false | unknown |
| get_insiders 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. | read | false | unknown |
| get_institution_activity Get an institution's position changes over recent 13F periods by CIK. Reads the number of trailing periods to include. | read | false | unknown |
| get_institution_derivatives Get an institution's reported put/call derivative positions by CIK (13F options), with pagination and sorting. | read | false | unknown |
| get_institution_detail 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. Takes the institution's CIK. | read | false | unknown |
| get_institution_filings Get the list of 13F filings for an institution by CIK, with pagination. | read | false | unknown |
| get_institution_holdings 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. | read | false | unknown |
| get_institution_portfolio_analytics Get sector allocation and top holdings analytics for an institution's portfolio by CIK. | read | false | unknown |
| get_institution_position_changes 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. The diff is computed server-side in a single query. | read | false | unknown |
| get_institution_top_aum Discover top institutional holders across the entire company universe ranked by assets under management (AUM), across all companies rather than for a single company. Optionally set a minimum AUM. Useful for identifying smart money flows and major institutional positioning trends. | read | false | unknown |
| get_institutions 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. | read | false | unknown |
| get_institutions_leaderboards 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. Each section is capped by `limit`; it is not the full paginated AUM list. | read | false | unknown |
| get_intraday_bars Get intraday OHLCV candles at 1, 5, 15, 30 or 60-minute resolution for intraday price action, volume patterns and short-term technical analysis. Each bar has open, high, low, close and volume. `extended: true` includes premarket (04:00 to 09:30 ET) and after-hours (16:00 to 20:00 ET) bars. | read | false | unknown |
| get_ipo_lockup IPO lock-up terms read from the company's own final prospectus (Form 424B4 or 424B1): for each bound party ("holders", "directors_officers", "company" for the issuer's own covenant not to issue, "underwriter_warrants") and tier (for example "gt5pct" holders of more than 5%), the stated length and unit, and every anchor the prospectus states ("prospectus_date", "closing_date", "trading_start", "offering_date", "pricing_date", "effective_date"), each with its verbatim quote, character offset, computed expiry date (calendar months, never 30-day blocks) and the first trading session on or after it. When the prospectus states anchors that give different dates, all are returned and "anchorConflict" is true. Also: shares the locked holders hold where stated, the pre-IPO holders' average price per share and share count from the prospectus Dilution table ("preIpo"), the IPO price, early-release clauses found in the prospectus ("earlyReleaseTerms"), 8-K waiver or release language seen ("waiverEvents"), and the current price and float ("market"). An empty "waiverEvents" means no release was seen in 8-K filings; small issuers can release holders without public notice, so it does not mean no release occurred. "available": false with reason "not_found" means no IPO prospectus of this company has been read; it does not mean the company has no lock-up. A null value means not stated or not measured; lengths are never defaulted. "extraction.method" is "llm" or "regex". | read | false | unknown |
| get_learn_guide Free: works without an API key or Pro plan (the hosted server only needs a signed-in account). One Signal8 Academy guide as Markdown, by track and slug (as returned by the Academy search, or from a signal8.ai/learn/<track>/<slug> URL). Returns title, description, section, lastVerified, the public url, the full Markdown body (links already rewritten to absolute signal8.ai URLs), the related guides, the glossary terms it uses (with one-line definitions) and its SEC sources (accession numbers). Guides use hypothetical examples ("Company X") unless a source is cited; they are education, not advice about any named company, and each guide's url is its citable source. | read | false | unknown |
| get_legislative_calendar 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, billKey (the "<congress>-<type>-<number>" bill id), and tweet/plain summaries. An empty calendar is a normal state: nothing market-relevant is scheduled in the window, not an error. Defaults: from=today, to=+14 days, minRelevance=low. affectedTickers contains verified rows only: every ticker carries a verbatim evidenceQuote substring-verified against the actual bill text. sponsorTradeFacts are restatements of public STOCK Act disclosures with verbatim amount brackets and both transactionDate and disclosureDate (disclosures lag trades by up to 45 days); a fact is a disclosure on record, not evidence of wrongdoing. Vote windows are predictions: window.provenance is the trust level ('uc_explicit' is exact; 'rule_xxii_computed' is a medium-confidence estimate) and window.granularity is how precise the window is (exact time vs day vs week). | read | false | unknown |
| get_live_rvol Get a ticker's relative volume (RVOL) right now, EXACTLY as the Signal8 company page and Terminal show it (same data, same rule). Use this for "what is $X's RVOL today / right now"; get_rvol_history only covers completed sessions and never has today. "session" is pre-market, open, after-hours or closed. "shown" is the one VOL + RVOL on screen now: in pre-market the time-of-day RVOL ("RVOL·TOD") when measured, else the full-session one; from the open, today's volume / the 30-day average daily volume ("RVOL·D"). "displayed" lists the RVOL cells the Terminal draws, in order: pre-market RVOL·TOD then RVOL·D, from the open RVOL·D only. "premarket" (today's 04:00-09:30) has "rvolTimeOfDay" (vs the average traded by this time of morning, with its 15-minute "cutoff"), "rvolFullSession" (vs the average FULL pre-market), "avgVolumeByNow" and "avgFullSessionVolume". "day" has "volume", "rvol" (RVOL·D, null before the open) and "avgVolume30d". Every RVOL carries its "label" and a "note" naming its denominator; RVOL·TOD and RVOL·D differ by orders of magnitude early in the morning and are not interchangeable. "found": false means no live row for the ticker. Null means NOT MEASURED, never zero volume. | read | false | unknown |
| get_market_breadth 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): a snapshot of overall market state. | read | false | unknown |
| get_market_metrics Get computed market metrics for a company: volume averages, volatility, simple moving averages, RSI(14) on split-adjusted daily closes (rsi14, with the session it is as of in rsi14AsOf; null = not measured) and trend direction, beyond the basic quote. | read | false | unknown |
| get_market_news Get the latest market-wide news across all tickers, most recent first (not filtered to one company). Every item is significance-classified at ingest (critical | major | standard); the default filter of critical,major is the "top stories" view. Served by the /news/latest public endpoint (added 2026-07-29; 404 on a backend without it). | read | false | unknown |
| get_news Get recent news articles, press releases and AI-analysed SEC filings for a company. Filing rows (category "sec_filing") are event-bearing forms only (8-K, 6-K, 424B prospectus supplements, S-1/F-1, 10-K/10-Q/20-F, SC 13D, proxies, delisting notices; never Form 3/4/5, 13G or bank-note 424B2) and carry formType and accessionNumber; a filing that repeats a press release is omitted in favour of the release. For a small foreign issuer that files its news as 6-Ks, the filing is the news. `pressReleasesOnly` returns only official company press releases (no filings). | read | false | unknown |
| get_ownership Get the unified ownership breakdown for a company, combining Form 4 insider holdings, 13F institutional holdings and 13D/13G activist positions, resolved across the three form types into one view. allHolders is paginated via limit/offset (default 100); aggregate stats (institutional / insider / beneficial totals and percentages, plus `retail`) are always complete. `sharesOutstanding`, the denominator of every percentage, is dated by `sharesOutstandingAsOf` + `sharesOutstandingAsOfKind` ("stated" = issuer's statement date; "checked" = last confirmed against a vendor; "none" = date not recorded) and `sharesOutstandingSource`; a count is only meaningful with its date. `retail` is the unattributed residual (shares no filing accounts for, including recent offering buyers and non-filing holders): an upper bound on retail, not a retail count; withheld (null) with `retail.reason: "filed_exceeds_outstanding"` when counted filings exceed shares outstanding. A bucket whose shares exceed shares outstanding by more than a 2% timing tolerance has `percentOfOutstanding` withheld (null, `percentWithheldReason: "ownership_exceeds_outstanding"`) with `totalShares` still published (e.g. another share basis such as ordinary shares vs ADSs, another class, lent shares reported twice, filings predating a buyback); the shares and the reason are the measurement, and the withheld percent is not 100%, 0% or any other percent. In that case `retail.reason` is `ownership_exceeds_outstanding` and `filedSumPercent` is absent. A null percent with no `percentWithheldReason` means no share count was available. `beneficial.staleShares` / `stalePercentOfOutstanding` / `staleHolderCount` is a measured subset of the counted 5%+ total resting on 13D/G schedules >= 24 months old with no newer reaffirming filing by the holder family: not a deduction. `reaffirmedBy` names the newer filing; `staleFiling.ageMonths` marks a row with none. `stalePercentOfOutstanding: null` is not measurable, not zero. | read | false | unknown |
| get_policy_events List mirrored executive orders (policy events) from the Federal Register feed. Filterable 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. 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 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), not culpability, and matchCount is how many EOs matched in the window (a noise indicator). | read | false | unknown |
| get_policy_trade_leaderboard Rank politicians (Congress + executive branch) by trades that occurred near executive-order signings in sectors the orders affect, i.e. who trades most around policy activity. Each row includes the politician, flaggedTradeCount, totalEstimatedUsd, topSector, and an exampleEvent. Defaults to the "traded 1-14 days before signing" lens; same-day trades are always excluded. 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 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), not culpability, and matchCount is how many EOs matched in the window (a noise indicator). | read | false | unknown |
| get_policy_trade_overlap For a single politician, list trades that occurred within a window of days before or after the signing of an executive order affecting the traded sector. Each row contains the trade, the nearestEvent, daysDelta (negative = traded N days before EO signing, positive = traded N days after), matchBasis, and matchCount, plus a summary (totalFlags, totalEstimatedUsd, topSector). Defaults to trades 1-14 days before signing; same-day trades are always excluded (intraday ordering is unknowable). Executive-branch (exec-) slugs return real data here: both congressional and executive trade sources feed the overlap computation. 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 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), not culpability, and matchCount is how many EOs matched in the window (a noise indicator). | read | false | unknown |
| get_political_sector_rotation Which market sectors politicians have been trading in over a trailing window. Aggregates congressional + executive trades by sector and returns, per sector: trade count, total dollar volume, number of distinct politicians, and the top tickers, showing where political trading activity is concentrating (e.g. "politicians piled into Energy this month"). Sortable by count or dollar volume. | read | false | unknown |
| get_politician_activity Get activity metrics for a politician broken down by period (30d, 90d, 1y, all-time). Includes buy/sell counts and values per period, most traded tickers (top 10), and transaction type breakdown. Useful for analyzing trading patterns over time. | read | false | unknown |
| get_politician_committees Get committee assignments for a politician including committee name, chamber, role (Chair, Ranking Member, etc.), and subcommittee memberships, for relating trading activity to committee oversight areas. The politician is identified by URL slug (e.g. "sen-nancy-pelosi"). | read | false | unknown |
| get_politician_detail Get the full profile for a politician including party, state, chamber, trade statistics, filing delay metrics, most traded sector, and their 10 most recent transactions. The politician is identified by URL slug (e.g. "sen-nancy-pelosi"). | read | false | unknown |
| get_politician_disclosures Per-disclosure feed of politician trades: one item per congressional STOCK Act periodic transaction report (PTR) or executive-branch OGE Form 278-T that contains at least one trade whose bracket lower bound is >= minAmount. Each item carries the politician, filing link, filing delay, and every trade of the report sorted largest bracket first, with qualifyingTradeCount for how many clear the threshold. Polling contract: the returned nextCursor, sent back as `since`, returns each disclosure exactly once (for the same minAmount and kinds); nextCursor is returned even when items is empty, and hasMore true means more items are immediately available. Without `since` only disclosures that became complete in the last 48h are returned. A report is emitted only after no new row of it has arrived for a settle window (~8h), so items lag the filing by hours; a report that grows materially afterwards (+25 trades or +20%) is emitted once more with a higher `revision`, and `replacesPrevious: true` marks a report previously delivered under the same `id`. filingDelayDays (longest lag), isLateFiling (>45 days) and lateTradeCount exclude trades with transactionDateSuspect=true: a date lagging its own otherwise on-time report by about one year is a probable mistyped year upstream, listed as filed and counted in suspectDateCount, and its lag is not a measured filing delay. owner null means the filing did not state an owner ("Not stated"); it does not mean "Self". amountRange is the filed bracket; amountMin null means the bracket was not parsed (not $0), amountMax null means "Over $50,000,000" or unparsed, and ticker null means a non-equity asset. | read | false | unknown |
| get_politician_donor_summary Get a bundled donor summary for a single politician: cycle totals (raised, spent, cash-on-hand, debts), donor count, top 10 individual donors, and top 10 PAC donors, all in one response. Answers "who funds <politician>" or "biggest donors to <politician>" style questions without paging the full donor list. | read | false | unknown |
| get_politician_donors Get the paginated list of campaign donors (individuals and PACs) for a single politician across one election cycle: the full donor list behind questions like "who donated to <politician>". Returns donor name, amount, type, employer/occupation (individuals), and committee details (PACs). | read | false | unknown |
| get_politician_late_filers Get STOCK Act late filings: trades whose disclosure was filed more than 45 days after the transaction, the latest the STOCK Act allows. Lateness is a fact about the dates on the report, not a finding of illegality or a violation: an extension, an amendment or a late notice of the trade can each explain a long gap. Sorted by filing delay descending. Excludes trades whose transaction date is suspect (a probable mistyped year upstream, about one year off the rest of its own on-time filing); their delay is not measured. owner null means not stated; it does not mean "Self". | read | false | unknown |
| get_politician_pnl Get estimated realized + unrealized profit & loss for a politician. Methodology: each disclosed trade amount range is converted to an estimated share count using the stock's historical market price on the transaction date, then FIFO-matched on shares (realized = (sellPrice - buyPrice) x matched shares); open positions are marked to the current price for unrealized P&L. Covers Congress (sen-/rep-) and executive branch (exec-) officials, identified by URL slug. Response includes a `totals` object (estimatedRealizedPnl, estimatedUnrealizedPnl, winRate, realizedTrades, tickersTraded) and a `byTicker[]` breakdown (estimatedShares, avgCostBasis, currentPrice, realizedPnl, unrealizedPnl, unrealizedPnlPercent); byTicker open positions double as the estimated holdings. All figures are estimates (±25-40% from disclosure bracket width). | read | false | unknown |
| get_politician_recent_trades Get recent STOCK Act trades across all politicians. Each trade includes the senator info, ticker, transaction type, amount, and filing delay. Filter by direction (buy/sell) and lookback period. Useful for monitoring current congressional trading activity. | read | false | unknown |
| get_politician_roles Get committee leadership roles (Chair, Ranking Member, etc.) for a politician, identified by URL slug (e.g. "sen-nancy-pelosi"). | read | false | unknown |
| get_politician_scorecard Top 5 and bottom 5 politicians (Congress + executive-branch officials) by estimated trading P&L over a trailing window (default and only supported window: 90 days), plus SPY's return over the same window as a benchmark, and imageUrl: a 2160x2700 PNG card of the same ranking (null when unavailable; card.reason says why). All P&L figures are estimates (estimate: true, estimateRange "±25–40%"): disclosed amount ranges are converted to shares at the historical close, FIFO-matched, and open positions marked to the latest quote. The card prints "Estimates from disclosed amount ranges (±25–40%). Not investment advice." The `metric` field defines the figure: P&L on trades disclosed inside the window only, i.e. realized on round trips opened and closed in the window plus unrealized on positions opened in the window. It is not lifetime P&L; sales of positions bought before the window are not counted. Eligibility: at least 5 trades in the window (eligibility.minTradesInWindow), so a single lucky trade cannot top the board. Each row: slug, fullTitle ("Senator", "Representative", or an executive official's filed title), fullName, displayName, party and state as full words (the publishable form, rather than "Sen." or "D-CA"), estimatedPnl, winRate (0-1; null = no position closed in the window, which is not measured and not 0%), tradesInWindow, unrealizedMeasured, and portraitUrl (always null for executive officials). benchmark.available false means SPY was not measured (benchmark.reason); it is not a 0% return. available false with reason "pending" means the window has not been computed yet, not that nobody traded. | read | false | unknown |
| get_politician_transactions Get paginated trade history for a specific politician. Returns individual STOCK Act disclosures with ticker, transaction type, amount range, filing delay, and late filing flag. Includes a summary with total buys/sells and net value. | read | false | unknown |
| get_politician_votes Get voting records for a politician by slug. Returns congressional votes with bill info, position (Yea/Nay/Not Voting), and result. Useful for assessing alignment between a politician's votes and their trading positions. Requires Bioguide ID resolution. | read | false | unknown |
| get_politicians List and search congressional politicians who have STOCK Act trading disclosures. Filter by party (D/R/I), state, or search by name. Returns paginated results with trade counts, last trade date, and net buy/sell direction over the trailing 12 months. | read | false | unknown |
| get_politicians_most_active Discover the most active congressional traders ranked by trade count within a lookback period. Returns each politician with trade count, tickers traded, buy/sell values, and top tickers. Useful for identifying the most prolific political traders. | read | false | unknown |
| get_politicians_pnl_leaderboard Rank politicians (Congress + executive branch) by estimated trading P&L across the universe. Sort by total P&L, win rate, or traded volume. P&L uses price-adjusted share estimation: disclosed amount ranges → estimated shares via historical price → FIFO on shares → open positions marked to current price. Figures are ESTIMATES (±25-40% from disclosure bracket width). | read | false | unknown |
| get_post_earnings_movers Get stocks that moved significantly after earnings reports on a given date. Returns pre-computed price changes joined with earnings surprise data, one row per ticker. Includes preEarningsClose, currentPrice, changePct, EPS/revenue actuals vs estimates, and surprise percentages. Filter by minimum absolute % change threshold. | write | true | unknown |
| get_premarket_scan_history Historical market-wide premarket scan for one past ET trade date: every ticker with that day's premarket (default) session volume and its RVOL vs the trailing 30-day same-session baseline (the same per-ticker RVOL math, across the market for one date). Filters on RVOL, market cap, price and float support backtesting screens like "sub-$500M tickers with premarket RVOL > 5 on 2026-07-20"; rows ranked by RVOL descending. A future or non-trading date returns an empty list with a reason (not an error). Each row reports "baselineState" (why its RVOL is or is not null), "advRatio" (volume / trailing 30-session average full-day volume), "advDays", and the RVOL denominator "baselineVolume" with "baselineThin" (true under 200 shares): a 90x RVOL off a 1-share baseline is arithmetically correct and analytically meaningless, mostly an early-asOfTime effect on liquid large caps; minBaselineVolume / minSessionVolume exclude such rows. includeNoHistory=true surfaces high-volume tickers with no computable RVOL (e.g. first-session listings). meta reports asOfApplied / asOfIgnored / asOfIgnoredReason, so an unhonoured time-of-day request is visible. Tickers with no screener value for a price / market-cap / float filter (just renamed or listed) are not silently dropped: "meta.unscreened" reports their count, filter families and tickers, and includeUnscreened=true returns them tagged "unscreenedFilters"; that tag means the filter was not measured for the ticker, not that it is out of range. | read | false | unknown |
| get_premarket_scanner Get the live premarket scanner board (premarket small-cap runners): top premarket gainers and losers by absolute gap %, each row enriched with rvol, marketCap, floatShares, short interest, dilution and news/catalyst flags. Off-hours it falls back to the last session. includePennyStocks=true includes sub-$1 names. Float: floatShares is the measured point float (null on a withheld dilution-snapshot row, which then carries "floatEstimate" {shares, bound: "point" | "ceiling" | "floor", basis}). A point estimate is a number with its as-of and caveat; a ceiling or floor is a bound, not a figure: the float is not stated and is at most (ceiling) or at least (floor) that number, and is not a basis for arithmetic; neither present = not measured, not 0. The low-float board admits on that figure's value (an 8M ceiling is in, a 26M floor is out). Compliance: row "compliance", the compliance/split badges, "reverseSplitSignal" and "deficiencySignal" are Signal8 Pro; for other callers "compliance" is null with "complianceWithheld": "pro_required", meaning withheld, which is not "not measured" and not "no deficiency". Live volume (04:00-09:30 ET only; null outside the window or until the baseline is warm, never fabricated) has two different metrics, neither interchangeable with the other or with "rvol". "liveRvol" = live cumulative premarket volume / the trailing 30-session average cumulative volume at the same time of morning, with "liveRvolAsOf" the 15-minute grid cutoff (meta.asOf shows any time skew); "premarketPaceRatio" = the same volume / the trailing 30-session average full premarket session (>1.0 = already beat a normal premarket). universe="lowfloat" returns the separate low-float board (float under 10M, no top-100 slice) from the aggregator snapshot; an empty rows array with meta.reason when none is published is a normal off-hours state. | read | false | unknown |
| get_price_target Get analyst price target data for a ticker. By default returns the consensus / split-adjusted average price target. Set list=true to return the full per-analyst list of individual price targets instead. | read | false | unknown |
| get_quote Get the current stock quote for a company: price, volume, change, market cap and other real-time market data. Trading-halt fields halted, haltCode, haltReason, haltedAt and resumptionAt are present on every response (false/null when trading normally); a halted ticker returns the last-known quote instead of an error, or currentPrice null with halted true when nothing is recoverable. `priceAsOfDate` is the ET date the price printed (`priceAsOf` the trade time when known), not when it was read; null means the print date was not measured. `priceIsStale: true` means the price is an older held close (the last trade on that date), not a current trading price. `quoteSource: "screener_reference"` (foreign listings on US OTC that file nothing with the SEC, e.g. PGPHF) means `currentPrice` is a vendor reference price whose print date is not known, and every other market field is null (not measured). `marketCap` is the live price times the SEC-derived share count; when that count is unavailable it is null with `marketCapWithheldReason` set, which means not measured, not zero and not "no market cap". The count is `sharesOutstanding`, dated by `sharesOutstandingAsOf` and `sharesOutstandingAsOfKind` ("stated" = the issuer's statement date; "checked" = when it was last confirmed against a vendor; "none" = date not recorded), with a vendor-free `sharesOutstandingSource`. When no measured count exists, `sharesOutstanding` and `marketCap` are a best estimate (the newest dated filed or reference count, moved onto today's split basis): `sharesOutstandingEstimated: true`, `sharesOutstandingEstimateKind` and `marketCapEstimated: true` with `marketCapAsOf` (the count's date). Kind "stated_as_of" is the issuer's last stated count, a dated point rather than a bound or today's count; later issuances recorded in the filings are listed in `statedAsOf.events`, not added to it ("at_least" is the retired name of the same state). | read | false | unknown |
| get_recent_congressional_votes Get recent congressional roll-call votes across all members, sourced from GovTrack (both chambers as available; currently Senate-heavy). Each vote includes member, bill info, position, and result. | read | false | unknown |
| get_recent_material_filings Recent material 8-K filings (last 7 days) for the constituents of an index universe. By default returns the high-signal 8-K item codes (material agreements, M&A, executive changes, restructurings, etc.); pass `items` to filter to specific 8-K item codes. Choose the universe with `universe`. | read | false | unknown |
| get_recent_uplistings OTC-to-exchange uplistings that FINRA recorded on a given US market day, for companies under a market-cap ceiling. Each row carries the old OTC symbol, the resolved new exchange symbol (or null), a confirmed flag, the destination venue (NASDAQ / NYSE / NYSE American / ARCA), company name, effective date, market cap and float in shares. This is a same-day read and there is no forward-looking version: FINRA records an uplisting at roughly 01:45 ET on the day it becomes effective, and the source table has no scheduled or announced column. dayOffset exists for catch-up reads of past days, not for forecasting, and a positive offset returns nothing. Every row has already happened; none is upcoming or expected. newSymbol: null is a published state, not a missing field: FINRA's row names only the old OTC symbol, and the new ticker is resolved by company-name match against Nasdaq SymDir and sometimes cannot be resolved. A guessed ticker could name a company that did not uplist, so an unresolved row names the old symbol and states that the new one was not resolved; the null is not a gap to fill and the row is still a real uplisting. confirmed: false means the symbol resolution is provisional and the new ticker is not asserted as fact; only confirmed: true is a confirmed resolution. capUnknownCount is a withholding count, not a zero: rows that cleared every other filter but have no measured market cap, so they cannot be asserted to sit under the stated ceiling. It does not mean those companies have no cap, and a cap-bracketed list with capUnknownCount above zero is not complete. An empty uplistings array is the normal, expected result on most days: uplistings run roughly 6.6 per month across all market caps, so the large majority of days genuinely have none. It is not an error, not an outage and not evidence that uplisting activity has stopped. | read | false | unknown |
| get_recently_delisted Securities removed or suspended from Nasdaq, NYSE or NYSE American in the last 30, 60 or 90 days, as the signal8.ai/recently-delisted page lists them. Sources: SEC Form 25 and Form 25-NSE filings, the Nasdaq suspended list and NYSE Regulation notices. Each row has the ticker, company, exchange, security kind and class, status (removed: Form 25 in effect, which is 10 days after filing under Rule 12d2-2(d)(1); removal_pending: Form 25 filed, not yet in effect; suspended: the exchange suspended trading and no Form 25 is on file yet; halted: NOT a delisting yet, an open H11 regulatory halt on NYSE, NYSE American or NYSE Arca with the last close below $0.10 and no exchange notice or Form 25 on record, which can still resume; haltedOn is its date and reason is "halted"), the suspension, Form 25 filing and effective dates, the last session with an exchange print, the symbol it trades under now (tradesNow, e.g. on OTC) with the last price seen there, and links to the source records. reason is the reason on record and nothing else: the Rule 12d2-2 provision the Form 25 was filed under ((a)(1)/(a)(2) redemption or maturity, (a)(3) merger, (a)(4) rights extinguished, (b) the exchange struck it, (c) the issuer withdrew it, given in `rule`), or the exchange's own published words (`reasonStated`, verbatim). It is never inferred from price action. A merger or redemption is not a failed company, and reason "transfer" means the security was still printing on an exchange after the filing (a venue move or a holding-company exchange), so it did not leave exchange trading. reason "unknown" means no reason was on record that Signal8 read. A null field means not measured: it never means no, zero or none. unreadFilings counts Form 25 filings in the window that are not read yet and are not in rows, and coverageFrom is the earliest Form 25 date held, so the list is not complete before it. total is the number of rows matching the filters before limit. | read | false | unknown |
| get_recently_sponsored_bills Get the most recently introduced bills across all congressional sponsors. Each bill includes the sponsor block (bioguideId, fullName, party, state, politicianSlug) so persona agents can link directly to the sponsor detail page. politicianSlug is null when the sponsor is no longer in the active roster (typically ex-members). Requires CONGRESS_API_KEY on the backend. | read | false | unknown |
| get_reverse_split_authority Companies whose board still holds reverse-split authority it may use without another shareholder vote: an approval on file (shareholder vote or written consent; tracker states consent_pending, voted_approved, ratio_fixed) not past a stated expiry, one row per company (its newest approval; other live ones in otherLiveAuthorityEpisodeIds). Soonest stated expiry first. Each row is the Reverse Splits page row (ticker, companyName, ratio, exchange, approvalPath, domicile, splitAuthority, authorityTerms, sourceUrl / sourceAccession, sourceDocuments: every document behind the approval with accession or URL) plus an "authority" block: episodeId, state, approvedDate, approvedRatio {fixed, min, max} (the per-split ratio or range approved), cumulativeCap (cap on the product of every split drawn on it), multiStep, expiresOn, expiryTerm, daysUntilExpiry, and room: capRatio + capBasis ("cumulative_cap", or "single_split_maximum" = no cumulative cap stated and nothing drawn, so one split up to the approved maximum), perSplitMax, usedSplits + usedRatio (product of the splits already executed on it; 1 = none drawn), remainingRatio (capRatio / usedRatio), exhausted, nextSplitMax, pendingRatio (a ratio the board set that has not taken effect) and a one-line label. The approval route is approvalPath.path (shareholder_vote, written_consent, fpi_written_resolution, pre_approved_range, board_only, depositary_ratio_change or unknown = "Not determined", not "no vote"). Ratios are 1-for-N factors and combine by product. Not measured is not "none remaining": room.remainingRatio null comes with room.notMeasuredReason ("cumulative_cap_not_stated", "ratio_not_stated" or "drawn_split_ratio_not_stated"), meaning the remaining room is not measured for that reason. Such rows are listed, never dropped, and are not full. expiresOn null = the documents read state no expiry, not "never expires". An empty list is what the tracker has on file, not evidence that no board holds authority. This screen covers approvals on file; a board that may split under its statute or charter with no approval at all shows as splitAuthority.boardMayActWithoutVote on a row and in the per-company lifecycle, and is not listed here on that basis alone. Locked rows are withheld, not absent. The facts are part of Signal8 Pro: a key not owned by a Pro account gets rows with locked: true and only ticker, companyName, hasPage and exchange (access "preview", lockedCount). minRemaining and expiringBefore are Pro-only filters (on a non-Pro key they apply to unlocked rows only; filtersLimitedToUnlocked: true). A row whose remaining room or expiry is not measured never matches those filters; excludedNotMeasured counts how many were left out for that reason. Paging uses limit and nextCursor. available: false or an HTTP 503 FEATURE_DISABLED = unavailable, and the response says nothing about any company. The data describes what is on file and carries no view on whether a split will happen, what it means for the price, or what anyone should do. | read | false | unknown |
| get_reverse_split_lifecycle The reverse-split lifecycle Signal8 has tracked from a company's own SEC filings (proxies, 8-K Items 3.03/5.03/5.07, 6-Ks): one episode per split authority, newest first, each with its state (proposed, vote scheduled, approved, ratio set, effective date announced, charter filed, ... or closed), the ratio or authorised range, meeting / vote / effective dates, the state history, and the events behind it oldest first. The state consent_pending means approved by written consent of holders of a majority of the voting power (a Schedule 14C information statement): no meeting or vote is still to come. Such an episode carries writtenConsent {informationStatement ("preliminary" / "definitive" / null), definitiveFiledOn, preliminaryFiledOn, detail}: under SEC Rule 14c-2 the split can take effect no sooner than 20 calendar days after the definitive statement is sent to holders; no date is computed from that. Every event carries its source (accession and an EDGAR sourceUrl) and its facts; every stated fact carries the verbatim quote it was read from. Not stated means not measured, not "no": a fact with notStated:true (or a null field) means the documents read did not say it, not that it is false, zero or absent. coverage "unresolved" means the ticker could not be matched to an SEC registrant (not measured). coverage "tracked" with an empty episodes list means no episode has been tracked from the filings read since the tracker started; it is not evidence that no reverse split is planned. effectiveDate is the date the issuer stated, strictly parsed: a scheduled date, not a confirmation that the split happened (it can be postponed or abandoned). A conditional date ("the 25th trading day after the Trigger Event") is returned verbatim in effectiveCondition and is not a date; no date is computed from it. verification is copied from the tracker: "provisional" = one source, not cross-checked (the default, not "doubtful"); "verified" = cross-checked. Approval (present only when approvalAvailable is true): each episode carries approvalPath {path, label, quote, sourceUrl}: shareholder_vote, written_consent, fpi_written_resolution, pre_approved_range (the board set the ratio inside a range shareholders approved earlier), board_only (the company's own filing states no shareholder approval was required, quoted), depositary_ratio_change (an ADS ratio change by the depositary, no shareholder vote, the ordinary shares not consolidated) or unknown. The response also carries domicile {code, label, group, source} (EDGAR, else the latest 10-K / 20-F cover; null = not measured, not "Delaware") and splitAuthority {authority, basis, label, boardMayActWithoutVote, conditions, statute, quote, sourceUrl}. Only basis own_prior_board_only_announcement or charter_clause is board split authority on file: a charter clause is a standing power; own prior evidence is a PAST board-only split (dated in the label, conditional on its statute, e.g. NRS 78.207 needs authorized shares cut by the same ratio), not a power to skip a vote now, and the current split can still go to a vote. authority "unknown" or basis "domicile_default_only" is not a finding about the company: it only states what the domicile's law allows by default (e.g. "Domicile may permit board action; charter not checked"), not that this company can split without a vote. vote_required appears only as a labelled domicile default, not as a statement that a vote is needed. path "unknown" is not "no vote"; a missing proxy does not determine a path. An HTTP 503 FEATURE_DISABLED means the lifecycle tracker is switched off and the response says nothing about the company's splits. The ticker input also takes a former ticker or a numeric SEC CIK; an answer for one of those carries a top-level `resolvedFrom` block naming the current symbol. An episode announcedDate is the day the split first became public in a filing or notice; null = not measured (never a date after the effective date). | read | false | unknown |
| get_reverse_splits_list The cross-company reverse-split lists the Signal8 Reverse Splits page serves, one view per call. view "upcoming" = splits with an effective date from tomorrow through 30 US market days ahead, the vendor market calendar union Signal8's SEC-filing tracker (filings, exchange and depositary notices); "recent" = the same union for effective dates in the past 30 days; "approved_no_date" = tracked episodes where shareholders (or the board, where no vote is required) have approved a reverse split but no effective date is stated yet; "vote_pending" = tracked episodes where a reverse split is proposed and the shareholder vote has not happened yet; "cancelled" = tracked episodes that ended without the split taking effect in the past 90 days (withdrawn by the company, a vote that did not approve it, an approved authority that expired unused, a meeting postponed indefinitely), with a cancelled object (outcome, outcomeLabel, endedOn, endedOnBasis, laterEpisode when the company has a newer open proposal) and the closing document as the source; older ended episodes are on the separate ended-reverse-splits tool. A security sits on exactly one of the first four views (upcoming, then recent, then approved_no_date, then vote_pending), with one exception: a split the company's own filing dates is on upcoming even when the same company also has a different, later split proposal awaiting a vote, which is then on vote_pending too; "cancelled" may repeat a company another view lists. Each row carries ticker, companyName, hasPage, source ("market_calendar" or "tracker"), stage + stageLabel, trackerState, ratio (or ratioMin / ratioMax for an authorised range), meetingDate, approvedDate, effectiveDate, effectiveDateSource, marketCalendarAgrees / marketCalendarDate / marketCalendarRatio, effectiveCondition, verification, marketConfirmation (recent only), marketCapUsd + capBucket, securityType, exchange, cik, sourceUrl / sourceAccession / sourceFormType / sourceFiledDate / sourceLabel, sourceDocuments (every document behind the episode), quote, adsRatioChange, approvalPath, domicile, splitAuthority and authorityTerms. Null means not measured or not stated: not "no split", not zero, not "no vote needed" and not "no date". A null ratio = the documents state none yet; a null marketCapUsd = cap not measured (capBucket is then null, not "nano"); a null verification = no tracked episode; a null domicile = not measured (not "Delaware"); a null marketConfirmation = the price step was not measured. An empty rows array on a view is normal and is not evidence that no company is splitting. completeness says what the view is: "scheduled_as_of_now" (upcoming) and "recorded_as_of_now" (recent) are what is known as of now, not "all reverse splits"; "tracked_episodes" is what the tracker has read from filings since it started, not every company. A scheduled split can still be postponed or cancelled: it is scheduled, not confirmed. Dates: effectiveDate is the scheduled effective date (vendor calendar, or the issuer-stated date strictly parsed from the filing); a filing or listing-rule deadline is not an effective date and does not appear in this field. A conditional date ("the 25th trading day after...") is returned verbatim in effectiveCondition and is not a date. effectiveDateSource says where effectiveDate came from: "filing" = the issuer stated it; "exchange_notice" = only a Nasdaq / NYSE / FINRA notice states it (not the issuer); "market_calendar" = the filing states no date and the vendor calendar supplies it. marketCalendarAgrees is a cross-check on a tracker row the calendar also lists: true = same date and ratio; false = at least one differs and marketCalendarDate / marketCalendarRatio hold the calendar's value (the filing's value is the row's value, and the two sources disagree); null or absent = not compared (no calendar row). meetingDate is the shareholder meeting date, not the split date. Approval and authority: approvalPath.path is shareholder_vote, written_consent, fpi_written_resolution, pre_approved_range (the board sets the ratio inside a range shareholders approved earlier), board_only (the issuer's own filing says no shareholder approval is required, quoted), depositary_ratio_change (an ADS ratio change by the depositary, no vote) or unknown ("Not determined", not "no vote"). splitAuthority.boardMayActWithoutVote is true only from the issuer's own filing or charter; a domicile default alone is not a finding. authorityTerms is the authority behind the episode: a cumulativeCap (the board may split in steps, each within the cap, without a new vote until the authority expires), multiStep, the expiry, and what executed splits already used; null = the documents state nothing beyond the ratio. Locked rows are withheld, not absent. The split facts on every view are part of Signal8 Pro. A caller whose API key is not owned by a Pro account gets every row with locked: true and only ticker, companyName, hasPage and exchange on it; the response then carries access: "preview", lockedCount (how many rows are locked) and rowLimit. A locked row means the facts exist and were not shown to this caller (they need Signal8 Pro); it does not mean "no split". access: "full" = every row carries its facts. filtersLimitedToUnlocked: true = a board / domicile filter was applied to unlocked rows only (locked rows are left out entirely, because matching them would reveal the fact through membership). Filters apply server-side: cap (scanner buckets), type (security type), exchange, board ("without_vote": board split authority on file, from the issuer's own filing or charter) and domicile. Each accepts "not_measured" to select rows where that fact was not measured; an unmeasured row never matches a measured bucket. totalCount is the filtered list (locked rows included), unfilteredCount the view before filters, capUnknownCount the rows whose cap was not measured (on the calendar views). Paging uses limit / offset; truncated: true = more rows exist. available: false with reason "tracker_not_enabled" (the tracker views) means the tracker is switched off, not that nothing is pending. An HTTP 503 FEATURE_DISABLED means the page is switched off, and the response then says nothing about any company's split. The data describes what is on file and carries no view on whether a split will happen, what it means for the price, or what anyone should do. | read | false | unknown |
| get_rvol_history Get the per-day relative-volume (RVOL) time series for a ticker, bucketed by trading session (premarket 04:00-09:30 ET, regular 09:30-16:00, afterhours 16:00-20:00, or all four). Each day's RVOL compares that session's volume to a trailing same-session baseline (30 trading days by default, configurable via "baselineDays"), so premarket volume is judged against premarket history (not a stale full-day figure); the series shows unusual premarket / session volume surges over the last N days. Each point also carries "baselineState": "ready" (rvol is populated), "warming" (baseline not yet warm), "no-cutoff-history" (established ticker that never traded at this session/cutoff before) or "no-history" (new listing, no prior trading history at all), so a null rvol is explained rather than silent. Points additionally carry "advRatio" (that day's volume / the trailing 30-session average full-day volume, null when no full-day denominator exists) and "advDays" (its sample size), which give a magnitude to points RVOL cannot rate. advRatio is not an RVOL: it compares a partial session to a whole day, so it is typically well under 1 and is not comparable to rvol. COMPLETED SESSIONS ONLY: the newest point is the previous trading day (the rollups land ~12:10 ET the next day), so this tool never has a point for today. For the RVOL right now, use get_live_rvol. | read | false | unknown |
| get_senate_trades_by_ticker Reverse lookup: which politicians recently traded a given ticker. Returns recent STOCK Act disclosures for that symbol with politician info, transaction type, and amount, covering trades in the last 180 days. | read | false | unknown |
| get_short_interest Get short interest data for a company: short volume, short ratio, days to cover and short percent of float. A null `shortInterestPercent` always carries `shortInterestPercentReason`: "float_not_point" means the float on record is a bound or estimate, and a percent-of-float is not computed from a bound or estimate; "float_unavailable" means no float of any kind is on record; "short_pct_of_float_unreconciled" means a point float existed but the ratio was implausible or the split basis could not be resolved; "float_class_scope_mismatch" means the float on record pools more than one separately listed share class (e.g. Class A plus Class D) while short interest is reported for this symbol's class only, so the two figures are not comparable. A null percent means not measured; it does not mean 0%. | read | false | unknown |
| get_split_history Get stock split history for a company including forward and reverse splits with dates, ratios, type classification, and cumulative 2-year reverse split ratio. Relevant for Nasdaq/NYSE minimum bid-price compliance (1:250 cumulative reverse-split cap). A null `cumulativeReverseSplitRatio2yr` means the cumulative cannot be stated, which is not the same as no reverse splits; `cumulativeWithheldReason` distinguishes the two. `unconfirmed_splits_in_window` means at least one in-window reverse split is evidenced by only one source, so no cumulative is defensible: the confirmed splits alone would understate it, and understating a cumulative can put an issuer that breaches the 1:250 cap under it. Each row also carries `confirmed`; a `confirmed: false` split appears only in the announcement calendar, which retains every announcement and retracts none, so it is usually an amended or superseded announcement and occasionally a real split the effected-splits ledger missed. Both are returned. `ratioDisplay` and `type` are likewise null for a ratio whose exact factor cannot be determined. Not every vendor "split" is a split: stock dividends and other distributions under 25%, spin-off price factors and consolidations under 1.5x are returned in `nonSplitAdjustments` (each with a `kind` and `meaning`), not in `splits`, and are excluded from `totalSplits`, `reverseSplitCount` and the cumulative. They are not splits. | read | false | unknown |
| get_split_performance Get how one ticker's price moved in the N calendar days after each stock split it already executed (forward or reverse), newest first, up to 30 splits, in one call. Past executed splits only: upcoming, approved or pending splits are not included. Each split row carries executionDate, ratio ("1-for-12" = 12 old shares became 1), kind (reverse | forward | other), lastPreSplitDate, firstPostSplitDate, firstPostSplitCloseAsTraded, windowEndDate, windowEndCloseAsTraded, sessionsInWindow, changeFromFirstPostSplitClosePct (first post-split close to the last close in the window), changeFromLastPreSplitClosePct (the last pre-split close moved onto the post-split basis by the split ratio, so the split itself is not counted as a move), lowestLowVsFirstClosePct and highestHighVsFirstClosePct. Basis: the response field basis states it. Each row is on that split's own post-split basis (daily bars as traded); prices are not adjusted onto today's basis, so % moves are comparable across rows and prices are not. A null value means not measured; it does not mean 0 or "no move". Causes: a missing bar, a bar print Signal8 refused as implausible, or a window that reaches a later split (anotherSplitInWindow: true, its % withheld). notMeasured on a row names the reason per null field; dataGap = no daily bar within 7 days after the split. Stock dividends, spin-off price factors and consolidations under 1.5x that the vendor files as splits are not splits: they are listed in nonSplitAdjustments (kind, meaning), never measured or counted, and a split window containing one has its % withheld (nonSplitAdjustmentInWindow: true). An empty splits array means no executed split is on record in Signal8 split history, which is not evidence that none occurred. splitsMeasured and fellInWindow count only measured rows. asOf is the latest window-end bar date. These are past price moves, not a forecast and not investment advice. Included in Signal8 Pro: an HTTP 403 FEATURE_NOT_AVAILABLE means the API key's account is not on Pro, and the response then carries no price data for the company. | read | false | unknown |
| get_stock_price_change Get percentage price changes for a stock across multiple timeframes (1D, 5D, 1M, 3M, 6M, YTD, 1Y, 3Y, 5Y, 10Y and MAX) without full candle data. | read | false | unknown |
| get_top_movers Top stock movers: gainers (largest % up), losers (largest % down), or active (highest volume). Optional session window (premarket / regular / afterhours; regular default; not supported for active). An optional date (YYYY-MM-DD) returns a past trade date's gainers/losers on a historical daily close-to-close basis (computed from split-adjusted daily bars, not intraday); session is rejected when date is set, date is not supported for direction=active, and a non-trade date (weekend/holiday) returns an empty list (not an error). Penny-stock artifacts are filtered by default; includePennyStocks=true includes sub-$1 movers. | read | false | unknown |
| get_trading_halts List securities currently halted across NASDAQ/NYSE/AMEX (from the consolidated exchange halt list). Each halt includes ticker, market, haltCode (T1/T2/T12/LUDP/H10/...), human-readable reason, haltedAt, haltAgeDays, and the scheduled resumptionAt when one is set. `halts` holds halts that began within the last 30 days; `longRunningHalts` holds older halts the feed still lists (often regulatory halts that have lasted months or years); they are not new halts. `asOf` is when the list was read. An empty list is a normal state (no active halts right now), not an error. Halt rows carry no price. | read | false | unknown |
| get_underwriter_stats Placement agents and underwriters of small-cap offerings (public offerings, registered directs, PIPEs) and how the stock traded after their deals, from published Signal8 dilution snapshots. Without `firm`: the firms by deal count, each with median close-to-close moves on Day 1 and Day 2 from the pricing date, the reference close to Day 20, the median Day 0 open vs the offering price, the share of deals that closed below the offering price by Day 2 and the share with a red Day 1, plus `allFirms` (every deal counted once). With `firm` (a name, abbreviation such as "HCW", or slug): the resolved firm, its full stat block (Day 0 to Day 60 medians and means, offer discount, warrant coverage, deal size vs market value, and the first session from one-minute prices: open and 30-minute high vs the offering price, 30-minute high to the close, last premarket trade vs the offering price), splits by run-up and by material news before pricing, by deal type, size and issuer mix (with `topIssuers`, the companies with 2+ of its deals), `outcomes` (share of its deals after which the company did a reverse split, priced another offering, or received an exchange deficiency notice or was delisted, within 3, 6 and 12 months; the baseline carries the same; facts on record, not a cause; `outcomesByCompany` gives the same shares with each company counted once, n = companies measured), the 3 newest deals (`recentDeals`) and the all-firms baseline. When the name matches several firms or none, `found` is false and `candidates` lists the matches. `includeDeals` adds the full deal list and `includePipeline` adds open ATM / equity-distribution agreements and pending S-1 / F-1 registrations naming the firm (counts for every key). The full deal list and the pipeline rows are included in Signal8 Pro; for other keys they are null with `dealsLocked` / `locked` true. Percent figures are percent. Every median and share carries `n`, the deals measured; a median is null when fewer than 5 deals were measured. A null, absent or withheld value means not measured, not zero and not "none"; a pipeline `registrations` count of null means the S-1 catalog was not available. A deal with several agents counts once for each firm. Each firm row also carries `last12Months` (the same figures over deals priced in the last 12 months) and `roles` (deals led, co-managed, and not determinable, read from the placement-agent text; a role the text does not determine is never counted as led); the firm view adds `headline` (all deals and led-only, all time and last 12 months) and `byYear` (median Day 1 per calendar year). `atmPrograms` counts at-the-market programs naming the firm as ATM sales agent; they are never counted as deals or in any deal figure, and a firm named only as an ATM sales agent can be looked up by name with dealCount 0. Historical figures, not a rating of any firm. An unavailable feature is an HTTP 503 error (FEATURE_DISABLED or UNDERWRITER_STATS_UNAVAILABLE), never an empty list. | read | false | unknown |
| get_upcoming_reverse_splits Reverse stock splits scheduled to take effect within a day-offset window of the current US market day, for companies under a market-cap ceiling. Offsets are days from today on the US market calendar: fromOffset=1, toOffset=1 is tomorrow; fromOffset=1, toOffset=7 is the week ahead. Each row carries the ticker, company name, the exact vendor integers (splitFrom/splitTo), a pre-rendered ratio ("1-for-20"), the effective date, market cap, float in shares, and price. floatShares is on the same split basis as the market cap. floatBasis says what it is: "measured", or "estimate" / "estimate_rebased" (the float ladder's point estimate, moved across this split when it predates it), i.e. an estimate rather than a measurement. floatShares: null means not measured or withheld, not zero and not "no float"; such rows are included (they have a valid market cap) and floatWithheldReason gives the reason. floatUnknownCount counts those null-float rows in the list; it is not a withholding count (withheldCount is). price is on the same split basis as the market cap (null when it cannot be stated on one basis), so it is not comparable with a pre-split price from elsewhere. Rows are splits scheduled as of now, not a guarantee that every split effective in the window is already known: the underlying stock_splits table has no created_at column, so when a row first appeared is unmeasurable, and a split announced later is simply missing. The result is "scheduled as of now", not "all" reverse splits. A scheduled split can also be postponed or cancelled after it is announced. capUnknownCount is a withholding count, not a zero: it counts rows that passed every other filter and were deliberately excluded because Signal8 has no measured market cap for them (typically real OTC microcaps). It does not mean those companies have no dilution, no split or no cap; the cap was not measured, so they cannot be asserted to sit under the stated ceiling, and with capUnknownCount above zero the list is not complete for an "under $Xm" framing. Funds, ETFs and sub-1.5x fractional ratio adjustments are already removed server-side, and the ratio is the vendor's. An empty splits array is a normal, common result: most single weekdays have no sub-cap reverse split scheduled at all. It is not an error, not a failure and not evidence that reverse-split activity has stopped. includeLifecycle=true adds Signal8's SEC-filing lifecycle tracker: top-level lifecycleAvailable, and per row `lifecycle` = the tracked episode (state, ratio, ratioRange, meetingDate, the issuer-stated effectiveDate, effectiveCondition, verification, asOf, sourceUrl). lifecycle: null means no episode tracked, not "no split" and not a contradiction of the calendar row; a row with no lifecycle key could not be matched to an SEC registrant (not measured). lifecycleAvailable: false means the tracker is switched off or unreadable, so the response carries no lifecycle information. verification "provisional" = one source, not cross-checked. Scope: this is the vendor market calendar only. The merged list the Signal8 Reverse Splits page shows (the calendar union the SEC-filing tracker, one row per security, with the stage, approval route, authority terms, source filings and the Approved-no-date / Vote-pending tabs) is a separate cross-company list. | read | false | unknown |
| get_volume_profile Get the volume distribution across price levels for a single trading day: price buckets with volume, the Point of Control (highest-volume level) and the Value Area (the price range containing 70% of volume), which locate support, resistance and high-volume price nodes. | read | false | unknown |
| lookup_accession_number Look up a filing or exhibit by its SEC accession number. Supports both dashed format (e.g., "0001193125-22-010026") and compact 18-digit format. Returns filing metadata including company name, form type, filing date, exhibit count and `filingId` (the internal id of the stored filing). If the filing is held in Signal8's archive (isInDatabase: true) its content is readable through that filingId; if it is only found on SEC EDGAR the response has isInDatabase: false and basic metadata only. | read | false | unknown |
| screen_companies Screen companies by price range, volume, cash runway, float, shares outstanding, market cap, industry, listing exchange (NASDAQ/NYSE/AMEX), listing market (market="otc" / "exchange"; the reliable OTC test, as the exchange label is inconsistent on OTC rows), float data source, TTM dividend yield and snapshot cash (minCash / maxCash). Sortable by any sortable column. Returns matching companies with key metrics and pagination. Float: "float" is the measured point float (null on a withheld dilution-snapshot row, which then carries "floatEstimate" + "floatEstimateBound" ("point" / "ceiling" / "floor") + "floatEstimateBasis"). A point estimate is a number with its basis as the caveat; a ceiling or floor is a bound, not a figure: the float is not stated and is at most (ceiling) or at least (floor) that number. floatEstimate is not a basis for a market cap, percent-of-float or short-interest ratio. minFloat / maxFloat and the computed_float sort use the figure's value, so a bounded row is kept; a row with neither is not measured, not 0. `shares_outstanding` is dated by `sharesOutstandingAsOf` + `sharesOutstandingAsOfKind` (stated / checked / none = date not recorded) and `sharesOutstandingSource`; the count is only meaningful with its date. Cash runway: a null cash_runway_months carries cashRunwayReason. "estimate_would_be_negative" = the last cash figure (dated cashRunwayAsOf) rolled forward by burn is below zero: estimated exhausted, not a reported zero balance; maxCashRunway drops such rows unless includeRunwayExhausted=true. Any other or null reason is not a runway claim. estimatedCurrentCash (estimatedCashAsOf) is the snapshot's USD cash projection, only for snapshot-covered companies: null = not measured, not "no cash"; a non-USD filer has it null and is never matched by minCash / maxCash. dividendYield (TTM cash dividends with an ex-date in the last 365 days / current price, %), nextExDate, lastExDate: null = not measured or not a payer, not 0%. listingMarket: "exchange" / "otc", null = unknown. Each row carries live trading-halt status (halted/haltCode/haltedAt; false/null when trading normally); excludeHalted=true drops currently-halted tickers. | read | false | unknown |
| screen_must_raise Companies with imminent capital raise needs based on estimated cash runway. Defaults to companies with less than 6 months of cash remaining, sorted by urgency (lowest runway first): distressed companies, imminent dilution situations and potential financing catalysts. Runway is estimated from the current burn rate. Companies whose estimated cash is already exhausted are included by default and listed first: they carry cash_runway_months null with cashRunwayReason "estimate_would_be_negative" (the last cash figure, dated cashRunwayAsOf, rolled forward by the burn rate is below zero today). That is an estimate from a dated balance (estimated exhausted as of today, from the last cash figure as of cashRunwayAsOf), not a reported zero balance and not a statement that the company has no cash. Rows also carry estimatedCurrentCash / estimatedCashAsOf (dilution-snapshot cash projection; null = not measured) and listingMarket. | unknown | unknown | unknown |
| screen_sec_filings Screen SEC filings across all companies with company-level filters (sector, industry, market cap, exchange) combined with filing-level filters (form type, date range). Returns filings enriched with company metadata: ticker, sector, industry, exchange, market cap, and price. Answers questions like "all S-1 filings from biotech companies under $500M market cap" or "recent 8-K filings from Technology sector companies". Results are filings, not a company universe or a company count. Only the 500 largest matching companies by market cap are searched (narrower filters reach smaller ones). Filters for float, price, company type, foreign issuer, recent IPO, full-text queries and 8-K item codes are not available here. Coverage: Signal8's SEC EDGAR archive, updated through the day, in its held range (see `archiveFrom` in each response; currently from late 2021, expanding back to 2016 as the history backfill fills in). Before archiveFrom it holds only a scatter, so absence before archiveFrom is not evidence a filing was never filed; SEC EDGAR itself covers earlier periods. Record-only rows (bodyStored: false) have no stored body; the document is at its sec.gov URL. | read | false | unknown |
| screen_sec_filings_performance Analyze stock price performance after SEC filings. Returns individual filing records with pre-computed price returns at +1 day, +3 days, +7 days, and +30 days after the filing date (numbers in percent points: 4.35 = +4.35%; null = not measured), plus aggregate statistics (average, median, % negative, best, worst) across all matching filings. Company-level filters (sector, industry, market cap, exchange) combine with filing filters (form type, date range). Answers questions like "how did biotech stocks perform after S-1 filings?" or "what was the average 7-day return after 8-K filings from companies under $500M market cap?". These are past returns, not a forecast. | read | false | unknown |
| search_clinical_trials Search clinical trials market-wide (across companies), filtered by phase, indication, sponsor, status and date window, with sorting and pagination. An unrecognised phase, status, dateField or sort value is rejected with the allowed list (it is never silently ignored). A result's ticker is the company whose trial list the row was collected under, which may be the lead sponsor or only a collaborator; metadata.sponsor is the lead sponsor, so a row is that ticker's own trial only when metadata.sponsor is that company. | read | false | unknown |
| search_companies Search for companies by name, ticker symbol or SEC CIK in the Signal8 database. Returns matching companies with their ticker, name, CIK, and exchange. A numeric query is matched as a CIK (`matchedBy: "cik"`). A ticker no company holds today is matched as a FORMER symbol of a renamed or delisted company (`matchedBy: "former_symbol"`, e.g. "MIGI" finds Big Digital Energy, now BGDE); a delisted company has `currentSymbol: null` and empty `tickers`. | read | false | unknown |
| search_filing_text Full-text search across SEC filing content that returns the matching passage: one match per filing, with the exhibit it was found in (`exhibit_id`, `exhibit_type`) and a snippet with context. Query syntax: unquoted words all have to appear (any order, any distance); "quoted phrase" = exact wording; OR between alternatives (merger OR acquisition); -word or -"phrase" to exclude; w1 NEAR/10 w2 (also NEAR(10), or bare NEAR = within 10) = words close together; word* = prefix of 4+ letters (dilut* matches dilution, dilutive); $AAPL or a capitalised ticker scopes to that company; a form code (8-K, 10-Q, S-1), "item 5.02" / "8-K 1.05" and a bare year (2024) scope to that form / 8-K item / year. Quoted multi-word phrases match as phrases; the archive's reading of the query is in meta.understanding. Suited to locating specific clauses ("change of control", "anti-dilution", "right of first refusal") and to the excerpt of a known filing (accessionNumber or filingId). It has no filing-level paging, totals, date ranges, 8-K item, excluded-form or company filters. Filters: CIK, filing, accession number, form type, section (risk_factors, mdna, ex99 …; applied only when meta.sections confirms it, otherwise meta.unsupported says the whole filing was searched) and exhibitTypes (EX-10 …). Coverage: Signal8's SEC EDGAR archive, updated through the day, in its held range (see `archiveFrom` in each response; currently from late 2021, expanding back to 2016 as the history backfill fills in). Before archiveFrom it holds only a scatter, so absence before archiveFrom is not evidence a filing was never filed; SEC EDGAR itself covers earlier periods. Record-only rows (bodyStored: false) have no stored body; the document is at its sec.gov URL. | read | false | unknown |
| search_institutions Search institutional investors (13F filers) by name. Returns matching institutions with CIK, name, AUM, holdings count, and latest filing period. Matches part of a fund or investment manager name (e.g., "Vanguard", "BlackRock", "Citadel"). Results are ranked by AUM descending. | read | false | unknown |
| search_learn_guides Free: works without an API key or Pro plan (the hosted server only needs a signed-in account). Searches the Signal8 Academy (signal8.ai/learn): plain-English guides that explain dilution (ATMs, warrants, convertibles, baby shelf, cash runway), how to read SEC filings (8-K items, Form 4 codes, 13D/13G, 424B5, S-1/S-3), market structure (halts, short interest, float, reverse splits, STOCK Act disclosures) and how Signal8 works. Returns matching guides with title, description, track, section, reading time, lastVerified date, the public url and the signal8:// resource uri, without bodies. Keyword match: every query word must appear somewhere in the guide; title hits rank highest. An empty query lists every guide (optionally one track) in reading order. An empty result means no guide matched the words given (fewer or broader words match more guides, e.g. "warrant" rather than "warrant inducement repricing"), not that the topic is unimportant. | read | false | unknown |
| search_sec_filings Search and list SEC filings by company (CIK), form type, date range, 8-K item codes and excluded forms, optionally with a full-text query over filing bodies and by company facts (market cap, float, price, sector, industry, exchange, company type, foreign issuer, recent IPO). Rows carry `id` (the internal filingId used by the filing-document and exhibit tools), cik, company_name, accession_number, form_type, filing_date, acceptedAt, primaryDocument, bodyStored and itemNumbers (plus `rank` and `snippet` with `q`); `pagination` has `total`, `totalRelation` ("eq" exact; "gte" a lower bound cut at 10,000, when `totalEstimate` is "about N"), `hasMore` and `nextCursor`. The `ciks` filter matches the filing's own CIK: a Form 4 filed under the reporting owner's CIK is not returned for the issuer's CIK. Coverage: Signal8's SEC EDGAR archive, updated through the day, in its held range (see `archiveFrom` in each response; currently from late 2021, expanding back to 2016 as the history backfill fills in). Before archiveFrom it holds only a scatter, so absence before archiveFrom is not evidence a filing was never filed; SEC EDGAR itself covers earlier periods. Record-only rows (bodyStored: false) have no stored body; the document is at its sec.gov URL. Every response carries `archiveFrom` and `rangeStartsBeforeArchive`: a range with no dateFrom or starting before archiveFrom is not definitive (`searchIndex.complete: false`, `reason: "outside_held_range"`, `heldFrom`): an empty result then means the archive holds no match from archiveFrom onward, not that no such filing exists. An empty text result is definitive only when `searchIndex.complete` is true. Full-text `q`: Query syntax: unquoted words all have to appear (any order, any distance); "quoted phrase" = exact wording; OR between alternatives (merger OR acquisition); -word or -"phrase" to exclude; w1 NEAR/10 w2 (also NEAR(10), or bare NEAR = within 10) = words close together; word* = prefix of 4+ letters (dilut* matches dilution, dilutive); $AAPL or a capitalised ticker scopes to that company; a form code (8-K, 10-Q, S-1), "item 5.02" / "8-K 1.05" and a bare year (2024) scope to that form / 8-K item / year. The archive's reading of the query is in `meta.understanding` (understand=false searches the words literally). facets=true adds `facets` per form / year / 8-K item over the whole result set (absent = not measured, never zero). sort=relevance caps page 1 per company; meta.diversity {maxPerCompany, hidden} names who has more (page with nextCursor or filter by CIK). section / exhibitTypes filters apply only when meta.sections / appliedFilters confirm them; otherwise meta.unsupported says why and the whole filing was searched. Company filters (minMarketCap … recentIpo): only issuer-filed forms are searched (third-party Form 4 / 144 / 13D/G go to `companyFilter.droppedForms` unless `companyFilter.subjectMatch` is true; with no formTypes the default is 10-K, 10-Q, 8-K, S-1, S-3, DEF 14A, 20-F, 40-F, 6-K); companies with no measured value are excluded, never assumed (`companyFilter.unknown` counts them); an unknown value is a 400 listing allowed names; when the archive cannot answer, the call fails with COMPANY_FILTER_NOT_APPLIED and never returns unfiltered rows; results are cursor-paged, cannot combine with acceptedFrom/acceptedTo/bodyStored, and carry no snippet. Results are filings, not a company list or count. | read | false | unknown |
02Install & source
Hosted · connect by URL
https://mcp.signal8.ai/mcp
- repohttps://github.com/signal8ai/signal8-mcp
- homepagehttps://mcp.signal8.ai/mcp
- licenseMIT
- adoption74 stars · 1 forks
03Access granted
Financial data · writeRead calendar · writePublish a post · write
The access this server can exercise, inferred from its verified tools — not a declared OAuth scope.
05Provenance & freshness
sourcesOfficial MCP Registry [p1]
last_checked2026-11-19 19:41Z
next_check2026-11-19 22:41Z
cadenceevery 3h
verifiedmetadata:passed tools_list:passed handshake:passed metadata:passed tools_list:passed handshake:passed metadata:passed tools_list:passed handshake:passed metadata:passed
index_statusindex — 9 unique facts >= 5
06Badge
Add the “as seen on MCPExplorer” badge to your README.
[](https://mcpexplorer.com/servers/signal8)
Next step
This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.
Explore loadouts →