<div align="center">

Pulse

Short-horizon order-flow pulse engine for Robinhood crypto. Scores aggressive flow, buyer breadth, and liquidity migration before a burst becomes obvious on the chart.

Website

</div>

---

Most crypto alerts tell you that price moved. That is not enough. A real continuation setup depends on whether aggressive flow is broadening across the market, whether quoted depth is being consumed faster than it refills, and whether there is still enough topbook depth to exit without getting trapped.

Pulse ingests recent trade-flow and top-of-book snapshots from a Robinhood crypto watchlist, derives short-horizon flow metrics, and asks a Claude agent to validate whether the current burst looks like a durable momentum pulse or a shallow false break. The output is a pulse-aware alert stream with regime context, confidence, and a watchlist of assets where flow is compounding. The engine is intentionally stricter on thin books where a signal can look strong but still be hard to exit.

DETECT -> SCORE -> VALIDATE -> REGIME -> REPORT

---

Quant Dashboard • Validation Flow • At a Glance • Operating Surfaces • How It Works • Example Output • Technical Spec • Risk Controls • Quick Start

At a Glance

• Use case: short-horizon Robinhood crypto flow detection before the chart becomes obvious
• Primary input: trade imbalance, buyer acceleration, quoted-depth changes, order dispersion, slippage pressure
• Primary failure mode: mistaking a shallow burst for real continuation
• Best for: operators who need to know whether aggressive flow is compounding or already decaying

Quant Dashboard

<img src="assets/preview-dashboard.png" alt="Pulse quant dashboard" width="100%" />

Live order-flow board for Pulse: composite pulse score, regime state, flow components, asset watchlist, alert severity, and Claude's validation notes for each short-horizon setup.

Validation Flow

<img src="assets/preview-validation.png" alt="Pulse validation flow" width="100%" />

How Pulse validates a burst: market-flow snapshots become flow components, the pulse score is checked against topbook depth and slippage pressure, and only durable setups reach the bullish pulse report.

Operating Surfaces

• Quant Dashboard: shows composite pulse, regime state, and component breakdown
• Pulse Ladder: tracks whether a name is building, active, cooling down, or fading
• Validation Loop: asks the agent whether the pulse still looks tradeable after the first move
• Validation Flow: shows how raw flow becomes a durable or rejected pulse signal

What Pulse Is Actually Solving

The hard part of short-horizon Robinhood crypto trading is not noticing that activity increased. The hard part is noticing whether that activity is becoming more tradeable or less tradeable as it accelerates.

Pulse exists to make that distinction explicit. It is not trying to be a generic volume monitor. It is trying to answer whether a burst still has enough breadth and enough exit quality to matter.

How It Works

Pulse follows a five-step loop:

1. ingest recent trade-flow snapshots for tracked Robinhood crypto assets
2. derive the short-horizon components that make a burst meaningful
3. combine those components into a composite pulse score with regime logic
4. validate the score against slippage and topbook depth so the move is still executable
5. rank the surviving names into a pulse report the operator can actually use

That sequence matters because size alone is not a reliable signal. The board is designed to promote compounding flow and demote shallow optical bursts.

What A Good Pulse Looks Like

• trade imbalance is expanding, not just flickering
• buyer participation is broadening instead of staying concentrated
• liquidity is still refilling as the move develops
• slippage pressure is low enough that exits still look realistic

If those conditions break, the score should cool down quickly.

Example Output

PULSE // FLOW ALERT

[HIGH] BTC
pulse score        1.34
regime             bullish
buyer accel        strong
liq delta          positive
slippage pressure  12 bps

operator note: flow is broadening and depth still looks exitable

Technical Spec

Pulse builds a short-horizon composite score from five flow components:

Pulse_t = 0.30 * z(trade_imbalance_30s) + 0.25 * z(participation_accel_2m) + 0.20 * z(depth_delta_1m) + 0.15 * z(order_dispersion_5m - 0.5) - 0.10 * z(slippage_pressure_30s)

Where:

• trade_imbalance_30s measures directional aggression in the most recent burst window
• participation_accel_2m rewards broadening participation instead of isolated prints
• depth_delta_1m measures how quickly quoted depth is disappearing or refilling
• order_dispersion_5m penalizes overly concentrated flow
• slippage_pressure_30s penalizes setups that look good on paper but are hard to exit cleanly

Regime classification uses hysteresis so Pulse does not flap between states:

• enter bullish when pulseScore >= 1.25 and trailingPulseScore >= 0.40
• remain bullish until pulseScore < 0.60
• mark cooldown when either pulse or trailing confirmation drops below zero

Execution-quality guardrails:

• reject high-conviction pulses when topbookDepthUsd < MIN_TOPBOOK_DEPTH_USD
• cap conviction when slippagePressure30s > MAX_SLIPPAGE_PRESSURE_BPS
• increase re-entry delay as realized volatility expands relative to VOLATILITY_BASELINE_BPS

Severity is not just size-based. A mid-sized burst can still rank high if the pulse score is extreme and breadth confirms continuation.

Risk Controls

• depth filter: rejects bursts that are too thin to exit cleanly
• slippage cap: prevents high-scoring but untradeable setups from being promoted
• regime hysteresis: reduces flapping between bullish and cooldown states
• re-entry delay: slows the engine down when volatility expands too quickly

Pulse is intentionally strict because a fast signal without exit quality is usually worse than no signal at all.

Architecture

Robinhood crypto market-data feed
  -> flow metric enrichment
  -> pulse score + regime model
  -> Claude validation loop
  -> rolling pulse report

Quick Start

git clone https://github.com/PulseSolana/Pulse
cd Pulse && bun install
cp .env.example .env
bun run dev

Configuration

ANTHROPIC_API_KEY=sk-ant-...
ROBINHOOD_API_KEY=...
ROBINHOOD_API_SECRET=...
ROBINHOOD_BASE_URL=...
ALERT_THRESHOLD_USD=75000
BULLISH_PULSE_THRESHOLD=1.25
MIN_TOPBOOK_DEPTH_USD=25000
MAX_SLIPPAGE_PRESSURE_BPS=32
SCAN_INTERVAL_MS=30000

Legitimacy Notes

• Planned commit sequence: docs/commit-sequence.md
• Draft engineering issues: docs/issue-drafts.md

Support Docs

• Runbook
• Changelog
• Contributing
• Security

License

MIT

---

catch the burst before the breakout looks obvious.