Polymarket Alpha Bot là một nền tảng mã nguồn mở do Chainstack phát triển để phát hiện alpha và quản lý vị thế trên Polymarket. Repo này giải quyết bài toán tìm danh mục phòng hộ giữa các thị trường dự đoán có tương quan bằng quy tắc định sẵn kết hợp LLM. Nó phù hợp với nhà phát triển, trader nghiên cứu và team muốn tự động hóa chiến lược trên Polymarket.

Thank you for reading this post, don't forget to subscribe!

Những điểm chính

• Polymarket Alpha Bot là nền tảng mã nguồn mở giúp phát hiện cơ hội alpha và danh mục phòng hộ trên Polymarket bằng quy tắc kết hợp LLM.
• Hệ thống gồm năm bước: nhóm thị trường, suy luận quan hệ bằng LLM, xác nhận cặp giao dịch, tính chi phí và lợi nhuận kỳ vọng, theo dõi vị thế.
• Phiên bản hiện tại giao dịch trên Polymarket V2 với pUSD; phần V1 dùng USDC.e đã ngừng và có thể xem lại bằng git checkout v1-final.
• Bạn cần OpenRouter LLM, RPC node, EOA signing key và Relayer API key để chạy giao dịch qua deposit wallet.
• Repo phù hợp cho nghiên cứu và xây dựng bot giao dịch, không phải lời khuyên tài chính.

Polymarket Alpha Bot là gì và giải quyết vấn đề gì?

Polymarket Alpha Bot là nền tảng phát hiện alpha trên Polymarket, giúp tìm danh mục phòng hộ giữa các thị trường dự đoán có tương quan. Bot tự động nhóm thị trường, dùng LLM suy ra quan hệ, chọn cặp hợp lệ rồi theo dõi vị thế.

Repository này thuộc hệ sinh thái Chainstack, nhà cung cấp hạ tầng Web3. Phiên bản mới nhất giao dịch với Polymarket V2 dùng pUSD; legacy V1 với USDC.e đã ngừng. Bạn có thể đọc mã nguồn và tài liệu chi tiết tại repository polymarket-alpha-bot trên GitHub.

Cách hoạt động của Polymarket Alpha Bot như thế nào?

Hệ thống hoạt động theo pipeline năm bước: Groups lấy thị trường từ Polymarket, Implications dùng LLM tìm quan hệ giữa các nhóm, Validation kiểm tra từng cặp thị trường, Portfolios tính chi phí và lợi nhuận, Positions theo dõi vị thế đã mua. Mục tiêu là tìm cơ hội chênh lệch và phòng hộ, không phải đoán hướng giá.

Năm bước chính trong pipeline

• Groups: lấy danh sách thị trường từ Polymarket, ví dụ nhóm «Presidential Election Winner».
• Implications: LLM tìm quan hệ logic giữa các nhóm thị trường.
• Validation: LLM xác nhận các quan hệ ở mức từng thị trường cụ thể.
• Portfolios: tính chi phí và lợi nhuận kỳ vọng cho các cặp hợp lệ dựa trên giá thị trường trực tiếp.
• Positions: theo dõi các cặp vị thế đã mua.

Toàn bộ quy trình này được xây dựng để phát hiện các cặp phòng hộ có lợi nhuận, thay vì đặt cược đơn lẻ theo cảm tính.

Những tính năng nổi bật của repository

Điểm mạnh của Polymarket Alpha Bot là không chỉ đưa ra tín hiệu mà còn hỗ trợ toàn bộ vòng đời giao dịch: từ phát hiện cặp, xem dashboard, vào lệnh, quản lý vị thế, cho đến các script nghiên cứu độc lập. Nó cũng tích hợp cấu hình cho AI coding agent để phát triển nhanh hơn.

Dashboard và API

Sau khi chạy, bạn có dashboard tại http://localhost:3000 và API docs tại http://localhost:8000/docs. Pipeline có thể chạy bằng lệnh make pipeline hoặc ngay từ giao diện. Điều này giúp quan sát từng bước thay vì chỉ nhận kết quả cuối.

