Crypto Session Box Levels & Liquidity Sweep Detector

One run takes a list of Bybit USDT perpetuals and returns, per symbol: the prior session's box (high, low, midline, top and bottom zones) with where price sits in it, today's wick setup at the box edge with a reference entry, stop and target, and every liquidity sweep of the prior day and session extremes in the last hours. Built on 5-minute bars from Bybit's public market data. No API keys, no login.

Session-range traders redraw the same boxes every morning: yesterday's high and low, the Asia range, the London range. This Actor is that chart work as JSON, for alerts, dashboards, bots and AI agents that need the levels and the "did price just sweep a level and reclaim it" answer without a charting platform.

What you get

One row per symbol.

Field	Example
symbol, exchange, price	BTCUSDT, bybit, 73796.1
position	Where price sits against the box: above_box, upper_zone, middle, lower_zone, below_box
setupState	Today's wick setup: watching, trigger_forming, active, target_hit, stopped, invalid_setup, no_setup_today
sweepCount	Number of levels swept in the lookback window
box	The chosen session's box: boxFrom, boxTo, high, low, mid, width, widthPct, upperZone, lowerZone (top and bottom 20%), position, distanceToMidPct
wickSetup	Against the prior UTC day's box: open, openType (inside, gap_up, gap_down), entryWindowCloses, state, and once a wick has printed side, triggerAt, entry, stop, target, rewardRisk
sweeps	count, latest and list; each sweep has level (prior_day_high, prior_day_low, asia_high, asia_low, london_high, london_low, newyork_high, newyork_low), price, direction (bullish or bearish), wick, at, minutesAgo
snapshotTime	When the run looked

The key-value store record SUMMARY lists the setup state per symbol and which symbols had sweeps.

How the three parts are defined

• Box: the high and low of the most recent completed session. day is the prior UTC day. asia is 00:00 to 09:00 UTC, london 07:00 to 16:00 UTC, newyork 12:00 to 21:00 UTC.
• Wick setup: in the first 8 hours of the UTC day, the first 5-minute bar that trades through the prior day's high or low and closes back inside the box. The reference entry is the next bar's open, the stop is the wick extreme and the target is the box midline. One setup per day. active means neither stop nor target has been touched yet.
• Liquidity sweep: a 5-minute bar that trades through a level and closes back on the other side. A sweep of a high is bearish, a sweep of a low is bullish. Only the first sweep of each level is reported.

Input

Field	Default	Notes
symbols	BTCUSDT, ETHUSDT, SOLUSDT	Up to 50 Bybit USDT perpetuals. A bare coin name like BTC is read as BTCUSDT
session	day	Which box the box field describes: day, asia, london or newyork
sweepHours	24	Sweep lookback, 1 to 48 hours
proxy	Apify residential, AU	Bybit refuses US datacenter IPs, so the bars are fetched through this proxy

Typical uses

• Morning levels: schedule once after 00:00 UTC to get the day's box, midline and zones for a watchlist.
• Sweep alerts: schedule every 5 to 15 minutes and alert when sweepCount rises or setupState changes; connect the dataset to Slack, Telegram or a webhook with an Apify integration.
• Agents and bots: call it from an AI agent or MCP client; the output is JSON with stable field names.

Notes and limits

• Prices are Bybit linear-perpetual prices. Levels on other exchanges differ slightly.
• The last 5-minute bar is still forming when the run looks, so a trigger_forming state or a sweep on the latest bar can change before that bar closes.
• History per run is 1,000 five-minute bars, about 3.5 days. That is enough for the prior day and all three sessions; this is a live tool, not a backtester.
• The wick setup describes a chart pattern with reference levels. It is not a trade recommendation and comes with no performance claim.
• Data and analytics only, not financial advice.

Cost

Pay per event, no subscription. You pay only for the symbols a run returns.

Event	Price
Run start, once per run	$0.002
Symbol analysed	$0.005

The default run of BTC, ETH and SOL costs $0.017. A 20-symbol watchlist costs about 10 cents.

Run it from code

curl -X POST "https://api.apify.com/v2/acts/cryptoretirement~crypto-session-box-liquidity-sweep-detector/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"symbols":["BTCUSDT","ETHUSDT"],"session":"day","sweepHours":24}'

The response is the dataset as a JSON array. The API menu on this page has ready-made snippets for JavaScript, Python and MCP clients.

More Actors for traders and bots

• Crypto Signal Scanner: Donchian breakouts, golden and death crosses and Supertrend flips on the top Bybit perpetuals.
• Forex News Filter & Economic Calendar: this week's economic events and a high-impact news window check for bots.
• Crypto Perp Funding Rate Scanner: funding rates, annualised yield and cross-exchange spreads on 5 exchanges.
• Crypto Exchange New Listing Announcements: new coin and perpetual listings from 6 exchanges, with an alert flag.
• Solana Token Rug Check + Coin Score: rug gates, a honeypot sell test and a 0-100 score for any Solana token.
• DEX Pool Health Score: health and rug-risk score for any liquidity pool on 100+ networks.
• YouTube Most Replayed Clip Finder: the most replayed moments of any video as ready-to-cut clips.