crypto-liquidations

Crypto Liquidations

Two different events share this word. Keep them apart.

• Perp liquidation: a venue force-closes a leveraged position. Side, size, price, venue. From the venues that publish them.
• DeFi lending liquidation: a third party repays someone's debt and seizes their collateral on-chain (Aave V3 and Morpho Blue, Ethereum / Arbitrum / Base). Both wallets are named.

Never add them together. A combined total is a number with no meaning: one is leverage being flushed on an exchange, the other is collateral changing hands on a lending market. Report whichever the question is about, or both clearly labelled.

Data sources (in order)

1. "How much got liquidated?" with no pair named is a MARKET question. Use coinlobster:market_liquidations (no args, keyless) or GET https://coinlobster.com/api/public/liquidations. One call covers the whole market instead of one pair: 24h dollars and counts split long vs short, an hourly series so a cascade is locatable, top coins, the biggest single event, and lending liquidations on their own lane. It is not every venue: only some publish a liquidation feed, so the perp totals are a floor. Do NOT assemble a market answer from per-pair calls.
2. One pair named? coinlobster:liquidations (args: pair e.g. BTC/USD, limit; keyless on any pair) and coinlobster:market_snapshot (args: pair; keyless on BTC/USD only, check available) for funding + OI context. For the on-chain side use coinlobster:defi_liquidations (args: chain, limit; keyless).
3. No MCP client: the hosted MCP answers plain JSON-RPC curl:

   curl -s -X POST https://coinlobster.com/mcp \
     -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"liquidations","arguments":{"pair":"BTC/USD","limit":50}}}'
   

   Swap name to market_snapshot for funding/OI (keyless that pair-gates to BTC/USD; check available in the response, and skip the context layer rather than guess when it is false).
4. Market-wide over plain REST:

   curl -s https://coinlobster.com/api/public/liquidations
   

   perp_liquidations carries total_usd, long_usd/short_usd, long_count/short_count, long_share_pct, peak_hour, hourly[], top_coins[] and venues[]. named_liquidations[] lists Hyperliquid accounts that were force-closed, wallet included. lending_liquidations is the separate on-chain lane. stale: true means the snapshot is behind, so report that rather than the numbers.