[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77717":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":18,"hasPages":18,"topics":20,"createdAt":10,"pushedAt":10,"updatedAt":40,"readmeContent":41,"aiSummary":42,"trendingCount":15,"starSnapshotCount":15,"syncStatus":43,"lastSyncTime":44,"discoverSource":45},77717,"crypto-liquidity-ai-trading-bot","python-telegramBot\u002Fcrypto-liquidity-ai-trading-bot","python-telegramBot","crypto trading bot liquidity order book market microstructure algorithmic trading quant Python Node.js websocket Binance crypto signals HFT order flow sweep detection depth analysis","https:\u002F\u002Fgithub.com\u002Fpython-telegramBot\u002Fcrypto-liquidity-ai-trading-bot",null,"JavaScript",99,878,1,0,192,8.83,false,"main",[21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"algorithmic-trading","binance","bitcoin","crypto","crypto-trading-bot","depth-analysis","ethereum","hft","liquidity","market-microstructure","microstructure","nodejs","order-book","order-flow","python","quantitative-finance","sweep-trading","trading-signals","websocket","2026-06-12 02:03:44","# Crypto Liquidity AI Trading Bot\n\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.11-blue.svg)](https:\u002F\u002Fwww.python.org\u002F)\n[![Node](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-18%2B-green.svg)](https:\u002F\u002Fnodejs.org\u002F)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)](LICENSE)\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fpython-telegramBot\u002Fcrypto-liquidity-ai-trading-bot)](https:\u002F\u002Fgithub.com\u002Fpython-telegramBot\u002Fcrypto-liquidity-ai-trading-bot\u002Fstargazers)\n\n**Repository:** [github.com\u002Fpython-telegramBot\u002Fcrypto-liquidity-ai-trading-bot](https:\u002F\u002Fgithub.com\u002Fpython-telegramBot\u002Fcrypto-liquidity-ai-trading-bot)\n\nA modular, signal-driven trading framework for cryptocurrency markets. Detects order book gaps, hidden liquidity walls, and sweep events across major exchanges in real time—designed for quant researchers, algo traders, and firms building liquidity-aware execution tools.\n\n![Dashboard preview](assets\u002Fimage.png)\n\n---\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Why Liquidity-Based Signals](#why-liquidity-based-signals)\n- [Target Users](#target-users)\n- [Backtest Results](#backtest-results)\n- [Strategy Concept](#strategy-concept)\n- [Architecture](#architecture)\n- [Quick Start](#quick-start)\n- [Capabilities](#capabilities)\n- [How Liquidity Detection Works](#how-liquidity-detection-works)\n- [Installation](#installation)\n- [Supported Exchanges](#supported-exchanges)\n- [Project Structure](#project-structure)\n- [Use Cases](#use-cases)\n- [Related Projects](#related-projects)\n- [FAQ](#faq)\n- [Contributing](#contributing)\n\n---\n\n## Overview\n\nMost trading bots react to price. This one reads the market differently.\n\n`crypto-liquidity-ai-trading-bot` focuses on **order book structure**—detecting where large passive orders sit, when liquidity walls form or vanish, and when stop-loss clusters are swept. These events often precede sharp price moves, making them higher-quality signals than most lagging technical indicators.\n\nThe framework is built to be **modular and extensible**: plug in your own execution engine, risk layer, or research pipeline without rewriting the core.\n\n---\n\n## Why Liquidity-Based Signals\n\nRetail indicators (RSI, MACD, moving averages) describe what price has already done. Order book data describes what is *about* to happen—where passive capital is sitting, where stops are clustered, and which levels the market is likely to test.\n\nProfessional traders monitor this continuously. This framework gives independent developers and quant teams the same visibility.\n\nKey signal types detected:\n\n- **Liquidity gaps** — thin order book zones where price may move rapidly\n- **Hidden walls** — large resting orders that appear or disappear\n- **Stop-loss sweeps** — price reaching stop clusters, triggering momentum\n- **Book imbalance** — aggressive bid\u002Fask pressure shifts\n\n---\n\n## Target Users\n\nThis project is intended for:\n\n- **Algorithmic trading firms** building in-house liquidity intelligence and execution infrastructure\n- **Quantitative researchers** studying order book dynamics and market microstructure\n- **Exchanges and surveillance teams** monitoring for liquidity anomalies\n- **Developers** building AI trading agents, signal systems, or execution layers\n\nIt assumes familiarity with financial markets, order books, and at least one of Node.js or Python.\n\n---\n\n## Backtest Results\n\nThe metrics below are from a historical simulation using order-book and liquidity-sweep signals on major spot pairs. These are **not live trading results**.\n\n**Test Configuration**\n\n| Parameter | Value |\n|-----------|-------|\n| Period | January 2024 – December 2024 |\n| Duration | 12 months |\n| Asset class | Cryptocurrency (spot) |\n| Strategy | Liquidity-sweep + order-book imbalance |\n| Trading style | Medium-frequency, signal-driven |\n| Pairs | BTC\u002FUSDT, ETH\u002FUSDT, selected altcoins |\n| Execution model | Simulated limit and market fills |\n\n**Performance Metrics**\n\n| Metric | Result |\n|--------|--------|\n| Win rate | 58.2% |\n| Profit factor | 1.42 |\n| Max drawdown | −12.4% |\n| Sharpe ratio (daily) | 1.18 |\n\n**Interpreting These Numbers**\n\nA win rate above 50% suggests the liquidity signals carry predictive information beyond a random baseline. A profit factor of 1.42 indicates positive expectancy over the tested period. A daily Sharpe above 1.0 reflects reasonable risk-adjusted returns, while max drawdown of −12.4% bounds the observed tail risk.\n\n**Example signal output:**\n\n```json\n{\n  \"symbol\": \"BTC\u002FUSDT\",\n  \"direction\": \"LONG\",\n  \"strength\": 0.61,\n  \"reason\": \"liquidity_sweep_detected\",\n  \"ts\": \"2024-11-15T08:44:02Z\"\n}\n```\n\n> **Disclaimer:** Backtest results do not guarantee future performance. Live results will differ due to fees, slippage, execution latency, and changing market conditions. Conduct independent testing and risk assessment before any live deployment.\n\n---\n\n## Strategy Concept\n\n> Price indicators lag. Liquidity moves first.\n\nLarge resting orders and stop-loss clusters sit in the order book *before* price reaches them. When price sweeps those levels, liquidity is consumed—and subsequent moves often accelerate as the book empties. This framework identifies and monitors those levels continuously.\n\nThe goal is to trade with order flow rather than chasing price action after the fact.\n\n---\n\n## Architecture\n\n```\nMarket Data (REST \u002F WebSocket)\n           │\n           ▼\n  Order Book Analyzer\n           │\n           ▼\n  Liquidity Detector\n  (gaps · walls · sweeps)\n           │\n           ▼\n    Signal Engine\n           │\n      ┌────┴────┐\n      ▼         ▼\n   Alerts   Execution Layer\n             (optional)\n```\n\nThe codebase maintains a clean separation between:\n\n- **Data ingestion** (`modules\u002F`) — exchange APIs, raw book data\n- **Analysis** (`trade\u002F`) — orderbook processing, liquidity detection\n- **Output** — configurable alerts and an optional execution interface\n\nThis makes it straightforward to extend any layer independently.\n\n---\n\n## Quick Start\n\n### Node.js (Primary Engine)\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fpython-telegramBot\u002Fcrypto-liquidity-ai-trading-bot.git\ncd crypto-liquidity-ai-trading-bot\nnpm install\n```\n\nEdit `config.default.jsonc` with your exchange API keys and preferred settings, then:\n\n```bash\nnode app.js\n```\n\n### Python (Research & Backtesting)\n\nFor backtesting, data analysis, or building a custom Python wrapper:\n\n```bash\npython -m venv venv\nsource venv\u002Fbin\u002Factivate       # macOS\u002FLinux\n# venv\\Scripts\\activate        # Windows\npip install -r requirements.txt\n```\n\nSee full [Installation](#installation) instructions below for environment-specific details.\n\n---\n\n## Capabilities\n\n| Feature | Description |\n|---------|-------------|\n| **Liquidity detection** | Scans order books for depth gaps, concentration zones, and imbalance |\n| **Hidden wall tracking** | Surfaces and monitors large resting buy\u002Fsell walls in real time |\n| **Sweep detection** | Identifies stop-loss cluster sweeps and aggressive market order flow |\n| **Multi-exchange support** | Designed to connect to Binance, Bybit, Kraken, OKX, and others |\n| **Configurable alerts** | Fires notifications on liquidity events via configurable thresholds |\n| **Modular framework** | Clean separation of data, analysis, and execution layers |\n\n---\n\n## How Liquidity Detection Works\n\nLiquidity hunting targets price zones where large volumes of passive orders (stops, limits) are concentrated. When price reaches and sweeps those zones, the resulting order flow often drives fast, directional moves.\n\nThe detection pipeline operates in four stages:\n\n1. **Map** — Continuously scan order books to identify stop-loss clusters and thin book zones\n2. **Detect** — Recognize in real time when walls form, disappear, or are swept\n3. **Alert** — Emit a signal when a liquidity event fires so you can act immediately\n4. **Execute** — Optionally feed signals into your own execution layer (manual or automated)\n\nDetectable signal types: stop-loss clusters, order book vacuums, liquidity wall removals, and aggressive market order flow.\n\n---\n\n## Installation\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fpython-telegramBot\u002Fcrypto-liquidity-ai-trading-bot.git\ncd crypto-liquidity-ai-trading-bot\n```\n\n**Node.js (main engine):**\n\n```bash\nnpm install\n# Configure API keys in config.default.jsonc\nnode app.js\n```\n\n**Python (optional research layer):**\n\n```bash\npython -m venv venv\nsource venv\u002Fbin\u002Factivate   # macOS\u002FLinux\nvenv\\Scripts\\activate     # Windows\npip install -r requirements.txt\n```\n\n**Python usage example:**\n\n```python\nfrom liquidity_hunting import LiquidityBot\n\nbot = LiquidityBot(api_key=\"YOUR_API_KEY\", secret=\"YOUR_SECRET\")\nbot.scan_liquidity()\nbot.generate_alerts()\n```\n\nAPI keys and exchange endpoints are configured via `config.default.jsonc`. Copy it to `config.jsonc` before making changes.\n\n---\n\n## Supported Exchanges\n\nThe framework is designed to connect to any exchange with a REST or WebSocket API. The following are supported out of the box:\n\n| Exchange | Markets |\n|----------|---------|\n| Binance | Spot, Futures |\n| Bybit | Derivatives |\n| Kraken | Spot |\n| OKX | Spot, Derivatives |\n| Coinbase | Spot |\n| Hyperliquid | Perpetuals |\n\nCustom exchange integrations can be added by implementing the standard connector interface in `trade\u002F`.\n\n---\n\n## Project Structure\n\n```\ncrypto-liquidity-ai-trading-bot\u002F\n├── app.js                 # Application entry point\n├── config.default.jsonc   # Configuration template\n├── package.json\n├── helpers\u002F               # Shared utilities and cryptographic helpers\n├── modules\u002F               # Exchange API clients, database, configuration\n├── routes\u002F                # Health checks, debug, and initialization routes\n├── trade\u002F                 # Core logic: liquidity, orderbook, exchange adapters\n├── types\u002F                 # TypeScript type declarations\n├── utils\u002F                 # General-purpose utilities\n└── assets\u002F                # Static assets and documentation images\n```\n\n---\n\n## Use Cases\n\n**Algorithmic trading** — Feed structured liquidity signals into your execution engine for automated or semi-automated strategies.\n\n**Quantitative research** — Analyze order book behavior, sweep frequency, and book imbalance patterns across assets and time periods.\n\n**AI\u002FML feature engineering** — Use liquidity events as features or triggers in machine learning models trained on market microstructure data.\n\n**Market microstructure analysis** — Study how gaps, walls, and sweep behavior evolve across different market conditions and exchanges.\n\n---\n\n## Related Projects\n\nPart of the same AI trading framework suite:\n\n- [Crypto Futures AI Trading Bot](https:\u002F\u002Fgithub.com\u002Fasonglin\u002Fcrypto-futures-ai-trading-bot) — Funding rate arbitrage and smart-money flow monitoring\n- [Cross-Exchange AI Arbitrage Bot](https:\u002F\u002Fgithub.com\u002Fasonglin\u002Fcross-exchange-ai-arbitrage-bot) — CEX\u002FDEX spread detection and cross-venue execution\n\n---\n\n## FAQ\n\n**What is liquidity hunting?**\n\nA strategy that focuses on price levels where large volumes of stop-loss or passive limit orders are concentrated. When price reaches those levels, the liquidity is consumed (\"swept\") and price often accelerates. Identifying these zones in advance is the core signal this framework provides.\n\n**Is execution automated?**\n\nThe framework focuses on **signal generation and alerting**. Automated execution is not included by default—you can integrate your own execution layer, or use the signals to inform manual trading decisions.\n\n**What technical background is required?**\n\nWorking knowledge of order books, crypto markets, and Node.js (or Python for research use) is assumed. The codebase is documented and modular, but this is not a beginner-oriented tool.\n\n**Can I add my own exchange?**\n\nYes. Implement the standard connector interface in `trade\u002F` and configure the endpoint in `config.jsonc`.\n\n---\n\n## Contributing\n\nContributions are welcome. The preferred workflow is:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature\u002Fyour-feature`)\n3. Commit your changes with clear, descriptive messages\n4. Open a pull request against `main`\n\nPlease open an issue first for significant changes or new features. See `CONTRIBUTING.md` for additional guidelines.\n\n---\n\n**License:** MIT © 2026","这是一个针对加密货币市场的模块化、信号驱动的交易框架，专注于订单簿结构分析。项目通过实时检测订单簿中的流动性缺口、隐藏的流动性墙以及扫单事件来预测市场动向，提供了比传统技术指标更高质量的交易信号。采用Python和Node.js开发，并利用WebSocket技术从Binance等主流交易所获取数据，适合量化研究者、算法交易团队及希望建立基于流动性的执行工具的企业使用。",2,"2026-06-11 03:55:54","CREATED_QUERY"]