HookScreener Data API

Beta

Detected market microstructure — as an API

Liquidity walls with lifecycle, algo-flow detections, spikes and pushing patterns from 16 spot & futures sources. Derived events, not raw quotes.

Get a free API keyDocumentation — coming soonPlayground — coming soon

Products

Liquidity Walls API

Standing limit-order walls across our spot and futures order-book streams.

Walls currently standing in the book, per coin and side.

Lifecycle: when a wall appeared and when it was gone.

Bucket-based prices and size tiers — context without order-book reconstruction.

Market Events API

Every detection type in one queryable event stream.

Walls, algo-flow, spikes and pushing patterns as unified events.

History with filters by coin, type, side and market.

Scored outcomes: price paths at fixed horizons after each event.

Algo Flow API — coming next.

Sample payload

One event, one JSON object

Payloads are bucket-based by design: prices and sizes arrive as tiers, not exact order-book levels.

{
  "id": 48201,
  "ts": 1754000000000,
  "coin": "SOL",
  "type": "wall",
  "side": "BID",
  "market": "spot",
  "source": "bybit",
  "price_bucket": "171-172",
  "size_usd_tier": "100k-250k",
  "status": "standing",
  "distance_to_spread_pct": 0.4,
  "age_seconds": 540,
  "detector_version": "2026-08-10"
}

How it works

From key to first query in three steps

1
Get a key
Free keys are self-service: sign in and create one on your profile page. Paid tiers are TBA during beta.
2
Call /v1/events
One authenticated GET returns detected events, filterable by coin, type, side and market.
3
Build
Feed the events into your dashboards, alerts, backtests or research pipelines.

curl -H 'X-API-Key: hs_live_...' https://hookscreener.com/v1/events?type=wall

Service status is public at /v1/health.

Pricing

Plans

Free

Delayed 15 minutes

1,000 requests / month

Starter

TBA

Recent events and standing walls

Higher rate limits

Pro

TBA

Full history with scored outcomes

Priority support

Quant

TBA

Bulk export, custom horizons

White-label options

Beta — pricing is not final. Free keys are self-service via your profile; paid tiers TBA during beta.

Embed / white-label our event feed

Run the detected-event stream inside your terminal, community or product — under your branding, with your limits.

Read this first

Limitations & legal

All data are derived, detected events computed by heuristic detectors over public exchange streams — not raw market data.
Classifications (walls, algo-flow, spikes, pushing) are heuristic labels; they are not statements about any market participant's identity or intent.
Data may be delayed, incomplete or revised; detectors and payload schemas evolve between versions.
Nothing in this API is investment advice or a recommendation to trade.
HookScreener is not affiliated with or endorsed by any exchange.
Payloads are bucket-based by design: prices and sizes are published as buckets and tiers, not exact order-book levels.

FAQ

Questions & answers

What data does the API return?

Detection events: liquidity walls with lifecycle, algo-flow runs, spikes and pushing patterns — each as a compact JSON object with coin, side, market, source, bucketed price/size and timestamps. It's the output of our detectors, not quotes or candles.

How fresh is the data?

Events are published as detectors fire. The free tier is delayed 15 minutes; paid tiers are near real-time. Scored outcomes need their horizons to pass, so events younger than 24 hours are still partially pending.

How is this different from price APIs?

Price APIs give you what everyone already has: OHLCV, tickers, order books. This API gives you interpreted microstructure — what our detectors found inside the books and tape across 16 spot and futures sources — already filtered, labeled and scored.

How do I get a key during beta?

Free keys are self-service: sign in and create one on your profile page. For higher limits during beta, email us a couple of lines about your use case.