{"id":13456211,"url":"https://github.com/hummingbot/hummingbot","last_synced_at":"2026-10-20T20:26:19.680Z","repository":{"id":36993181,"uuid":"179163124","full_name":"hummingbot/hummingbot","owner":"hummingbot","description":"Open source software that helps you create and deploy high-frequency crypto trading bots","archived":false,"fork":false,"pushed_at":"2026-10-15T01:37:30.000Z","size":566999,"stargazers_count":20503,"open_issues_count":176,"forks_count":5011,"subscribers_count":202,"default_branch":"master","last_synced_at":"2026-10-17T09:33:50.261Z","etag":null,"topics":["ai-agents","algotrading","arbitrage","backtesting","binance","bitcoin","crypto","cryptocurrency","defi","ethereum","hft","hyperliquid","market-making","orderbook","python","quantitative-finance","solana","trading","trading-stategy"],"latest_commit_sha":null,"homepage":"https://hummingbot.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hummingbot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"accessibility":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,"claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null},"funding":{"github":"hummingbot"}},"created_at":"2019-04-02T21:41:52.000Z","updated_at":"2026-10-17T09:33:28.000Z","dependencies_parsed_at":"2026-10-17T04:16:10.011Z","dependency_job_id":null,"html_url":"https://github.com/hummingbot/hummingbot","commit_stats":null,"previous_names":[],"tags_count":112,"template":false,"template_full_name":null,"purl":"pkg:github/hummingbot/hummingbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummingbot%2Fhummingbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummingbot%2Fhummingbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummingbot%2Fhummingbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummingbot%2Fhummingbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hummingbot","download_url":"https://codeload.github.com/hummingbot/hummingbot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummingbot%2Fhummingbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38333065,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-17T02:00:06.547Z","response_time":57,"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-agents","algotrading","arbitrage","backtesting","binance","bitcoin","crypto","cryptocurrency","defi","ethereum","hft","hyperliquid","market-making","orderbook","python","quantitative-finance","solana","trading","trading-stategy"],"created_at":"2024-07-31T08:01:17.887Z","updated_at":"2026-10-18T20:05:50.553Z","avatar_url":"https://github.com/hummingbot.png","language":"Python","funding_links":["https://github.com/sponsors/hummingbot"],"categories":["Trading Bots","User Interface","Python","量化交易/交易策略/程序化交易","Quantitative Trading \u0026 Backtesting","bot","Domain-Specific AI Agents","Others","Repos","Quant and Trading Agents","🤖 AI \u0026 Machine Learning","Index","Quantitative Trading Strategies","Backtesting","🧰 开源工具：回测、平台、AI + Finance、数据处理"],"sub_categories":["Crypto Trading","Applications and End User Tools","DeFi项目","Financial \u0026 Trading Systems","Benchmark Reality Check (real-world tool use)","C. Quant Frameworks / Backtesting","3. High-Frequency Trading (HFT)","量化平台"],"readme":"![Hummingbot](https://github.com/user-attachments/assets/3213d7f8-414b-4df8-8c1b-a0cd142a82d8)\n\n----\n[![License](https://img.shields.io/badge/License-Apache%202.0-informational.svg)](https://github.com/hummingbot/hummingbot/blob/master/LICENSE)\n[![Twitter](https://img.shields.io/twitter/url?url=https://twitter.com/_hummingbot?style=social\u0026label=_hummingbot)](https://twitter.com/_hummingbot)\n[![Youtube](https://img.shields.io/youtube/channel/subscribers/UCxzzdEnDRbylLMWmaMjywOA)](https://www.youtube.com/@hummingbot)\n[![Discord](https://img.shields.io/discord/530578568154054663?logo=discord\u0026logoColor=white\u0026style=flat-square)](https://discord.gg/hummingbot)\n\nHummingbot is an open-source framework that helps you design and deploy automated trading strategies, or **bots**, that can run on many centralized or decentralized exchanges. Over the past year, Hummingbot users have generated over $34 billion in trading volume across 140+ unique trading venues.\n\nThe Hummingbot codebase is free and publicly available under the Apache 2.0 open-source license. Our mission is to **democratize high-frequency trading** by creating a global community of algorithmic traders and developers that share knowledge and contribute to the codebase.\n\n## Quick Links\n\n* [Website and Docs](https://hummingbot.org): Official Hummingbot website and documentation\n* [Installation](https://hummingbot.org/installation/): Install Hummingbot on various platforms\n* [Discord](https://discord.gg/hummingbot): The main gathering spot for the global Hummingbot community\n* [YouTube](https://www.youtube.com/c/hummingbot): Videos that teach you how to get the most out of Hummingbot\n* [Twitter](https://twitter.com/_hummingbot): Get the latest announcements about Hummingbot\n* [Reported Volumes](https://reporting.hummingbot.org/): Reported trading volumes across all Hummingbot instances\n* [Newsletter](https://hummingbot.substack.com): Get our newsletter whenever we ship a new release\n\n## Getting Started\n\n### Condor (AI harness)\n\n**[Condor](https://github.com/hummingbot/condor)** is the AI harness for building and running agentic strategies and bot instances. It connects LLM-powered decision-making to deterministic trade execution via the Hummingbot API, controlled through Telegram or its web dashboard. See **[condor.hummingbot.org](https://condor.hummingbot.org/)** to get started.\n\n### `hbot` CLI\n\nThe recommended way to run the Hummingbot client directly is the **`hbot` command-line interface**, installed from\nsource. `hbot` runs, controls, and monitors a trading bot non-interactively: start/stop a bot, author\nand tune configs, and read trades, PnL, logs, and status — all scriptable, as compact Markdown with\nstable exit codes. See the **[hbot CLI guide](hummingbot/cli/README.md)** for the full reference.\n\nRequires [Anaconda or Miniconda](https://www.anaconda.com/download).\n\n```bash\n# Clone the repository\ngit clone https://github.com/hummingbot/hummingbot.git\ncd hummingbot\n\n# Create the conda environment, build extensions, and expose the `hbot` CLI\nmake install\n\n# Activate the environment\nconda activate hummingbot\nhbot --help\n```\n\nTo use `hbot` outside the conda environment, run `make link-cli` to add it to your host PATH.\n\nOn first use, `hbot` prompts for a keystore password that encrypts your exchange API keys — set `HBOT_PASSWORD` or pass `--password-stdin` to run non-interactively (e.g. in scripts or agent workflows).\n\nThen create a config and run the `simple_pmm` **paper trading script** — it simulates trading against live Binance market data, so no API keys are required:\n\n```bash\nhbot create simple_pmm --name conf_paper_bot.yml \\\n     --set exchange=binance_paper_trade --set trading_pair=BTC-USDT\nhbot start conf_paper_bot.yml                          # run it (one bot per install)\nhbot status                                            # check on it\nhbot stop                                              # stop gracefully\n```\n\nTo trade **live**, connect your exchange API keys and run a **strategy controller** like `pmm_mister` — a reusable V2 strategy whose settings can be tuned live while the bot runs:\n\n```bash\nhbot connect binance                                   # store API keys (encrypted)\nhbot create pmm_mister --name conf_my_bot.yml \\\n     --set connector_name=binance --set trading_pair=BTC-USDT --set total_amount_quote=100\nhbot start conf_my_bot.yml                             # run it (one bot per install)\n```\n\nFull command reference and ontology: **[hbot CLI guide](hummingbot/cli/README.md)**.\n\n### Docker\n\nPrefer containers? `hbot` works the same way — install [Docker Compose](https://docs.docker.com/compose/install/), then:\n\n```bash\ngit clone https://github.com/hummingbot/hummingbot.git\ncd hummingbot\nmake setup            # answer `y` to \"Include Gateway?\" to add the DEX middleware\nmake deploy           # start the container (interactive client by default)\nmake link-cli         # put the `hbot` command on your host PATH (dispatches into the container)\n\nhbot --help           # same commands as the source install above\n```\n\n`make link-cli` installs a small wrapper that runs `hbot` inside the container, so every command\nabove is identical whether you installed from source or Docker. (Or skip it and use\n`docker exec -it hummingbot hbot \u003ccommand\u003e`.) To dedicate the container to `hbot` instead of the\ninteractive client, uncomment `command: tail -f /dev/null` in `docker-compose.yml` before\n`make deploy` — see [Running in Docker](hummingbot/cli/README.md#running-in-docker).\n\n### Interactive Client (TUI)\n\nThe classic full-screen client is the Docker default:\n`make deploy`, then `docker attach hummingbot` — or run it from source with\n`make install \u0026\u0026 make run`. With Gateway included it starts in development mode\n(unencrypted HTTP); for production HTTPS use the `DEV=false` flag and run `gateway generate-certs`.\nSee [Development vs Production Modes](https://hummingbot.org/gateway/installation/#development-vs-production-modes).\n\n---\n\nFor comprehensive installation instructions and troubleshooting, visit our [Installation](https://hummingbot.org/installation/) documentation.\n\n## Strategies\n\nHummingbot offers several frameworks for building and running algorithmic trading strategies — see the [Strategies docs](https://hummingbot.org/strategies/) for a full overview:\n\n* **[Scripts](./scripts)**: Single-file Python strategies — the easiest way to build and customize your own bot. Example: [`simple_pmm.py`](./scripts/simple_pmm.py), a basic market making script.\n* **[Controllers](./controllers)**: Reusable V2 strategies whose configs can be backtested, deployed, and tuned live while running. Example: [`pmm_mister.py`](./controllers/generic/pmm_mister.py), a full-featured market making controller.\n* **[Executors](./hummingbot/strategy_v2/executors)**: Self-contained building blocks that manage order lifecycles for common patterns — position, DCA, grid, arbitrage, XEMM, TWAP, and LP. Example: [`position_executor`](./hummingbot/strategy_v2/executors/position_executor), which manages a directional position with triple-barrier risk controls.\n* **[V1 Strategies](./hummingbot/strategy)**: Classic legacy strategies such as Pure Market Making, Avellaneda Market Making, and Cross-Exchange Market Making. Example: [`cross_exchange_market_making`](./hummingbot/strategy/cross_exchange_market_making), which market makes on one exchange and hedges fills on another.\n\n## Exchange Connectors\n\nHummingbot connectors standardize REST and WebSocket API interfaces to different types of exchanges, enabling you to build sophisticated trading strategies that can be deployed across many exchanges with minimal changes.\n\n### Connector Types\n\nWe classify exchange connectors into three main categories:\n\n* **CLOB CEX**: Centralized exchanges with central limit order books that take custody of your funds. Connect via API keys.\n  - **Spot**: Trading spot markets\n  - **Perpetual**: Trading perpetual futures markets\n\n* **CLOB DEX**: Decentralized exchanges with on-chain central limit order books. Non-custodial, connect via wallet keys.\n  - **Spot**: Trading spot markets on-chain\n  - **Perpetual**: Trading perpetual futures on-chain\n\n* **AMM DEX**: Decentralized exchanges using Automated Market Maker protocols. Non-custodial, connect via Gateway middleware.\n  - **Router**: DEX aggregators that find optimal swap routes\n  - **AMM**: Traditional constant product (x*y=k) pools\n  - **CLMM**: Concentrated Liquidity Market Maker pools with custom price ranges\n\n### Exchange Sponsors\n\nWe are grateful for the following exchanges that support the development and maintenance of Hummingbot via broker partnerships and sponsorships.\n\n| Exchange | Type | Sub-Type(s) | Connector ID(s) | Discount |\n|------|------|------|-------|----------|\n| [Backpack](https://hummingbot.org/exchanges/backpack/) | CLOB CEX | Spot, Perpetual | `backpack`, `backpack_perpetual` | [![Sign up for Backpack using Hummingbot's referral link!](https://img.shields.io/static/v1?label=Sponsor\u0026message=Link\u0026color=orange)](https://backpack.exchange/join/1tvdqfkk) |\n| [Binance](https://hummingbot.org/exchanges/binance/) | CLOB CEX | Spot, Perpetual | `binance`, `binance_perpetual` | [![Sign up for Binance using Hummingbot's referral link for a 10% discount!](https://img.shields.io/static/v1?label=Fee\u0026message=%2d10%25\u0026color=orange)](https://accounts.binance.com/register?ref=CBWO4LU6) |\n| [Bitget](https://hummingbot.org/exchanges/bitget/) | CLOB CEX | Spot, Perpetual | `bitget`, `bitget_perpetual` | [![Sign up for Bitget using Hummingbot's referral link!](https://img.shields.io/static/v1?label=Sponsor\u0026message=Link\u0026color=orange)](https://www.bitget.com/expressly?channelCode=v9cb\u0026vipCode=26rr\u0026languageType=0) |\n| [Derive](https://hummingbot.org/exchanges/derive/) | CLOB DEX | Spot, Perpetual | `derive`, `derive_perpetual` | [![Sign up for Derive using Hummingbot's referral link!](https://img.shields.io/static/v1?label=Sponsor\u0026message=Link\u0026color=orange)](https://www.derive.xyz/invite/7SA0V) |\n| [Gate.io](https://hummingbot.org/exchanges/gate-io/) | CLOB CEX | Spot, Perpetual | `gate_io`, `gate_io_perpetual` | [![Sign up for Gate.io using Hummingbot's referral link for a 20% discount!](https://img.shields.io/static/v1?label=Fee\u0026message=%2d20%25\u0026color=orange)](https://www.gate.io/referral/invite/HBOTGATE_0_103) |\n| [Hyperliquid](https://hummingbot.org/exchanges/hyperliquid/) | CLOB DEX | Spot, Perpetual | `hyperliquid`, `hyperliquid_perpetual` | - |\n| [KuCoin](https://hummingbot.org/exchanges/kucoin/) | CLOB CEX | Spot, Perpetual | `kucoin`, `kucoin_perpetual` | [![Sign up for Kucoin using Hummingbot's referral link for a 20% discount!](https://img.shields.io/static/v1?label=Fee\u0026message=%2d20%25\u0026color=orange)](https://www.kucoin.com/r/af/hummingbot) |\n| [Meteora](https://hummingbot.org/exchanges/gateway/meteora/) | AMM DEX | CLMM | `meteora` | - |\n| [OKX](https://hummingbot.org/exchanges/okx/) | CLOB CEX | Spot, Perpetual | `okx`, `okx_perpetual` | [![Sign up for OKX using Hummingbot's referral link for a 20% discount!](https://img.shields.io/static/v1?label=Fee\u0026message=%2d20%25\u0026color=orange)](https://www.okx.com/join/1931920269) |\n| [Orca](https://hummingbot.org/exchanges/gateway/orca/) | AMM DEX | CLMM | `orca` | - |\n| [XRP Ledger](https://hummingbot.org/exchanges/xrpl/) | CLOB DEX | Spot | `xrpl` | - |\n\n### Other Exchange Connectors\n\nCurrently, the master branch of Hummingbot also includes the following exchange connectors, which are maintained and updated through the Hummingbot Foundation governance process. See [Governance](https://hummingbot.org/about/governance/) for more information.\n\n| Exchange | Type | Sub-Type(s) | Connector ID(s) | Discount |\n|------|------|------|-------|----------|\n| [0x Protocol](https://hummingbot.org/gateway/connectors/) | AMM DEX | Router | `0x` | - |\n| [Aevo](https://hummingbot.org/exchanges/aevo/) | CLOB CEX | Perpetual | `aevo_perpetual` | - |\n| [Architect](https://hummingbot.org/exchanges/architect/) | CLOB CEX | Perpetual | `architect_perpetual` | - |\n| [Balancer](https://hummingbot.org/exchanges/gateway/balancer/) | AMM DEX | AMM | `balancer` | - |\n| [BingX](https://hummingbot.org/exchanges/bing_x/) | CLOB CEX | Spot | `bing_x` | - |\n| [Bitrue](https://hummingbot.org/exchanges/bitrue/) | CLOB CEX | Spot | `bitrue` | - |\n| [Bitstamp](https://hummingbot.org/exchanges/bitstamp/) | CLOB CEX | Spot | `bitstamp` | - |\n| [BTC Markets](https://hummingbot.org/exchanges/btc-markets/) | CLOB CEX | Spot | `btc_markets` | - |\n| [Bybit](https://hummingbot.org/exchanges/bybit/) | CLOB CEX | Spot, Perpetual | `bybit`, `bybit_perpetual` | - |\n| [Coinbase](https://hummingbot.org/exchanges/coinbase/) | CLOB CEX | Spot | `coinbase_advanced_trade` | - |\n| [Curve](https://hummingbot.org/exchanges/gateway/curve/) | AMM DEX | AMM | `curve` | - |\n| [Decibel](https://hummingbot.org/exchanges/decibel/) | CLOB CEX | Perpetual | `decibel_perpetual` | - |\n| [Dexalot](https://hummingbot.org/exchanges/dexalot/) | CLOB DEX | Spot | `dexalot` | - |\n| [DFlow](https://hummingbot.org/exchanges/gateway/jupiter/#other-solana-routers) | AMM DEX | Router | `dflow` | - |\n| [dYdX](https://hummingbot.org/exchanges/dydx/) | CLOB DEX | Perpetual | `dydx_v4_perpetual` | - |\n| [EVEDEX](https://hummingbot.org/exchanges/evedex/) | CLOB CEX | Perpetual | `evedex_perpetual` | - |\n| [Foxbit](https://hummingbot.org/exchanges/foxbit/) | CLOB CEX | Spot | `foxbit` | - |\n| [Gemini](https://hummingbot.org/exchanges/gemini/) | CLOB CEX | Spot | `gemini` | - |\n| [GRVT](https://hummingbot.org/exchanges/grvt/) | CLOB CEX | Perpetual | `grvt_perpetual` | - |\n| [HTX (Huobi)](https://hummingbot.org/exchanges/htx/) | CLOB CEX | Spot | `htx` | - |\n| [Injective Helix](https://hummingbot.org/exchanges/injective/) | CLOB DEX | Spot, Perpetual | `injective_v2`, `injective_v2_perpetual` | - |\n| [Jupiter](https://hummingbot.org/exchanges/gateway/jupiter/) | AMM DEX | Router | `jupiter` | - |\n| [Kraken](https://hummingbot.org/exchanges/kraken/) | CLOB CEX | Spot | `kraken` | - |\n| [Lambdaplex](https://hummingbot.org/exchanges/lambdaplex/) | CLOB DEX | Spot | `lambdaplex` | - |\n| [Lighter](https://hummingbot.org/exchanges/lighter/) | CLOB DEX | Spot, Perpetual | `lighter`, `lighter_perpetual` | - |\n| [MEXC](https://hummingbot.org/exchanges/mexc/) | CLOB CEX | Spot | `mexc` | - |\n| [NDAX](https://hummingbot.org/exchanges/ndax/) | CLOB CEX | Spot | `ndax` | - |\n| [OKX DEX](https://hummingbot.org/exchanges/gateway/jupiter/#other-solana-routers) | AMM DEX | Router | `okx` | - |\n| [Pacifica](https://hummingbot.org/exchanges/pacifica/) | CLOB CEX | Perpetual | `pacifica_perpetual` | - |\n| [PancakeSwap](https://hummingbot.org/exchanges/gateway/pancakeswap/) | AMM DEX | AMM | `pancakeswap` | - |\n| [Raydium](https://hummingbot.org/exchanges/gateway/raydium/) | AMM DEX | AMM, CLMM | `raydium` | - |\n| [Titan](https://hummingbot.org/exchanges/gateway/jupiter/#other-solana-routers) | AMM DEX | Router | `titan` | - |\n| [Uniswap](https://hummingbot.org/exchanges/gateway/uniswap/) | AMM DEX | Router, AMM, CLMM | `uniswap` | - |\n\n## Other Hummingbot Repos\n\n* [Condor](https://github.com/hummingbot/condor): AI harness for building and running agentic strategies and bot instances\n* [Hummingbot API](https://github.com/hummingbot/hummingbot-api): The central hub for running Hummingbot trading bots\n* [Gateway](https://github.com/hummingbot/gateway): Typescript based API client for DEX connectors\n* [Hummingbot Site](https://github.com/hummingbot/hummingbot-site): Official documentation for Hummingbot - we welcome contributions here too!\n\n## Getting Help\n\nIf you encounter issues or have questions, here's how you can get assistance:\n\n* Consult our [FAQ](https://hummingbot.org/faq/), [Troubleshooting Guide](https://hummingbot.org/troubleshooting/), or [Glossary](https://hummingbot.org/glossary/)\n* To report bugs or suggest features, submit a [GitHub issue](https://github.com/hummingbot/hummingbot/issues)\n* Join our [Discord community](https://discord.gg/hummingbot) and ask questions in the #support channel\n\nWe pledge that we will not use the information/data you provide us for trading purposes nor share them with third parties.\n\n## Contributions\n\nThe Hummingbot architecture features modular components that can be maintained and extended by individual community members.\n\nWe welcome contributions from the community! Please review these [guidelines](./CONTRIBUTING.md) before submitting a pull request.\n\nIf you represent an exchange that wants an official Hummingbot connector, see [How to Add a Hummingbot Connector](https://hummingbot.org/exchanges/#how-to-add-a-hummingbot-connector) for the available integration options.\n\n## Legal\n\n* **License**: Hummingbot is open source and licensed under [Apache 2.0](./LICENSE).\n* **Data collection**: See [Reporting](https://hummingbot.org/reporting/) for information on anonymous data collection and reporting in Hummingbot.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhummingbot%2Fhummingbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhummingbot%2Fhummingbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhummingbot%2Fhummingbot/lists"}