Pulse API
Pulse is the interpreted event feed, the 'so what' layer. For a universe of symbols it scans the meaning-layer engines for notable conditions, pairs them with news, and interprets each event.
What it returns
The response returns an events array, a count, the universe scanned, a providers block, and a live flag. Each event carries symbol, kind (stretch, squeeze, shift, confluence, risk_regime, or news), headline, what_happened, who_is_moving (institutions, options, retail read), risk, lyramind_view, salience, and a trust block.
Derived events are capped at the two most salient per symbol; the feed returns up to 30 events overall.
When to use it
Use Pulse to power a market monitor or an agent's situational awareness across a watchlist. Pass ?symbols=NVDA,AAPL,MSFT to scope the universe; omit it to scan the default set (SPY, QQQ, NVDA, AAPL, MSFT, TSLA, AMD, META). Up to 20 symbols are processed.
Results are cached 2 minutes per universe key.
Notes and honesty
News is sourced through the news adapter: with POLYGON_API_KEY set it pulls real headlines, otherwise it returns clearly labeled sample items and the live flag is false. The interpretation is descriptive, never a buy or sell call.
- events: interpreted items with kind, headline, and salience
- who_is_moving: signal-derived institutions, options, retail read
- risk and lyramind_view per event
- universe and count of scanned symbols
- providers.news and live flag (true only on a real feed)
- trust envelope on every event
curl -s 'https://api.lyramindos.com/v1/pulse?symbols=NVDA,AAPL,MSFT' -H 'x-api-key: YOUR_KEY'
Questions
Is the news real?
It depends on configuration. With a Polygon key the feed pulls live headlines and sets live:true. Without one it returns clearly labeled sample items and live:false, so you always know the source.
How many symbols can I pass?
Up to 20 are processed per call, and the feed returns at most 30 events, capping derived events at the two most salient per symbol.
Does Pulse tell me what to trade?
No. Each event is a descriptive interpretation with a risk note and a skeptical view; it is educational only, never a buy or sell call.