This page hasn't been translated yet. Showing English version.

Event Catalyst

Catalyst detection and surfacing — the system that attaches a why to every meaningful price move.

What this is

Most price moves don’t come out of nowhere — they ride catalysts. Event Catalyst is TRUE’s system for detecting those events early, classifying them, and explaining them simply. It’s what lets the chat say “SOL just broke a level because the FTX estate just unstaked X” instead of just the first half.

Pipeline

Ingest

News feeds, on-chain anomalies, exchange announcements, social velocity.

Classify

Type (listing, regulatory, hack, macro, partnership, unlock) + magnitude.

Sentiment

Directional read with confidence, run through news-agent.

Attribute

Match the event to one or more affected assets via the asset graph.

Surface

Promote into Highlights, push to watchlists, feed signal-agent.

Event taxonomy

Every classified event carries one of six type tags and a magnitude (1–5). Magnitude is computed from a weighted blend of source authority, asset market cap, social velocity, and on-chain anomaly score. The tags:

Listing — a CEX/DEX adds or removes a market.
Regulatory — enforcement, framework, ETF, jurisdictional change.
Hack — exploit, exit scam, bridge incident, validator failure.
Macro — Fed action, CPI, FX shock, geopolitical event.
Partnership — protocol integration, distribution deal.
Unlock — token unlock, vesting cliff, staking unlock window.

TRUE Highlights

Highlights are the user-facing form of catalyst events: short, illustrated cards with a CTA, multilingual, time-limited. They’re authored partly by the news-agent and curated by the editorial team. Each Highlight carries a tag taxonomy that lets the home feed mix breaking events with evergreen explainers.

Why this matters

A price chart without context is noise. Event Catalyst attaches a why to every meaningful move so users can decide whether the move reflects new information they care about or noise they should ignore. The signal-agent uses the same attribution to compute the cleanliness axis on signals — a signal generated into a fresh catalyst is automatically lower-cleanliness.

For Users

Highlights appear on the home feed, sorted by relevance to your watchlist and tags you follow. You can mute a tag entirely (no more macro Highlights, for instance) or pin one for the top of the feed. Time-limited Highlights expire automatically — you’ll never see a “what just happened” card three days after the fact.

For Developers

Getting catalyst events

Catalysts are read through the MCP tools and the REST surface. There is no outbound webhook product today, so poll on your own cadence or hold a stream open rather than registering a callback URL.

Event shape

{
  "id": "evt_01JX9...",
  "type": "regulatory",
  "magnitude": 4,
  "sentiment": { "direction": "negative", "confidence": 0.81 },
  "headline": "...",
  "summary": "...",
  "assets": ["BTC", "ETH"],
  "sources": [
    { "url": "https://...", "publisher": "...", "fetched_at": "2026-04-29T12:34:56Z" }
  ],
  "first_seen_at": "2026-04-29T12:34:50Z",
  "last_updated_at": "2026-04-29T12:35:14Z",
  "dedup_key": "reg-20260429-..."
}

Replay endpoint

For catastrophic events (hacks, regulatory shocks), historical detail is available via the replay endpoint. Use it to backfill a missed window during downstream downtime.

curl -G "https://app.truefinance.ai/api/alerts/catalyst" \
  --data-urlencode "from=2026-04-29T00:00:00Z" \
  --data-urlencode "to=2026-04-29T23:59:59Z" \
  -H "Authorization: Bearer $TRUE_TOKEN"

Safety

Sentiment is approximate, not predictive. Direction labels reflect a snapshot read of newsroom tone and on-chain reaction in the first minutes — they can flip as more information surfaces. Never trade on a single headline. The asset-graph attribution can over-attribute when projects share contributors or share a parent foundation; a Highlight tagged on Asset A may also move Asset B without TRUE having attributed it.

Safety, limits, failure modes

Source latency. Some publishers update slowly; on-chain anomalies are typically faster than newsroom coverage.
Cross-source dedup. Events from multiple sources collapse to a single Highlight with a list of source URLs. Dedup keys are stable for replay.
Sentiment flip. Re-evaluation runs on a 5-minute cadence in the first hour, then 30-minute cadence. Webhooks emit catalyst.updated on every flip.
Attribution drift. The asset graph is curated; if you spot a wrong attribution, please report — the editorial loop is open.