alerts

List Alerts

This user's alerts, paged in either trading-day direction and optionally narrowed.

Current assessment projections include append-only corrections while preserving original alert IDs and source evidence.

Filtering belongs on the server because every reader asks for a page at a time. Narrowing client-side would filter what was already fetched and show a fraction of it, when what the reader asked for is a full page of matches.

Offset paging rather than a cursor. The ordering is composite -- trading day, then whether the ticker carries a thesis, then time -- and a cursor over three keys is a great deal of machinery for a feed that gains rows once a day from a scheduled sweep. The known cost is that an alert arriving mid-scroll can shift a row across a page boundary; for a home-page preview that is a duplicate line, not a lost one.

get/alerts

Request

  • Base URL: https://api.tickertrac.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.tickertrac.com/alerts
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

limitinteger
offsetinteger
tickerstring nullable
sourcestring nullable
impactstring nullable
sort_order'newest' | 'oldest'

Response

Successful Response

idinteger required
watchlist_idinteger nullable required
tickerstring required
sourcestring required
titlestring required
summarystring required
source_urlstring nullable required
company_transcript_urlstring nullable
detected_atstring date-time required
evidencestring nullable
thesis_textstring nullable
materiality'material' | 'immaterial' | 'uncertain' | 'unknown'
relevance_modelstring nullable
evaluation_versionstring nullable
relationship'support' | 'contradict' | 'neutral'
directness'direct' | 'indirect' | 'none' | 'unknown'
source_quality'primary' | 'reputable_secondary' | 'weak' | 'invalid' | 'unknown'
novelty'new' | 'known' | 'duplicate' | 'unknown'
citation_validboolean
bridge_validboolean
thesis_factorstring nullable
evidence_factorstring nullable
causal_bridgestring nullable
thesis_factor_kind'claim' | 'expectation' | 'invalidation' | 'narrative' | 'unknown'
thesis_impact'strengthened' | 'weakened' | 'broken' | 'uncertain'
source_locatorstring nullable
source_artifact_version_idinteger nullable
source_segment_idinteger nullable
source_speaker_namestring nullable
source_sectionstring nullable
source_provider_codestring nullable
source_provider_item_idstring nullable
thesis_context_type'ticker' | 'shared'
shared_thesis_idinteger nullable
shared_thesis_version_idinteger nullable
shared_thesis_version_numberinteger nullable
shared_thesis_titlestring nullable
shared_thesis_effect'tailwind' | 'headwind' | 'mixed' | 'uncertain' nullable
shared_thesis_rationalestring nullable
feedback_labelsstring[]
has_thesisboolean

Changes

No recorded changes to this operation across all 1 revision of this API.