{"id":51126931,"url":"https://github.com/bigmacman1129/crypto-ai-trading-bot","last_synced_at":"2026-07-13T15:00:28.555Z","repository":{"id":354228358,"uuid":"1222343245","full_name":"bigmacman1129/crypto-ai-trading-bot","owner":"bigmacman1129","description":"Crypto liquidity detection \u0026 algorithmic trading bot. Order book analysis, stop-loss clusters, liquidity sweeps. Multi-exchange (Binance, Bybit, Kraken, OKX). Trading signals, quant research, market microstructure.","archived":false,"fork":false,"pushed_at":"2026-05-10T12:32:33.000Z","size":2610,"stargazers_count":38,"open_issues_count":0,"forks_count":19,"subscribers_count":18,"default_branch":"main","last_synced_at":"2026-05-17T05:36:12.251Z","etag":null,"topics":["ai","ai-agent","binance","bitcoin","bybit","crypto","liquidity","machine-learning","open-source","order-book","polymarket","prediction","sentiment-analysis","trading","trading-bot"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigmacman1129.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2026-04-27T09:16:58.000Z","updated_at":"2026-05-15T15:03:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bigmacman1129/crypto-ai-trading-bot","commit_stats":null,"previous_names":["meat29/crypto-ai-trading-bot","bigmacman1129/crypto-ai-trading-bot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/bigmacman1129/crypto-ai-trading-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmacman1129%2Fcrypto-ai-trading-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmacman1129%2Fcrypto-ai-trading-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmacman1129%2Fcrypto-ai-trading-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmacman1129%2Fcrypto-ai-trading-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigmacman1129","download_url":"https://codeload.github.com/bigmacman1129/crypto-ai-trading-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmacman1129%2Fcrypto-ai-trading-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35426086,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-13T02:00:06.543Z","response_time":119,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","ai-agent","binance","bitcoin","bybit","crypto","liquidity","machine-learning","open-source","order-book","polymarket","prediction","sentiment-analysis","trading","trading-bot"],"created_at":"2026-06-25T08:32:25.291Z","updated_at":"2026-07-13T15:00:28.549Z","avatar_url":"https://github.com/bigmacman1129.png","language":"JavaScript","funding_links":[],"categories":["Market Microstructure"],"sub_categories":[],"readme":"# Crypto Liquidity AI Trading Bot 🚀\n\n**AI trading bot** for liquidity detection and algorithmic trading in crypto markets. Detect order book gaps, hidden walls, and liquidity sweeps across exchanges—then act on signals manually or via your own execution layer.\n\n[![Python](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Stars](https://img.shields.io/github/stars/asonglin/crypto-liquidity-ai-trading-bot)](https://github.com/asonglin/crypto-liquidity-ai-trading-bot/stargazers)\n\n![Crypto Liquidity AI Trading Bot](assets/image.png)\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📋 Table of contents\u003c/strong\u003e\u003c/summary\u003e\n\n- [Why liquidity matters](#why-liquidity-matters)\n- [Who this is for](#who-this-is-for)\n- [Commercial use](#commercial-use)\n- [Backtest performance](#backtest-performance)\n- [Strategy concept](#strategy-concept)\n- [Architecture](#architecture)\n- [Quick start](#quick-start)\n- [What you get](#what-you-get)\n- [How liquidity hunting works](#how-liquidity-hunting-works)\n- [Installation](#installation)\n- [Supported exchanges](#supported-exchanges)\n- [Project layout](#project-layout)\n- [Use cases](#use-cases)\n- [Related projects](#related-projects)\n- [FAQ](#faq)\n- [Contributing](#contributing)\n\n\u003c/details\u003e\n\n---\n\n## Why liquidity matters\n\nMost crypto trading bots rely only on **price and technical indicators**. Professional traders, however, monitor **order book liquidity**, because price often moves toward zones where liquidity is concentrated—and away when that liquidity is swept.\n\nThis project focuses on **liquidity-aware trading signals** instead of lagging indicators: it detects gaps, walls, and sweeps so you can act on structure, not just price.\n\n---\n\n## Who this is for\n\nThis project may be useful for:\n\n- **Crypto trading firms** building in-house liquidity and execution tools  \n- **Quant researchers** studying order book and market microstructure  \n- **Exchanges** building surveillance or liquidity analytics  \n- **Developers** building AI trading agents or signal systems  \n\n---\n\n## Commercial use\n\nIf you are interested in **custom crypto trading bots** (liquidity, arbitrage, execution), **AI trading signal systems**, or **liquidity detection algorithms** and exchange API integrations:\n\n**For collaboration or development work:**\n\n- **Telegram** — [@k02_xx](https://t.me/k02_xx)\n\n---\n\n## Backtest performance\n\nResults below are from a **historical** backtest using order-book and liquidity-sweep signals on major spot pairs. They are not live trading results.\n\n**Test configuration**\n\n| Parameter | Value |\n|-----------|--------|\n| Window | Jan 2024 – Dec 2024 |\n| Length | 12 months |\n| Asset class | Cryptocurrency (spot) |\n| Approach | Liquidity-sweep \u0026 order-book imbalance |\n| Style | Medium frequency, signal-driven |\n| Pairs | BTC/USDT, ETH/USDT, selected alts |\n| Execution | Simulated limit/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**What this suggests**\n\n- **Win rate \u0026gt; 50%** suggests the liquidity-based signals add information over a random baseline.\n- **Profit factor \u0026gt; 1.2** indicates positive expectancy in the simulated period.\n- **Sharpe \u0026gt; 1.0** points to reasonable risk-adjusted returns in the backtest; **max drawdown −12.4%** is a measure of tail risk in the tested period.\n\n**Limitations**\n\nActual results can differ from backtests due to fees, slippage, execution delay, and changing liquidity. Run your own tests and risk checks before any live use.\n\n**Example signal (conceptual)**\n\n```json\n{\n  \"symbol\": \"BTC/USDT\",\n  \"direction\": \"LONG\",\n  \"strength\": 0.61,\n  \"reason\": \"liquidity_sweep_detected\",\n  \"ts\": \"2024-11-15T08:44:02Z\"\n}\n```\n\n---\n\n## Strategy concept\n\n**Price indicators lag. Liquidity moves first.**\n\nLarge orders and stop-loss clusters sit in the order book before price reaches them. When price sweeps those levels, liquidity is consumed and moves tend to accelerate. This bot identifies those levels and signals sweep events so you can trade with the flow instead of chasing price.\n\n---\n\n## Architecture\n\n```\nMarket data (REST/WS)\n        ↓\nOrder book analyzer\n        ↓\nLiquidity detector (gaps, walls, sweeps)\n        ↓\nSignal engine\n        ↓\nAlerts / optional execution layer\n```\n\nThe codebase separates **data** (`modules/`, exchange APIs), **analysis** (`trade/` — orderbook, liquidity), and **signals/alerts** so you can plug in your own execution or research tools.\n\n---\n\n## Quick start\n\n### Quick start (Node)\n\nRun the main app with Node:\n\n```bash\ngit clone https://github.com/asonglin/crypto-liquidity-ai-trading-bot.git \u0026\u0026 cd crypto-liquidity-ai-trading-bot\nnpm install\n```\n\nCreate `config.jsonc` from the template, then:\n\n```bash\ncp config.default.jsonc config.jsonc\nnode app.js\n```\n\n### Advanced research (Python optional)\n\nFor research, backtests, or a custom Python wrapper, use a venv and `requirements.txt`. See **Installation** below.\n\n---\n\n## What you get\n\n| Capability | Description |\n|------------|-------------|\n| **Liquidity detection** | Scans order books and pools for depth, gaps, and imbalance. |\n| **Hidden walls** | Surfaces large buy/sell walls and their changes. |\n| **Multi-exchange** | Built to plug into Binance, Bybit, Kraken, OKX, and others. |\n| **Alerts** | Configurable notifications when liquidity events fire. |\n| **Trading framework** | Modular so you can add execution, risk, or dashboards. |\n\nUse it for **liquidity grabs**, **order book imbalance strategies**, **market microstructure research**, and **algorithmic trading**—whether you trade manually or automate.\n\n---\n\n## How liquidity hunting works\n\nLiquidity hunting targets zones where lots of orders sit (e.g. stop-loss clusters). When price sweeps those levels, liquidity is “taken” and price can move fast. This bot helps you find and watch those zones.\n\n1. **Find** where large stop-loss clusters or thin book zones sit.  \n2. **Detect** liquidity sweeps and wall removals in real time.  \n3. **Alert** so you can enter when liquidity is taken or book vacuum appears.  \n4. **Extend** with your own execution (manual or automated).\n\nSignals you can get: *stop-loss clusters*, *sudden order book vacuum*, *liquidity wall removal*, *aggressive market order flow*.\n\n---\n\n## Installation\n\n```bash\ngit clone https://github.com/asonglin/crypto-liquidity-ai-trading-bot.git\ncd crypto-liquidity-ai-trading-bot\n```\n\n**Quick start (Node)** — main engine:\n\n```bash\nnpm install\ncp config.default.jsonc config.jsonc\n# Edit config.jsonc, then:\nnode app.js\n```\n\n**Advanced research (Python optional)** — venv and scripts:\n\n```bash\npython -m venv venv\nsource venv/bin/activate   # Linux/macOS\nvenv\\Scripts\\activate     # Windows\npip install -r requirements.txt\n```\n\n### Example: scanning and alerts\n\n```javascript\n// App entry is app.js; configure API keys and exchanges in config.\n// Core logic lives in trade/ (liquidity, orderbook) and modules/ (api, DB).\n```\n\n```python\n# If using a Python wrapper:\nfrom liquidity_hunting import LiquidityBot\nbot = LiquidityBot(api_key=\"YOUR_API_KEY\", secret=\"YOUR_SECRET\")\nbot.scan_liquidity()\nbot.generate_alerts()\n```\n\n---\n\n## Production hardening checklist\n\n- Keep `api.host` set to `127.0.0.1` unless you explicitly front the API with a trusted reverse proxy.\n- Keep `api.debug` disabled in production; if enabled, configure `api.debugToken` and `api.debugAllowlist`.\n- Prefer env vars for secrets (`BOT_PASSPHRASE`, `EXCHANGE_API_KEY`, `EXCHANGE_API_SECRET`) over plain config values.\n- Never commit `config.jsonc` or `.env` with real credentials.\n\n---\n\n## Container deployment\n\nBuild and run with Docker Compose:\n\n```bash\ncp .env.example .env\ncp config.default.jsonc config.jsonc\ndocker compose up --build -d\n```\n\nThe compose stack starts:\n- `bot` (this project)\n- `mongo` (MongoDB 7)\n\n---\n\n## Supported exchanges\n\nExtensible to any exchange with a REST/WS API. Commonly used with:\n\n| Exchange | Notes |\n|----------|--------|\n| Binance | Spot \u0026 futures. |\n| Bybit | Derivatives. |\n| Kraken | Spot. |\n| OKX | Spot \u0026 derivatives. |\n| Coinbase | Spot. |\n| Hyperliquid | Perps. |\n\n---\n\n## Project layout\n\n```\ncrypto-liquidity-ai-trading-bot/\n├── app.js                 # entry point\n├── config.default.jsonc   # config template\n├── package.json\n├── helpers/               # shared utils, crypto helpers\n├── modules/               # api, DB, config, transactions\n├── routes/                # debug, health, init\n├── trade/                 # liquidity provider, orderbook, traders, exchange APIs\n├── types/                 # TypeScript declarations\n├── utils/\n└── assets/\n```\n\n---\n\n## Use cases\n\n- **Crypto algorithmic trading** — Feed signals into your execution engine.  \n- **Quant research** — Order book and liquidity analysis.  \n- **AI/ML strategy dev** — Use liquidity events as features or triggers.  \n- **Market microstructure** — Study gaps, walls, and sweep behavior.\n\n---\n\n\n## FAQ\n\n**What is liquidity hunting?**  \nA strategy that focuses on levels where lots of stop-loss or passive orders sit; when those levels are hit, liquidity is consumed and price often moves sharply.\n\n**Is the bot fully automated?**  \nIt focuses on **detection and alerts**. You can add automated execution yourself or use signals for manual trading.\n\n**Who is it for?**  \nDevelopers, quants, and algo traders who want liquidity-aware signals and a clear, extensible codebase (Node/JS, optional Python).\n\n---\n\n## Contributing\n\nWe welcome pull requests and issues. Fork → branch → PR. See CONTRIBUTING.md if present.\n\n**License:** MIT © 2026\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigmacman1129%2Fcrypto-ai-trading-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigmacman1129%2Fcrypto-ai-trading-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigmacman1129%2Fcrypto-ai-trading-bot/lists"}