Tích hợp AI coding agent

Repo có thư mục .claude/ với CLAUDE.md, hooks tự động lint và Agent Skills theo chuẩn SKILL.md. Các kỹ năng gồm alphapoly-pipeline, alphapoly-portfolios, alphapoly-enter-position, alphapoly-exit-position, alphapoly-feature, alphapoly-experiment. Nếu dùng Codex CLI, bạn có thể trỏ tới .claude/skills/ hoặc copy vào ~/.codex/skills/.

Bộ script thí nghiệm

Thư mục experiments/ chứa các script độc lập. Nhóm trading/ giúp thiết lập deposit wallet, wrap USDC.e sang pUSD, mua và chuyển token. Nhóm onchain-otc/ mô phỏng OTC trên Anvil fork của Polygon. Nhóm verify/ kiểm tra luồng deposit wallet với SDK chính thức của Polymarket.

Làm thế nào để cài đặt và chạy Polymarket Alpha Bot?

Để chạy Polymarket Alpha Bot, bạn cần cài uv và Node.js 18 trở lên, sau đó tạo file .env từ .env.example và cấu hình OpenRouter LLM cùng RPC node. Nếu muốn giao dịch thật, bạn phải chuẩn bị thêm EOA signing key và Relayer API key.

Trong quá trình chạy thử, tôi nhận thấy phần khó nhất không phải cài đặt mà là chuẩn bị đúng loại tài sản và khóa ký. Nếu bỏ sót Relayer API key hoặc quên wrap USDC.e sang pUSD, bot sẽ không đặt lệnh được dù pipeline chạy bình thường.

Yêu cầu cần chuẩn bị

• uv để quản lý Python.
• Node.js 18 trở lên, cài qua fnm, nvm hoặc brew.
• Một LLM API key từ OpenRouter và một RPC node cho Polymarket/Polygon.
• EOA signing key và Relayer API key tạo tại polymarket.com/settings?tab=api-keys.
• pUSD để nạp vào deposit wallet, không cần POL vì relayer trả gas.

Các bước cài đặt nhanh

1. Copy file cấu hình: cp .env.example .env.
2. Cài backend: cd backend && uv sync.
3. Cài frontend: cd frontend && npm install.
4. Chạy backend: cd backend && uv run python -m uvicorn server.main:app --port 8000.
5. Chạy frontend: cd frontend && npm run dev.

Nếu dùng make, bạn chỉ cần chạy make install rồi make dev. Lệnh make lint tự sửa code bằng ruff, prettier và eslint. Dashboard mở tại http://localhost:3000, API mở tại http://localhost:8000/docs.

Lưu ý: tài khoản EOA thường không giao dịch trực tiếp được vì bị chặn bởi V2 CLOB allowlist. Bot sẽ triển khai deposit wallet qua relayer và dùng ví đó để đặt lệnh.

Ai nên dùng Polymarket Alpha Bot và ai nên tránh?

Nhóm phù hợp nhất là nhà phát triển có kinh nghiệm với Python, Node.js và ví điện tử, muốn tự động hoá chiến lược trên Polymarket. Người mới không quen dòng lệnh, không sẵn sàng đọc log và tự xử lý lỗi sẽ dễ nản, vì repo này là công cụ nghiên cứu hơn là sản phẩm thương mại.

Nên dùng nếu

• Bạn muốn học cách kết hợp LLM với thị trường dự đoán để tìm cơ hội phòng hộ.
• Bạn đã quen với Python, Node.js và có thể tự debug pipeline.
• Bạn muốn xây dựng bot riêng trên Polymarket V2 và chấp nhận vận hành hạ tầng.

Không nên dùng nếu

• Bạn là người mới hoàn toàn và chỉ muốn có sẵn bot kiếm tiền tự động.
• Bạn không muốn tự trả phí LLM, RPC hay xử lý rủi ro sàn giao dịch.
• Bạn cần sản phẩm thương mại có hỗ trợ khách hàng và bảo đảm lợi nhuận.

