get_dilution_snapshot

Get the dilution snapshot header (the heaviest dilution call): 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. NO INSTRUMENT ROWS: call get_dilution_instruments per family, and get_dilution_coverage first.

Cash is in the filer's REPORTING currency: read cashPosition.currency (ISO 4217; null = not determined) and cashPosition.currencySource ("presumed_usd" is not a measurement) before calling it dollars (runway months are currency-neutral).

FLOAT: a non-null floatWithheldReason means the tradeable float was NOT MEASURED; never state it as a number. A declined block (available: false) may carry refusal.withheldReason, the exact value get_float serves.

tradeableFloatCeiling is an UPPER BOUND, NOT a float: never feed it to a market capitalisation, percent-of-float, short-interest ratio or comparison; say in words the float is at most that figure, with no ~ / ≤ / ≥ glyph.

BOUNDED TOTALS: a null total (potentialNewShares, totalWarrantShares, totalConvertibleShares, totalEquityPlanShares, totalExchangeableShares, totalRightsShares, potentialDilutionPercent) may sit beside <key>Bound: "ceiling", <key>Ceiling, <key>Floor: report "at most <ceiling>" and the floor as the measured part, never the ceiling as the total.

With potentialDilutionPercentBoundReason: "stated_count_denominator" there is NO floor: the ceiling divides by the last stated share count (as of potentialDilutionPercentCeilingShareCountAsOf); say "at most X%, against the count stated as of <date>".

notMeasuredReasons[] ({field, code, text, detail, expected {form, dueDate, status}}) says WHY a figure is null; quote it, never turn it into a value. expectedFilings[] lists the next periodic report(s); status: "late" means due by dueDate with none on file as of checkedOn (say exactly that, never speculate why); dueDate: null is not computed.

A kind: "annual_meeting" row (Nasdaq 5620(a) / NYSE 302.00) "late" means no 8-K Item 5.07 vote results on file, never that a meeting was missed.

SPAC RIGHTS: totalRightsShares (present only when the snapshot examined rights) is shares delivered to holders of SPAC unit rights on the initial business combination; it IS in potentialNewShares, and the rights lapse if no combination closes. rightsOverlapWarrantRows > 0: a warrant row also names rights, so the rights total and the headline are WITHHELD (null) rather than counted twice; say so.

RUNWAY beside goingConcern: true is a contradiction the auditors flagged: report both, never the runway alone. ALWAYS RETURNS 200: read available and reason, never the HTTP status. not_covered means this company has not been analysed yet, not that it has no dilution; an outage is a 5xx. NULL, absent or withheld means NOT MEASURED; it never means "no dilution", "no warrants", "no shelf" or zero.

A numeric 0 is a MEASURED zero and defeats a null check: decide from the availability/withheld/reason field, never from the value itself. Figures are as of meta.asOfDate, from filings read through meta.filingsThrough (a stale date predates anything filed since). Share counts are on one split basis; a row that cannot be rebased is omitted and counted, never published on a mixed basis.

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).