{"id":49092344,"url":"https://github.com/bokiko/btc-liquidations","last_synced_at":"2026-04-20T19:05:35.961Z","repository":{"id":328529087,"uuid":"1115294449","full_name":"bokiko/btc-liquidations","owner":"bokiko","description":"Real-time Bitcoin liquidation monitor across Binance, Bybit, OKX, Hyperliquid \u0026 Aevo","archived":false,"fork":false,"pushed_at":"2026-03-18T21:18:20.000Z","size":118,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-19T10:37:21.353Z","etag":null,"topics":["bitcoin","cryptocurrency","defi","liquidations","nextjs","real-time","trading","typescript","websocket"],"latest_commit_sha":null,"homepage":"https://btc-liquidations.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bokiko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-12T16:23:46.000Z","updated_at":"2026-03-18T21:18:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bokiko/btc-liquidations","commit_stats":null,"previous_names":["bokiko/btc-liquidations"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bokiko/btc-liquidations","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fbtc-liquidations","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fbtc-liquidations/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fbtc-liquidations/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fbtc-liquidations/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bokiko","download_url":"https://codeload.github.com/bokiko/btc-liquidations/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fbtc-liquidations/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32061266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitcoin","cryptocurrency","defi","liquidations","nextjs","real-time","trading","typescript","websocket"],"created_at":"2026-04-20T19:05:35.181Z","updated_at":"2026-04-20T19:05:35.952Z","avatar_url":"https://github.com/bokiko.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# BTC Liquidations\n\n\u003ch3\u003eWatch leveraged positions get liquidated in real-time.\u003c/h3\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://btc-liquidations.vercel.app\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Live-btc--liquidations.vercel.app-orange?style=for-the-badge\" alt=\"Live Demo\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://btc-liquidations.vercel.app\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/demo-live-success\" alt=\"Live Demo\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://nextjs.org/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Next.js-16-black\" alt=\"Next.js\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.typescriptlang.org/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/TypeScript-5.0-blue\" alt=\"TypeScript\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://tailwindcss.com/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Tailwind-4.0-38bdf8\" alt=\"Tailwind CSS\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n\n---\n\n## What is BTC Liquidations?\n\n**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.\n\n**No account needed. No ads. Just data.**\n\n---\n\n## Who is this for?\n\n| If you're a... | BTC Liquidations helps you... |\n|----------------|-------------------------------|\n| **Trader** | Spot large liquidation events that may signal price reversals |\n| **Whale Watcher** | Track big positions getting liquidated in real-time |\n| **Risk Manager** | Monitor market stress and leverage buildup |\n| **Researcher** | Analyze liquidation patterns across exchanges |\n| **Developer** | Connect to the same WebSocket feeds for your own tools |\n\n---\n\n## Features\n\n### Multi-Exchange Support\n- **CEX**: Binance, Bybit, OKX and more\n- **DEX**: Hyperliquid, Aevo\n\n### Real-Time Data\n- **WebSocket Feeds** - Direct browser connections, no backend required\n- **Live Statistics** - Total liquidations, longs vs shorts, largest positions\n- **Interactive Charts** - Visualize liquidation volume over time\n- **Exchange Breakdown** - See which exchanges have the most activity\n\n### Customization\n- **Adjustable Threshold** - Filter by minimum liquidation value ($1K - $100K)\n- **Auto-Reconnect** - Automatic reconnection on connection drops\n- **Responsive Design** - Works on desktop and mobile\n\n---\n\n## Supported Exchanges\n\n| Exchange | Type | WebSocket Endpoint | Data |\n|----------|------|-------------------|------|\n| **Binance** | CEX | `wss://fstream.binance.com/ws/btcusdt@forceOrder` | Force orders |\n| **Bybit** | CEX | `wss://stream.bybit.com/v5/public/linear` | Liquidations |\n| **OKX** | CEX | `wss://ws.okx.com:8443/ws/v5/public` | Liquidation orders |\n| **Hyperliquid** | DEX | `wss://api.hyperliquid.xyz/ws` | Trades with liquidation flag |\n| **Aevo** | DEX | `wss://ws.aevo.xyz` | Trades with liquidation flag |\n\n---\n\n## Quick Links\n\n- **Live Dashboard**: [btc-liquidations.vercel.app](https://btc-liquidations.vercel.app)\n- **Report Issues**: [GitHub Issues](https://github.com/bokiko/btc-liquidations/issues)\n\n---\n\n# Technical Documentation\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClick to expand developer documentation\u003c/strong\u003e\u003c/summary\u003e\n\n## Getting Started\n\n### Prerequisites\n- Node.js 18+\n- npm or yarn\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/bokiko/btc-liquidations.git\ncd btc-liquidations\n\n# Install dependencies\nnpm install\n\n# Run the development server\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) to view the dashboard.\n\n### Build for Production\n\n```bash\nnpm run build\nnpm start\n```\n\n## Tech Stack\n\n| Category | Technology |\n|----------|------------|\n| **Framework** | Next.js 16 (App Router) |\n| **Language** | TypeScript 5.0 |\n| **Styling** | Tailwind CSS 4.0 |\n| **Charts** | Recharts |\n| **Icons** | Lucide React |\n| **Dates** | date-fns |\n| **Deployment** | Vercel |\n\n## Project Structure\n\n```\nsrc/\n├── app/\n│   ├── layout.tsx           # Root layout with metadata\n│   ├── page.tsx             # Main dashboard page\n│   └── globals.css          # Global styles\n├── components/\n│   ├── ConnectionStatus.tsx # Exchange connection indicators\n│   ├── LiquidationChart.tsx # Volume chart component\n│   ├── LiquidationFeed.tsx  # Live feed list\n│   └── StatsCards.tsx       # Statistics cards\n├── hooks/\n│   └── useMultiExchangeWebSocket.ts  # WebSocket connection hook\n└── types/\n    └── index.ts             # TypeScript type definitions\n```\n\n## Deployment\n\n### Deploy to Vercel\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/bokiko/btc-liquidations)\n\nOr deploy manually:\n\n```bash\nnpm install -g vercel\nvercel --prod\n```\n\n\u003c/details\u003e\n\n---\n\n## Contributing\n\nContributions welcome! Feel free to:\n- Add support for more exchanges\n- Improve UI/UX\n- Build new features\n- Fix bugs\n\n---\n\n## Team\n\nBuilt by [@bokiko](https://github.com/bokiko)\n\n---\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n## Disclaimer\n\nThis tool is for informational purposes only. Not financial advice. Trade at your own risk.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003eBuilt for traders, by traders.\u003c/strong\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003ca href=\"https://btc-liquidations.vercel.app\"\u003ebtc-liquidations.vercel.app\u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbokiko%2Fbtc-liquidations","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbokiko%2Fbtc-liquidations","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbokiko%2Fbtc-liquidations/lists"}