Understand the data
Perpetual history
PERP shows a board and rankings of perpetuals on Hyperliquid, Binance, Bybit and OKX, and one perpetual's funding, open interest and premium history
Open it
| Command | Opens |
|---|---|
PERP | The Board of every market |
PERP BTC | Bitcoin on the venue with the most open interest |
PERP hyperliquid:xyz:TSLA | One exact contract, here a stock perpetual |
What you see
| Tab | Shows |
|---|---|
| Board | Every market by venue: mark, funding, premium, open interest and its 24-hour change, long share and APR, filtered by asset class and venue |
| Rankings | The highest and lowest funding, open-interest surges and premium dislocations, across every asset class or within one |
| Compare | One asset's contracts across the venues: mark, funding, premium and when each was observed |
| Liquidations | One asset's liquidated longs and shorts across the venues: 24-hour and 7-day totals, the hourly series and the largest prints |
| Depth | One asset's resting bids and asks within 0.5%, 1% and 2% of mid on each venue, from each venue's order book every hour |
| History | Funding, open interest and mark premium, with price candles and settled funding where available |
| Evidence | The source, observation date and any corrections for each reading |
/ searches markets, e opens Evidence, a sets an alert, o opens the source.
Free and Pro
Pro shows the stored history. Free shows a limited preview of the latest values. History starts when Gloom first collected a market.
Liquidations
Each venue's public liquidation stream, kept event by event with the time it arrived. A long liquidated is a forced sell, a short a forced buy, valued at the price the venue reports: the average fill on Binance and Hyperliquid, the bankruptcy price on Bybit and OKX. What the streams leave out:
- Binance and OKX send at most one liquidation per contract each second, so a burst on one contract is undercounted.
- Bybit sends every liquidation.
- Hyperliquid publishes only the positions its liquidity vault takes over (backstop liquidations). Liquidations closed on the order book are not published venue-wide and are missing.
- Venues publish no liquidation history, so time the collector was not connected is missing, not zero, and history starts at first collection.
Free shows each contract's 24-hour and 7-day totals and the three largest prints; Pro adds the hourly series and the twenty largest prints.
Order book depth
The quote notional resting within 0.5%, 1% and 2% of mid, read once an hour from each venue's public order book for its 50 largest markets by open interest. Binance and Bybit return the nearest 1,000 price levels a side and OKX 5,000; on the deepest markets the book ends inside a band, which then shows at least (≥) what it holds. Hyperliquid returns 20 levels a side, so wider bands are read from its grouped book and a band's edge falls within one price group. A book not read for 2.5 hours (it left its venue's 50 largest, or the venue is failing) is marked stale and left out of the band totals; after a week it is no longer listed. Free shows the latest reading; Pro the hourly history.
Long/short ratio
The share of accounts holding a contract that are net long against net short, hourly, on Binance, Bybit and OKX. Each venue defines and buckets it its own way (OKX publishes only the ratio, so its shares are derived), and Hyperliquid publishes none. History starts at first collection: free shows the latest value, Pro the history.
Keep in mind
- Stored readings cover Hyperliquid, Binance, Bybit and OKX. Compare shows each venue's leading contract free; Pro lists every contract.
- A contract's asset class is the one its venue gives it: OKX's instrument category, Binance's underlying type and Bybit's symbol type, so a venue's stock, commodity or FX perpetual is never counted as crypto. Hyperliquid's builder-deployed markets are classed from a checked list and stay Other until checked.
- Positive funding means longs pay shorts. Open interest in contracts and in USD differ, because a price rise adds USD open interest without new contracts.
- A stock perpetual's premium is blank while the stock market is closed. The live board and trading are in the Hyperliquid plugin.
CLI gloom fn PERP BTC. MCP perps.board, perps.history, perps.rankings, perps.compare. Related: `FUT`, `CRYP`.