Sign in
radar

Rank market or saved-watchlist news activity

Descriptive news-activity ranking. Free delay 3600 seconds; Basic 900 seconds; Pro no added delay. Tier and watchlist owner come from authentication, never query parameters. The public API requires a Bearer API key and uses the normal request quotas. The whole snapshot, including supporting headlines and company names, is selected at or before wall-clock time minus the tier delay. Snapshots refresh every minute and are retained for three hours. Collection and enrichment add processing time. preview_reference_at is null in live mode; a frozen development preview uses that historical clock instead and explicitly reports freshness.mode=historical_preview. as_of is the actual selected cutoff. Only tickers with current-window news appear. snapshot_id identifies immutable content including public evidence metadata. freshness states the effective delay, generation time, source check time and latest enrichment observed. Missing history or a producer more than four minutes behind returns 503, never newer data in place of a delayed snapshot. watchlist_coverage separates known quiet names from names absent from the snapshot; absent does not mean an invalid symbol. Summary is scoped before search/ticker/sentiment/min_z filters and pagination; universe describes the entire stored snapshot. Null metrics stay null. Collection coverage is unverified; these calculations are not point-in-time backtests or confirmed alerts. Historical corrections can affect the model baseline. All responses: private, no-store. event_context reports separate SEC/insider availability, cutoff, generation time, age_seconds at the numeric cutoff (not HTTP time), and lookback windows. results[].event_context contains only that row's issuer-CIK context: up to 3 recent 8-K/6-K filings over 7 days by filed_at and up to 3 open-market insider clusters over 30 days by known_at (the latest SEC filing time). Counts cover all eligible records; arrays contain the newest records. Each cluster includes up to 5 SEC evidence links, filings_count and evidence_truncated. 6-K coverage is selected ingested earnings releases only. Filings also carry news_uid, news_title, news_published and has_article for AlphAI article links. has_article means enrichment existed before the context cutoff; older snapshots default to false with null title/publication metadata. SEC URLs remain available as sec_url. Share classes with the same CIK share context, without changing news counts, scores, filters, ranking or row eligibility. No USD totals are reported. Context and its evidence follow the same tier delay and cursor; later corrections appear only in new snapshots. Context older than max_age_seconds=300 at the numeric cutoff is unavailable. Missing, disabled, stale or failed context does not fail news readings. Unavailable context has null row context; a row also has null context when it is absent from the context snapshot. Unsupported or unidentified issuers have explicit row status/reason and null counts. Supported issuers with no eligible stored records have zero counts. Available does not certify complete SEC coverage. Unknown or repeated query parameters are rejected.

get/api/signals/snapshot/

Query parameters

window'4h' | '24h'

Window ending at as_of, not at wall-clock now.

scope'market' | 'watchlist'

market scans all tickers without a tier ticker cap. watchlist requires authentication and reads only the caller's existing saved symbols, matched exactly. An empty list returns no results. Existing watchlist entitlements apply (default Free 10, Basic/Pro unlimited); no separate Radar allowance.

market'all' | 'us_equity' | 'crypto' | 'international'

Filter within the selected scope; international includes all intl:* markets.

tickerstring

One exact ticker, case-insensitive. No alias expansion. Mutually exclusive with tickers.

tickersstring

Comma-separated exact symbols, case-insensitive. No tier ticker cap; request text is bounded to 16384 characters. Applied within scope, so it never bypasses watchlist ownership.

searchstring

Case-insensitive ticker substring for interactive search. Separate from exact ticker selection.

sort'score' | 'stories' | 'model_stories' | 'sentiment' | 'sentiment_change'

score, stories (total), model_stories, sentiment or sentiment_change (current minus prior window). Missing values last; ties use total story count then ticker.

order'asc' | 'desc'

asc or desc (default). Missing metrics always remain last.

sentiment'all' | 'positive' | 'negative' | 'mixed'

all, positive (>0.15), negative (<-0.15), mixed (inclusive -0.15 through 0.15). Null metrics match only all.

min_znumber nullable

Minimum descriptive activity score, not a confirmed candidate filter.

limitinteger

Page size only, never a tier ticker cap. Follow next_cursor with the same filters and page size.

offsetinteger

Legacy zero-based pagination without snapshot pinning. Prefer cursor; cannot combine a nonzero offset with cursor.

cursorstring

Opaque signed next_cursor or previous_cursor. Pins the complete snapshot, filters, tier and watchlist membership/owner. A changed context, removed snapshot or replaced content returns 409; restart without cursor. Never edit the token.

Response

Eligible snapshot and effective access rules

snapshot_idstring required
methodology_versionstring required
research_onlyboolean
point_in_timeboolean
as_ofstring date-time required
preview_reference_atstring date-time nullable required
window'4h' | '24h' required
limitationsstring[] required
input_hashesobject required
universeinteger required
totalinteger required
offsetinteger required
next_offsetinteger nullable required
next_cursorstring nullable required
previous_cursorstring nullable required

Changes

Changed in 2 of the 16 revisions of this API.3

  • 44fde16b286e2See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

  • 1d7682bf33f01See the full diff
    • ○

      endpoint added

      endpoint-added