Vibe-Trading README

The project's README from github.com/HKUDS/Vibe-Trading. As one markdown file: README.md.

English | 中文 | 日本語 | 한국어 | العربية | Español

Vibe-Trading Logo

Vibe-Trading: Your Personal Trading Agent

One Command to Empower Your Agent with Comprehensive Trading Capabilities

HKUDS%2FVibe-Trading | Trendshift

Python FastAPI React PyPI License
Feishu WeChat Discord

Website  ·  Docs  ·  News  ·  Features  ·  Shadow Account  ·  Demo  ·  Quick Start  ·  Examples  ·  API / MCP  ·  Roadmap  ·  Contributing

pip install vibe-trading-ai


📰 News

⚠️ Security warning: The X account VibeTrading_HKU, Virtuals project 101845, and token contract 0x640BDBF77b6447E8b7DB7894cED84BD1c40571f4 are not official Vibe-Trading assets. We have never launched or endorsed any token or memecoin. Do not buy, connect a wallet, or sign anything. Details.

Earlier news
  • 2026-09-07 🪙 A 50-ounce gold order rounded down to nothing, and a currency future priced at 1/2500th of its contract size: in a cross-market backtest the composite engine dispatches every symbol through one shared sub-engine per market, but only apply_slippage refreshed that sub-engine's own active symbol — so round_size and calc_commission used whichever symbol had synced it last. A 50 oz gold position sized against FX's 1,000-unit micro lot rounded to 0, gold futures were charged the index future's rate-based fee (6.90) instead of their own flat one (20.00), and swap used the 100,000-unit standard lot rather than the 100 oz metal lot (#1370). Separately, _extract_product could not read a symbol whose product code contains a digit or ends in a letter that doubles as a month code: 6EZ4, 6JH25, M2K, MYM2503 and FESX2503 all fell through to the default multiplier of 50 — for 6E the true figure is 125,000 (#1369). Symbols now resolve against the multiplier table itself, longest match first, which also covers the dated forms (M2KZ4) and prefix collisions (SILZ4 vs SI). Fixed: four Alpha Zoo factors printed a hard ±1 or 0 through a trading halt and inside their own declared warmup, because a NaN comparison is False rather than NaN and the ternary fell through to its constant. min_warmup_bars is metadata that nothing trims, and what keeps a gap out of an IC is dropna() — so those constants were consumed as real signals (#1371, #1372, #1373, #1374). Measuring the whole zoo the same way puts 82 more alphas in the same shape; rather than one PR per alpha, that is now tracked as a registry-level guard in #1376. Strategy-discovery evidence also resolved position size once for the whole run instead of per regime, and a single unparseable benchmark cell could erase every evidence row that run produced (#1368). New: a run that keeps issuing tool calls without gaining information now stops after eight iterations with a visible recovery request, instead of spending its whole budget on path discovery — the reported case burned ~35 iterations re-guessing the same rejected paths. An identical call is refused from its second failure rather than its first, so one honest retry after a rate limit or a timeout still runs (#1363, closes #1353). Thanks @Shizoqua, @be-student, and @nandofmike!
  • 2026-09-06 🛡️ A buy limit sized at a price it would never fill at, and an audit that returned PASS having verified nothing: the MCP order gate priced a quantity order from the live quote alone, so a limit at twice the market cleared a cap sized for the quote and could fill at twice the authorized notional. It is sized at the worse of quote and limit now — the rule the direct-SDK path already used — and an unparseable limit price is denied rather than waved through (#1361). The report auditor skipped every point with no fetched value and then reported PASS because nothing had failed, certifying a report backed by no evidence at all; that fails closed now (#1362). Fixed: metrics survived a failed analysis tool, and the new exemption for attributed figures — right for a paper's Sharpe, wrong for a price this run is meant to observe — would have passed Analysts say TSLA.US last traded at 412.35 USD. with no tool call behind it (#1338, closes #1336); a cash-dividend row killed the whole trade-journal parse (#1356); compac

Vibe-Trading (HKUDS/Vibe-Trading)

Searching Database…

What is this?Vibe-Trading is a personal trading agent toolkit that gives an AI agent full trading capabilities in one command — market data, backtesting, a quant research library, and order execution across many brokers and markets.
Is this a ready-made trading bot or a toolkit I wire into my own agent?It is a toolkit/API that exposes trading capabilities (market data, backtesting, broker execution) to an AI agent through MCP, a REST API, a CLI and a web UI — it is not a pre-packaged auto-trading bot.
What do I need besides Python to actually trade?You need API credentials for whichever broker/exchange you connect, since it integrates 14+ brokers including Alpaca, MT5, eToro, Futu, and Zerodha Kite Connect, plus data sources like tushare and akshare for China markets.
Is it safe to run live right away, or should I stick to paper trading at first?The changelog shows frequent correctness fixes to live-trading paths (broker error handling, order sizing, NaN/lookahead bugs), and several brokers like Zerodha are currently capped at paper or read-only mode — treat live trading cautiously and verify behavior per broker.
Which markets and asset classes does it cover?It spans US and China equities, China futures (SHFE, CFFEX, GFEX, ZCE), UK equities (LSE), crypto exchanges, FX, and includes a 462-strategy Alpha Zoo plus a quant library (options, copulas, CDS, rate models).
What is the Alpha Zoo?It is a built-in library of 462 trading alpha signals/strategies, with a shared registry that enforces data-quality rules like masking outputs when inputs are missing (NaN handling) so a bug in one alpha cannot be masked by a default value.
What quant models come out of the box?The Quant Library ships models like Heston, Hierarchical Risk Parity, copulas, VPIN/Roll/Amihud/Kyle microstructure measures, barrier options with finite-difference Greeks, ISDA CDS pricing, Key Rate Duration, Vasicek, and event-study/group-purged cross-validation tools.
Is there an official Vibe-Trading token or coin?No. The project explicitly warns that the X account VibeTradingHKU, a Virtuals project listing, and a specific token contract address are not official and should not be trusted — do not connect a wallet or sign anything related to them.
Which languages does the interface support?The README lists English, Chinese, Japanese, Korean, Arabic and Spanish, and the latest release added Brazilian Portuguese as an eighth supported locale.
Creator
HKUDS
Size
87.4 MB
Stars
35.7K
Age
6mo
Commits · 90 Days