Lưu ý và hạn chế cần biết

Dù hữu ích, Polymarket Alpha Bot có vài ràng buộc quan trọng. Phiên bản hiện tại chỉ giao dịch Polymarket V2 với pUSD; tài khoản USDC.e phải wrap sang pUSD trước. Ngoài ra, repo được phát hành cho mục đích giáo dục và nghiên cứu, không phải lời khuyên tài chính, và giao dịch prediction market có thể mất tiền.

Ràng buộc kỹ thuật

• Bare EOA không giao dịch trực tiếp được do allowlist của V2 CLOB; cần deposit wallet được triển khai gaslessly qua relayer.
• Deposit wallet phải được nạp pUSD; relayer trả gas nên bạn không cần POL.
• Legacy V1 với USDC.e đã ngừng từ 2026-04-28. Muốn xem mã cũ, dùng git checkout v1-final.
• Nếu còn giữ USDC.e, hãy wrap sang pUSD bằng script experiments/trading/02_wrap_to_pusd.py.
• Nhóm onchain-otc/ dùng USDC.e vì fork trên Anvil giữ trạng thái trước thời điểm Polymarket chuyển sang V2.

Repo được cung cấp as-is cho mục đích giáo dục và nghiên cứu. Không có gì trong bài được coi là lời khuyên tài chính. Giao dịch thị trường dự đoán có rủi ro mất tiền, hãy tự chịu trách nhiệm khi sử dụng.

Câu hỏi thường gặp

Polymarket Alpha Bot có miễn phí không?

Mã nguồn mở là miễn phí, nhưng bạn phải tự trả chi phí vận hành: LLM từ OpenRouter, RPC node, phí gas do relayer chi trả và pUSD để nạp deposit wallet. Không có phiên bản SaaS nào sẵn sàng bật là chạy ngay.

Tôi có cần biết lập trình để dùng repo này không?

Cần tối thiểu quen với dòng lệnh, Python và Node.js. Việc cài đặt, cấu hình .env, xử lý lỗi pipeline và giao dịch qua deposit wallet đều yêu cầu kỹ thuật. Người không biết lập trình khó tự triển khai và vận hành bot.

Polymarket Alpha Bot có phải bot giao dịch tự động hoàn toàn không?

Không hoàn toàn. Nó giúp phát hiện danh mục phòng hộ, hiển thị cơ hội, theo dõi vị thế và có kỹ năng vào/ra lệnh, nhưng bạn vẫn cần xem xét, xác nhận và kích hoạt giao dịch. Đây là công cụ hỗ trợ quyết định hơn là bot chạy không cần giám sát.

Tôi đang giữ USDC.e từ Polymarket V1 thì phải làm sao?

Bạn cần wrap USDC.e sang pUSD bằng script experiments/trading/02_wrap_to_pusd.py trước khi giao dịch. Phiên bản V1 cũ đã ngừng, mã nguồn vẫn có thể xem qua git checkout v1-final. Không wrap thì bot không thể dùng đúng tài sản thế chấp của V2.

Repo này có hỗ trợ AI coding agent không?

Có. Repository chứa .claude/skills với các kỹ năng như alphapoly-pipeline, alphapoly-enter-position, alphapoly-exit-position. Claude Code đọc trực tiếp, còn Codex CLI có thể trỏ tới .claude/skills hoặc copy sang ~/.codex/skills. AGENTS.md giúp tương thích với nhiều agent khác.

Kết luận

Polymarket Alpha Bot là một repo đáng đọc nếu bạn muốn thấy cách kết hợp LLM, thị trường dự đoán và quy trình giao dịch có cấu trúc. Nó không phải viên đạn bạc, nhưng là tài liệu thực hành tốt để xây dựng hệ thống tìm alpha và quản lý vị thế trên Polymarket. Hãy clone repository gốc tại chainstacklabs/polymarket-alpha-bot, đọc kỹ README, chạy thử pipeline và bắt đầu với số vốn nhỏ nếu bạn thực sự muốn dùng.