Skip to content

bloxi-bot/btc-liquidations

 
 

Repository files navigation

BTC Liquidations

Watch leveraged positions get liquidated in real-time.

Live Demo

Live Demo Next.js TypeScript Tailwind CSS


What is BTC Liquidations?

BTC Liquidations is a real-time dashboard that monitors Bitcoin futures liquidations across 5 major exchanges - both centralized and decentralized. Watch as leveraged positions get wiped out with detailed statistics and visualizations.

No account needed. No ads. Just data.


Who is this for?

If you're a... BTC Liquidations helps you...
Trader Spot large liquidation events that may signal price reversals
Whale Watcher Track big positions getting liquidated in real-time
Risk Manager Monitor market stress and leverage buildup
Researcher Analyze liquidation patterns across exchanges
Developer Connect to the same WebSocket feeds for your own tools

Features

Multi-Exchange Support

  • CEX: Binance, Bybit, OKX and more
  • DEX: Hyperliquid, Aevo

Real-Time Data

  • WebSocket Feeds - Direct browser connections, no backend required
  • Live Statistics - Total liquidations, longs vs shorts, largest positions
  • Interactive Charts - Visualize liquidation volume over time
  • Exchange Breakdown - See which exchanges have the most activity

Customization

  • Adjustable Threshold - Filter by minimum liquidation value ($1K - $100K)
  • Auto-Reconnect - Automatic reconnection on connection drops
  • Responsive Design - Works on desktop and mobile

Supported Exchanges

Exchange Type WebSocket Endpoint Data
Binance CEX wss://fstream.binance.com/ws/btcusdt@forceOrder Force orders
Bybit CEX wss://stream.bybit.com/v5/public/linear Liquidations
OKX CEX wss://ws.okx.com:8443/ws/v5/public Liquidation orders
Hyperliquid DEX wss://api.hyperliquid.xyz/ws Trades with liquidation flag
Aevo DEX wss://ws.aevo.xyz Trades with liquidation flag

Quick Links


Technical Documentation

Click to expand developer documentation

Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/bokiko/btc-liquidations.git
cd btc-liquidations

# Install dependencies
npm install

# Run the development server
npm run dev

Open http://localhost:3000 to view the dashboard.

Build for Production

npm run build
npm start

Tech Stack

Category Technology
Framework Next.js 16 (App Router)
Language TypeScript 5.0
Styling Tailwind CSS 4.0
Charts Recharts
Icons Lucide React
Dates date-fns
Deployment Vercel

Project Structure

src/
├── app/
│   ├── layout.tsx           # Root layout with metadata
│   ├── page.tsx             # Main dashboard page
│   └── globals.css          # Global styles
├── components/
│   ├── ConnectionStatus.tsx # Exchange connection indicators
│   ├── LiquidationChart.tsx # Volume chart component
│   ├── LiquidationFeed.tsx  # Live feed list
│   └── StatsCards.tsx       # Statistics cards
├── hooks/
│   └── useMultiExchangeWebSocket.ts  # WebSocket connection hook
└── types/
    └── index.ts             # TypeScript type definitions

Deployment

Deploy to Vercel

Deploy with Vercel

Or deploy manually:

npm install -g vercel
vercel --prod

Contributing

Contributions welcome! Feel free to:

  • Add support for more exchanges
  • Improve UI/UX
  • Build new features
  • Fix bugs

Team

Built by @bokiko


License

MIT License - see LICENSE file for details.


Disclaimer

This tool is for informational purposes only. Not financial advice. Trade at your own risk.


Built for traders, by traders.

btc-liquidations.vercel.app

About

Real-time Bitcoin liquidation monitor across Binance, Bybit, OKX, Hyperliquid & Aevo

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 97.0%
  • CSS 1.7%
  • JavaScript 1.3%