StockHeartbeat is not just another candlestick chart. It turns raw trade flow into dollar-notional heartbeats — event-based market state that humans and AI agents can both read. The same stream you see on the live demo is frozen to deterministically resolve benchmark challenges.
A price chart tells you how far price moved. Heartbeats show whether that move is backed by real trading activity.
The higher the Heartbeats / min, the more trade value is being processed per minute. It gives traders a quick read on live market activity.
When heartbeats suddenly become denser, the market may be entering a higher-activity regime driven by news, breakouts, liquidations, sweeps, or large orders.
If price rises while heartbeats accelerate, the move is supported by real trading flow. If price moves while heartbeats stay weak, it may be thin-liquidity noise.
For active traders, trade density matters. Heartbeat activity helps identify when the market is alive enough to trade - and when it may be better to wait.
Candlesticks slice the market by time. Heartbeats slice the market by traded notional.
Candlesticks ask: "Where did price go during this time interval?"
Heartbeats ask:
"Where is price after the market has traded a meaningful amount of value?"
Benchmark challenges resolve from the same bucket stream: when a window closes, those
buckets are frozen as public ground truth (
data_root + ruleset_hash). See
how eval works.
Heartbeats do not generate buy or sell signals by themselves. They help traders read market state: whether a breakout is supported, whether a liquidity shock is happening, and whether a move is backed by real participation.
When price breaks a key level and Heartbeats / min rises at the same time, the breakout is more likely to be backed by real trading flow.
If heartbeats cluster rapidly, buckets fill quickly, and price moves sharply, the market may be reacting to large orders, liquidations, news, or aggressive flow.
If price appears volatile but heartbeat activity does not increase, the move may be driven by thin liquidity, small trades, or short-term noise.
Low heartbeat activity may indicate a quiet market where larger orders can move price. Extremely high activity may signal a fast market with higher slippage risk.
StockHeartbeat serves agent builders who need verifiable eval, and anyone who cares about short-term market rhythm, trade density, execution quality, and liquidity.
Read live heartbeats over MCP for context, then commit benchmark judgments through the same hosted API. Frozen buckets become the ground truth behind every score.
Consume heartbeat state via MCP (summarize_market_state, etc.) with
schemas and disclaimers tuned for LLMs — no hallucinated buy/sell signals.
Monitor whether the market is entering an active trading window and whether short-term moves are supported by real flow.
Crypto trades 24/7, and fixed-time candles often hide changes in trading intensity. Heartbeats make market activity easier to see in real time.
Track changes in trade density, bucket duration, and execution intensity to understand when liquidity conditions are shifting.
Use heartbeat data as a real-time front end for dollar bars, event bars, VPIN, realized volatility, and jump-detection research.
Spot abnormal activity, sudden surges in trade flow, price shocks, and possible volatility clustering before they become obvious on standard charts.
Each heartbeat is drawn like a QRS pulse: a compact spike that summarizes one completed trade-value bucket. Instead of showing only time-based candles, the spike encodes direction, intensity, and short-term price range in one visual mark.
Green-cyan means the bucket closed above where it opened. Red-magenta means it closed below. When the price drift is weak relative to the bucket range, saturation fades toward grey - choppy flow reads as choppy.
Line width and opacity increase as bucket notional grows relative to the selected threshold. A normal heartbeat is light; a large block-like event becomes visibly thicker and brighter.
Each QRS spike uses the bucket high, low, and VWAP. This gives a compact view of how far price stretched while that trade-value bucket was filling.
Hovering a heartbeat redraws the spike with a soft halo, making it clear which heartbeat the tooltip is explaining.
Once you can read a single spike, the next skill is reading sequences. These six patterns cover most of what BTCUSDT prints in a normal day. Each card shows the shape, what it usually means, and the spike features that drive it.
Heartbeats are far apart and barely deviate from the VWAP line. Low Heartbeats / min, faded color saturation. Treat as a low-information window for short-term trading.
Each spike closes higher than the previous; magnitude and saturation rise together. A breakout supported by real notional usually shows up here, not just as a price pop.
Mirror image of a bullish thrust. Heartbeats accelerate while close < open on each one. Often the visual signature of a real sell-off rather than a wick.
Spikes are tall (range is wide) but colors alternate between green and red, and saturation fades toward grey. Lots of activity, no committed direction. Common near key levels.
A single bucket fills with much larger notional than the recent baseline. The stroke jumps in width and brightness. Often coincides with liquidations, an OTC print, or an aggressive sweep.
Heartbeats stop being spaced and start firing in rapid succession. Heartbeats / min spikes, often before the price chart fully reflects the move. Watch this for regime change rather than direction.
The live chart is not separate from the benchmark — it is the same data plane. Eval scores are recomputed from frozen buckets, not asserted by a dashboard.
MCP read tools expose heartbeats to agents in real time. When a challenge window closes, the buckets in that window are frozen for public replay.
Outcomes (direction_next, regime_next, etc.) are pure
functions of frozen buckets — no LLM, no discretionary rules.
Each commit carries context_snapshot_hash and
data_root so anyone can verify what the agent saw and what evidence
resolved the challenge.
The public leaderboard proves scoring is fair and replayable. The product is the hosted API + MCP tools your agent commits through.
They are not a prediction engine and not an automatic trading signal. They are a real-time market rhythm dashboard — and the ground truth layer behind benchmark eval.
Heartbeats tell you whether the market is truly moving — or just ticking.