News and Narratives
Use these endpoints when counts are not enough. They help attach a defensible cause, summary, or theme to a market move.
Token News
Token news returns token-related news mentions as sanitized mention objects with links and engagement metrics.
Use it to:
- Attach a cause to a move: go from price action to reported news rather than inventing a reason.
- Ground agent answers: cite real news mentions before summarizing.
- Separate catalysts from chatter: check whether a move has news behind it before acting on it.
Token News is still a measurement endpoint. It returns source links and metrics, not a prose explanation.
Event Summary
Event summary summarizes keyword mentions over a selected window and returns prose with source links.
Use it to:
- Find out what happened without reading everything: one call gives written summaries for the window.
- Skip the summarization pipeline: Elfa handles ingest, dedupe, clustering, and summary generation.
- Keep output defensible: source links travel with the summary.
- Fill a briefing: use the summary in a digest, alert, or client note.
This endpoint costs 5 credits because it replaces a pipeline you would otherwise build and maintain.
Trending Narratives
Trending narratives returns written narratives with source links for the prevailing market themes.
Use it to:
- See the theme, not only the ticker: understand what the market is talking about one level above individual tokens.
- Catch rotation early: narratives often move before the tokens inside them.
- Give an agent a regime: condition behavior on the prevailing market story rather than one strategy across every market.
- Hand someone a citation: narrative prose arrives with source links.
Trending Narratives costs 5 credits and requires Grow and above or PAYG on API-key access. It is also available through x402 pay-per-request.
Market Events Beta
Market Events is a proposed source-backed feed of newly detected market events. Each event includes impact, confidence, entities, tokens, evidence quality, and links to the public source documents that contributed to its cluster. Filter results by one or more entities or an inclusive from / to date range.
Source document entries contain only an ID and public link. The endpoint does not return tweet or Telegram message text, author profiles, media, or engagement metrics.
This endpoint is not available in production yet. Email sales@elfa.ai to request access.
Choosing Between Them
| Need | Endpoint |
|---|---|
| Evidence that news exists for a token move | token-news |
| A source-backed summary for a keyword window | event-summary |
| The themes currently winning market attention | trending-narratives |
| A source-backed feed of newly detected market events | market-events (Beta) |