# LiqFlow

> Hyperliquid liquidation levels, whale positions, liquidations, cohorts and funding. Free.

- name: app.liqflow/liqflow
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 94/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/app.liqflow%2Fliqflow
- tools: https://api.protogrid.dev/v1/servers/app.liqflow%2Fliqflow/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "liqflow": {
      "type": "http",
      "url": "https://liqflow.app/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-1d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 94/100 (new)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 15 of 15 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 3,062 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 0 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 15, about 3,062 tokens to load them all
- tool set hash: fcf31cbac3a18f7b40a697a9eee34d05
- badge: [![protogrid quality](https://protogrid.dev/badge/app.liqflow/liqflow.svg)](https://protogrid.dev/servers/app.liqflow/liqflow)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://liqflow.app/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (15)

- `cascades`: Past sharp moves (at least `min_move_pct` in one 4-hour step) paired with how
much liquidation exposure sat in their path just before -- the evidence for
whether clusters actually get run.
- `cohort_positioning`: How different kinds of traders are positioned: wallets grouped by account
size (Micro under $250 up to Whale over $1M) and by all-time PnL (Highly
Unprofitable to Highly Profitable), with each group's long and short notional
and the share that is long. "Are whales and the profitable traders on the
other side of retail?" Uses 2 API calls without a coin.
- `cohort_top_coins`: Which coins one trader cohort is most long and most short on, ranked across
every market: "What are the most profitable traders most bullish and most
bearish on?" Each coin has the cohort's long and short notional, net USD,
share long and wallet count, plus the cohort's overall lean across all markets
to compare against. Uses 2 API calls without a side.
- `coin_history`: A metric's history for one market (with the price where the data has it),
thinned to at most 60 points.
- `coin_snapshot`: Everything about one market right now: live price and 24h change, its
liquidation-pressure score, liquidation exposure each side and how close it
sits, the nearest big cluster, its rank among all markets, and what changed
since the previous snapshot. Start here for any question about one coin. Uses 2
API calls.
- `funding`: Perp funding rates. With a coin: the rate on each venue (Hyperliquid, Binance,
Bybit, OKX, Bitget, Gate) normalised to 8 hours, plus the open-interest
weighted aggregate. Without: the markets paying the most positive and most
negative funding right now. Positive = longs pay shorts.
- `leaderboard`: Hyperliquid wallets ranked by all-time PnL or by 30-day volume.
- `liquidation_map`: Where the forced orders sit around the current price for one market, from
every wallet on the node: liquidation prices (longs below = forced sells,
shorts above = forced buys), resting stop-loss / take-profit trigger orders,
and order-book depth, summed into price bands either side of the mark price,
plus the biggest liquidation clusters.

This is the "liquidation heatmap" question: where would a move run into
cascading liquidations, and how much is there. Uses 2 API calls.
- `liquidation_totals`: How much was liquidated. Without a coin: every market ranked by liquidated
USD over the window, long vs short. With a coin: long and short liquidations
per time bucket. Windows that the node missed are listed under `gaps` -- those
are missing data, not quiet periods.
- `list_markets`: Market symbols LiqFlow covers, to resolve a name ("solana") to its market
symbol (SOL). `scored` markets also have scores, funding, depth and
volume; the rest have node data only (positions, levels, liquidations). Uses 2
API calls.
- `market_overview`: The whole market in one reading: how many perps lean bullish vs bearish on
liquidation pressure, and the markets leaning hardest each way.

The score compares short-liquidation exposure ABOVE price (forced buys if price
rises) with long-liquidation exposure BELOW it (forced sells if it falls),
weighted by distance. Negative = more fuel below, a bearish pull; positive = the
reverse. Uses 2 API calls.
- `open_interest_ranking`: Hyperliquid markets ranked by open interest (USD), with how many positions
are open in each, from every wallet on the node.
- `recent_liquidations`: Individual Hyperliquid liquidation fills, newest first, straight off the
node: who was liquidated, on which market, how big, at what price. One
liquidation can be several fills sharing an order id.
- `top_positions`: The largest open positions on Hyperliquid right now, longs and shorts, read
live from the node: wallet, size, notional, entry, leverage, liquidation price
and how far price is from it, unrealised PnL, and the wallet's size cohort.
- `wallet`: One Hyperliquid wallet right now, read live from the node: account value,
PnL, every open position with leverage, liquidation price and how far price is
from it, and its open orders (limits, stops and take-profits).