Vibe-Trading: Agent giao dịch AI cho backtest & MCP
Vibe-Trading là một agent mã nguồn mở kết nối LLM với dữ liệu thị trường thực, chín backtest engine và các connector broker qua công cụ MCP, thay vì để mô hình tự đoán giá từ trí nhớ. Hãy dùng nếu bạn là developer Python muốn một agent có thể tự chạy và kiểm tra backtest của chính nó; bỏ qua nếu bạn cần hệ thống ổn định để đặt lệnh thực, vì changelog cho thấy các lỗi tính toán cốt lõi vẫn đang được sửa sau khi phát hành.
Agent Giao Dịch AI Cá Nhân Của Bạn
Vibe-Trading là một thư viện Python và AI agent được GitHub gắn tag ai-agent, algorithmic-trading, backtesting, fintech, llm, mcp, multi-agent và quantitative-finance. Chỉ một lệnh, nó kết nối LLM với dữ liệu thị trường, chín backtest engine, các công cụ chỉ báo kỹ thuật và phân tích quyền chọn phục vụ mô hình hóa tài chính, cùng một MCP server — để agent thực sự chạy nghiên cứu định lượng thay vì chỉ mô tả nó từ trí nhớ.
Năng Lực Cốt Lõi Cho Nghiên Cứu Định Lượng
- ✓Chín backtest engine phủ nhiều thị trường, với engine cổ phiếu Hàn Quốc (KRX: KOSPI/KOSDAQ) vừa được thêm làm engine thứ chín, dùng biên giá tại thời điểm khớp lệnh và thuế giao dịch 0,20% năm 2026 trên các lệnh KRX.
- ✓Công cụ technical_indicators tính RSI, MACD, Bollinger Bands, SMA và EMA dựa trên chính các data loader đang dùng trong dự án.
- ✓Công cụ phân tích quyền chọn tính điểm cực trị P&L khi đáo hạn, điểm hòa vốn chính xác, và các kịch bản giá giao ngay so với biến động ngụ ý (IV) qua cả agent lẫn MCP.
- ✓Bốn công cụ dữ liệu chỉ đọc cấp tổ chức: hồ sơ SEC 13F kèm chênh lệch vị thế theo quý, tra cứu thành phần ETF, xác suất ngụ ý từ event contract, và tìm kiếm bài nghiên cứu trên arXiv/OpenAlex.
- ✓Sáu lệnh nghiên cứu cấp tổ chức — /comps, /dcf, /attrib, /memo, /earnings, /screen — cùng các skill theo góc nhìn nhà đầu tư và mẫu nghiên cứu theo lịch.
- ✓Một công cụ sentiment chạy cục bộ chấm điểm văn bản bất kỳ và lấy chỉ số Fear & Greed của crypto mà không cần API key.
- ✓Bộ nhớ agent lâu dài có vòng đời tùy chọn — chấm điểm chất lượng, suy giảm kiểu Ebbinghaus, dọn dẹp chỉ lưu trữ — mặc định tắt cho đến khi bạn bật.
- ✓Mỗi lần backtest danh mục đều ghi ra artifact risk x-ray (risk_xray.json / risk_xray.md) phục vụ quản trị rủi ro, gộp chung mức tập trung, biến động và drawdown trong một file.
Ứng Dụng Cho Chuyên Gia Tài Chính
- •Backtest một chiến lược theo luật trên chín thị trường được hỗ trợ, kể cả engine KRX Hàn Quốc mới, trước khi bỏ vốn thật.
- •Kéo dữ liệu SEC 13F hoặc thành phần ETF vào một memo thẩm định bằng lệnh /comps hoặc /memo.
- •Sàng lọc một tập cổ phiếu lớn khi không có một đáp án tốt nhất duy nhất — Vibe-Trading giờ trả về một shortlist thay vì bị treo.
- •Đưa dữ liệu broker hoặc sàn vào nghiên cứu do agent dẫn dắt qua OpenBB Workspace bridge hoặc các connector MT5/Binance/OKX.
- •Lên lịch các tác vụ nghiên cứu lặp lại có hỗ trợ timezone IANA để chu kỳ không bị lệch khi đổi giờ mùa hè.
Bắt Đầu Với Vibe-Trading
Chỉ được tài liệu hóa rời rạc. Release notes của v0.1.12 đưa ra `pip install -U vibe-trading-ai` để cài/nâng cấp qua pip, và có đường Docker với cài đặt dependency khóa hash mà CI hiện đã kiểm tra. Trạng thái ứng dụng — session, run, swarm run, upload — nằm dưới `~/.vibe-trading`, có thể đổi chỗ qua biến môi trường `VIBE_TRADING_HOME`. Điều hướng của chính README lại trỏ sang một trang Quick Start riêng cho hướng dẫn đầy đủ (API key, kết nối MCP, chạy agent đầu tiên), nhưng trang đó không nằm trong nội dung được cung cấp ở đây — nên phần cài đặt từng bước xem như chưa được tài liệu hóa rõ ràng trong nguồn này.
Điểm mạnh
- ✓Chín backtest engine trải trên nhiều thị trường, kể cả KRX Hàn Quốc mới thêm gần đây, thay vì bó buộc vào một loại tài sản.
- ✓Lỗi được sửa công khai kèm số liệu trước/sau cụ thể trong changelog — một lỗi thiếu số liệu cơ bản 4,2 lần và một lỗi tính lợi nhuận cổ phiếu A lệch tới 47 điểm phần trăm đều được nêu tên và ghi ngày.
- ✓Các công cụ dữ liệu cấp tổ chức mới (13F, ETF look-through, event contract, bài nghiên cứu) đều chỉ đọc, giới hạn những gì một agent hoạt động sai có thể gây ra.
- ✓CLI, MCP server và web UI năm ngôn ngữ đi chung trong một dự án thay vì ba phần được bảo trì riêng lẻ.
Tình Trạng Hiện Tại Và Lưu Ý
- △README có cảnh báo bảo mật đang hoạt động: tài khoản X (VibeTrading_HKU), dự án Virtuals (101845) và một token contract cụ thể đang mạo danh dự án — Vibe-Trading khẳng định chưa từng ra mắt hay xác nhận bất kỳ token nào.
- △Tốc độ sửa lỗi tính toán trong changelog — thiếu số liệu cơ bản 4,2 lần, lỗi giá cổ phiếu A lệch 47 điểm phần trăm, P&L quyền chọn ngày đầu bị bịa lên tới +93% premium — nghĩa là các số agent tạo ra trước một bản vá cụ thể có thể đã sai.
- △Bản nâng cấp MCP 2.0 gây breaking change vẫn chưa được merge, đang chờ hoàn tất di chuyển lock/runtime, nên bề mặt MCP chưa ổn định.
- △Phần cài đặt từng bước ngoài lệnh pip/Docker không được tài liệu hóa trong nội dung có sẵn ở đây — bạn sẽ cần trang Quick Start riêng.
So Sánh Các Framework Agent Giao Dịch
Câu Hỏi Thường Gặp
Changelog của Vibe-Trading cho thấy tần suất sửa lỗi tính toán cốt lõi khá dày sau khi phát hành — một lỗi thiếu số liệu cơ bản 4,2 lần và một lỗi tính lợi nhuận cổ phiếu A lệch 47 điểm phần trăm đều vừa được vá trước thời điểm bài này viết — nên nên xem đây là công cụ nghiên cứu và backtest, chứ không phải hệ thống live trading nếu không có lớp kiểm chứng riêng của bạn.
Vibe-Trading ghi nhận chín backtest engine, với engine cổ phiếu Hàn Quốc (KRX: KOSPI/KOSDAQ) vừa thêm làm engine thứ chín, cùng các connector được nhắc trong changelog cho MT5, Binance, OKX, Tiger, Alpaca, Shoonya, Longbridge, akshare, một OpenBB Workspace bridge, và phân tích quyền chọn cùng hợp đồng tương lai vĩnh cửu USD-M.
Changelog của Vibe-Trading liệt kê hỗ trợ direct-OpenAI reasoning_effort, các model Claude bỏ trường temperature là opus-4-7, opus-5, sonnet-5, và provider zai trên glm-5.1; trang settings cũng tự phát hiện model theo từng provider đã cấu hình.
Vibe-Trading phát hành theo giấy phép MIT, theo metadata trên GitHub của repo.
README của Vibe-Trading có cảnh báo đang hoạt động: tài khoản X VibeTrading_HKU, dự án Virtuals 101845, và một token contract cụ thể không phải tài sản chính thức của dự án, và nhóm phát triển khẳng định chưa từng ra mắt hay xác nhận token hay memecoin nào — đừng kết nối ví hay ký bất cứ gì liên quan tới chúng.
Vibe-Trading lấy dữ liệu từ cái mà changelog gọi là 24 nguồn dữ liệu, có test coverage annualization theo từng nguồn chạy trong CI, và áp dụng điều chỉnh corporate-action — ví dụ giá đóng cửa cổ phiếu A từ Tushare giờ được điều chỉnh quanh ngày ex-dividend sau khi một bản vá đóng khoảng lệch tính lợi nhuận lên tới 47 điểm phần trăm.
Vấn đề mà nó giải quyết
Hỏi thẳng một LLM về giá một mã cổ phiếu trong chat thông thường, bạn sẽ nhận một con số bịa hoặc dữ liệu cũ từ lúc train — không có OHLC theo thời gian thực, không có backtest để kiểm tra tính khả thi của chiến lược, và không có chỗ chạy toán quyền chọn hay đối chiếu hồ sơ SEC với số liệu mà model có thể truy ngược nguồn gốc. Vibe-Trading gắn thẳng lớp công cụ còn thiếu đó vào agent, thay vì để mặc cho một giao diện chat chung chung.
Cách sử dụng
README mô tả Vibe-Trading là 'one command' để trang bị công cụ giao dịch cho một agent, truy cập qua CLI — `vibe-trading run` dùng cho phiên chạy không tương tác — và qua một MCP server để truy cập theo kiểu lập trình. Changelog nhắc tới các lệnh slash cấp tổ chức (`/comps`, `/dcf`, `/attrib`, `/memo`, `/earnings`, `/screen`), một CLI `connector` nạp credential broker từ `~/.vibe-trading/.env`, và chế độ `alpha bench --strict` để kiểm định chiến lược out-of-sample. Web UI có thêm trang Scheduled, ở năm ngôn ngữ, cho các tác vụ lặp lại. Tài liệu lệnh đầy đủ nằm ở trang Docs/Quick Start liên kết, chứ không có trong đoạn README được xem xét ở đây.
Ai nên dùng — và ai nên bỏ qua
Hãy dùng Vibe-Trading nếu bạn là developer Python hoặc dân quant muốn một agent gọi thẳng các công cụ backtest và dữ liệu thị trường thật thay vì đoán số, và bạn chấp nhận được việc dự án vẫn đang sửa dần các lỗi tính toán cốt lõi. Bỏ qua nếu bạn cần một hệ thống đã được kiểm toán để đặt lệnh giao dịch thực, hoặc nếu việc phải theo dõi changelog từng bản vá để tin vào một con số không phải điều bạn muốn làm.
Repo liên quan
Vibe-Trading có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về Vibe-Trading.