Xây dựng và chạy bot dự đoán Polymarket trong terminal

Bot dự đoán Polymarket là gì?

Polymarket Prediction Bot là một ứng dụng đầu cuối mã nguồn mở, điều khiển bằng bàn phím, dùng để khám phá các thị trường dự đoán trên Polymarket. Ứng dụng kết hợp trình duyệt thị trường, chế độ xem sổ lệnh giới hạn trung tâm theo thời gian thực, công cụ chiến lược, trình theo dõi vị thế và nhật ký khớp lệnh trong giao diện đầu cuối Textual và Rich.

Các thị trường Polymarket thường có các cổ phần YES và NO, được thanh toán ở mức $1 hoặc $0 tùy theo kết quả của một sự kiện thực tế. Vì giá thị trường có thể được hiểu là xác suất ngụ ý, bot sẽ so sánh giá thị trường với các ước tính xác suất hợp lý, phân tích điều kiện của sổ lệnh và phát hiện các tín hiệu lợi thế hoặc kinh doanh chênh lệch giá tiềm năng.

Quan trọng: Đây là một dự án giáo dục không chính thức và không liên kết với Polymarket. Đây không phải là lời khuyên tài chính và không có chiến lược nào đi kèm đảm bảo lợi nhuận. Hãy bắt đầu với --demo, sử dụng bộ dữ liệu đi kèm và các lệnh khớp mô phỏng mà không truy cập ví.

Tính năng chính

• Trình duyệt thị trường: Lọc thị trường theo khối lượng, chênh lệch giá, danh mục và thời gian còn lại đến khi thanh toán.
• Sổ lệnh CLOB: Kiểm tra giá đặt mua và bán của YES và NO, chênh lệch giá, giá trung điểm và mất cân bằng sổ lệnh.
• Công cụ chiến lược: Chạy riêng lẻ hoặc đồng thời các chiến lược lợi thế xác suất, mất cân bằng sổ lệnh và thanh khoản.
• Theo dõi tín hiệu: Xem các phía được đề xuất và giá trị độ tin cậy từ 0 đến 1.
• Giám sát vị thế: Theo dõi khối lượng YES và NO đang mở, giá vốn trung bình, PnL chưa thực hiện bằng USDC và thời gian đếm ngược đến khi thanh toán.
• Nhật ký khớp lệnh: Duy trì bản ghi cục bộ về tín hiệu, lệnh khớp mô phỏng hoặc CLOB và các lệnh hủy.
• Bảng điều khiển: Xem các mã tăng giảm mạnh nhất, chênh lệch giá lớn, thị trường sắp thanh toán và tín hiệu đang chờ xử lý.
• Giao dịch giấy: Kiểm thử quy trình với số dư USDC ảo trước khi cấu hình quyền truy cập trực tiếp.
• Kiểm soát rủi ro: Áp dụng giới hạn mức sử dụng USDC tối đa, giới hạn cho từng thị trường và giới hạn thua lỗ hằng ngày.
• Giao diện đa nền tảng: Chạy ứng dụng trên Windows, macOS hoặc Linux.

Điều kiện tiên quyết

Cài đặt tiêu chuẩn yêu cầu Git, Python 3.11 trở lên và pip. Kho lưu trữ cũng cung cấp các trình khởi chạy một lần nhấp, giải nén trình thông dịch độc lập đi kèm trong lần sử dụng đầu tiên, vì vậy không cần cài đặt Python hệ thống khi sử dụng các trình khởi chạy này.

Cài đặt Bot bằng Python

1. Sao chép kho lưu trữ:

   git clone https://github.com/gulelmatthews/Polymarket-Perpetual-Bot.git

2. Truy cập thư mục dự án:

   cd Polymarket-Perpetual-Bot

3. Cài đặt các gói bắt buộc:

   pip install -r requirements.txt

4. Khởi động với bộ dữ liệu demo đi kèm:

   python main.py --demo

Dự án cũng cung cấp điểm vào gói thông qua python -m polymarket_bot. Logic phân tích đối số dòng lệnh và khởi chạy được triển khai trong gói máy chủ.

Sử dụng trình khởi chạy một lần nhấp

Windows

Chạy trình khởi chạy batch đi kèm:

run.bat

Linux và macOS

Cấp quyền thực thi cho trình khởi chạy shell, sau đó chạy:

chmod +x run.sh
./run.sh

Trong lần sử dụng đầu tiên, các trình khởi chạy này sẽ giải nén trình thông dịch độc lập đi kèm mà ứng dụng yêu cầu.

Điều hướng bảng điều khiển đầu cuối

Giao diện được tổ chức thành sáu chế độ xem chính. Sử dụng các phím số để chuyển trực tiếp giữa các chế độ xem:

• 1: Bảng điều khiển
• 2: Thị trường
• 3: Sổ lệnh
• 4: Chiến lược
• 5: Vị thế
• 6: Nhật ký

Các phím điều khiển bổ sung hỗ trợ quy trình chính:

• /: Lọc danh sách thị trường.
• Enter hoặc b: Mở sổ CLOB cho thị trường đã chọn.
• s: Chạy công cụ chiến lược trên danh sách theo dõi.
• o: Soạn lệnh giao dịch giấy.
• t: Chuyển qua các giao diện có sẵn.
• q: Thoát ứng dụng.

Quy trình demo cơ bản

1. Khởi chạy ứng dụng bằng python main.py --demo.

2. Nhấn 2 để mở trình duyệt thị trường.

3. Sử dụng / để thu hẹp các thị trường hiển thị dựa trên các bộ lọc có sẵn.

4. Chọn một thị trường và nhấn Enter hoặc b để kiểm tra sổ lệnh YES và NO.

5. Xem xét các giá đặt mua và bán tốt nhất, chênh lệch giá, giá trung điểm và mức mất cân bằng tương đối về khối lượng.

6. Nhấn s để quét danh sách theo dõi bằng các chiến lược đã bật.

7. Mở chế độ xem Chiến lược bằng 4 và xem độ tin cậy cùng phía được đề xuất của từng tín hiệu.

8. Nhấn o để soạn lệnh giao dịch giấy khi muốn kiểm thử một tín hiệu.

9. Sử dụng 5 để kiểm tra vị thế và PnL chưa thực hiện, sau đó sử dụng 6 để xem lại các tín hiệu và lệnh khớp mô phỏng.

Tìm hiểu các chiến lược tích hợp

Chiến lược lợi thế xác suất

Chiến lược này so sánh giá thị trường với một mô hình xác suất hợp lý. Chiến lược tạo tín hiệu khi chênh lệch vượt quá ngưỡng đã cấu hình. Ví dụ, nếu xác suất hợp lý theo mô hình cao hơn đáng kể so với giá YES hiện tại, tín hiệu tạo ra có thể đề xuất phía YES.

Chất lượng của tín hiệu này phụ thuộc vào mô hình xác suất hợp lý được cung cấp cho chiến lược. Hãy xem độ tin cậy là một kết quả phân tích, không phải một sự đảm bảo.

Chiến lược mất cân bằng sổ lệnh

Chiến lược mất cân bằng sổ lệnh xem xét quy mô tương đối khả dụng ở phía YES và NO. Độ lệch lớn về quy mô có thể được xem là tín hiệu định hướng. Đây là thông tin từ sổ lệnh, không phải bằng chứng rằng thị trường sẽ di chuyển hoặc được xác định kết quả theo hướng đó.

Chiến lược thanh khoản

Chiến lược thanh khoản tìm kiếm mức chênh lệch giá rộng và khả năng hồi quy về mức trung điểm. Mức chênh lệch rộng có thể tạo ra cơ hội, nhưng cũng có thể cho thấy thanh khoản yếu hoặc rủi ro khớp lệnh cao.

Tín hiệu liên thị trường

Bot có thể hiển thị tín hiệu chênh lệch YES-cộng-NO và kinh doanh chênh lệch giá giữa nhiều kết quả. Cần đánh giá các tín hiệu này cùng với thanh khoản khả dụng, độ sâu sổ lệnh và hạn mức rủi ro, thay vì xem chúng như lợi nhuận tự động.

Cấu hình chế độ trực tiếp

Chế độ trực tiếp yêu cầu thông tin xác thực API Polymarket của riêng bạn. Tạo tệp cấu hình tại ~/.polymarket-bot/config.toml theo cấu trúc sau:

[auth]
private_key    = "0x…"
proxy_address  = "0x…"
api_key        = "…"
api_secret     = "…"
api_passphrase = "…"
endpoint       = "https://clob.polymarket.com"

Khóa riêng là khóa riêng EOA trên Polygon, còn proxy_address là địa chỉ proxy hoặc địa chỉ ký của Polymarket. Ứng dụng chỉ đọc thông tin xác thực từ tệp cấu hình cục bộ này.

Trên các hệ thống hỗ trợ quyền tệp Unix, hãy hạn chế quyền truy cập vào tệp:

chmod 0600 ~/.polymarket-bot/config.toml

Cảnh báo bảo mật: Không bao giờ đưa tệp cấu hình, khóa riêng, API secret hoặc passphrase vào hệ thống quản lý mã nguồn. Dự án cho biết các khóa được giữ cục bộ và không được ghi vào nhật ký.

Sau khi cấu hình thông tin xác thực, có thể khởi động chế độ trực tiếp bằng:

python main.py

Việc đặt lệnh trực tiếp được khóa cho đến khi có cấu hình rõ ràng. Trước tiên, hãy xác thực thiết lập ở chế độ demo, xác nhận các kiểm soát mức độ rủi ro và kiểm tra Polymarket có khả dụng tại khu vực pháp lý của bạn hay không. Dự án không vượt qua cơ chế giới hạn địa lý.

Mẹo sử dụng nâng cao

Kết hợp ngữ cảnh chiến lược

Các chiến lược tích hợp có thể được lựa chọn và kết hợp. Thay vì chỉ hành động dựa trên một chỉ số, hãy so sánh lợi thế xác suất, độ mất cân bằng sổ lệnh, độ rộng chênh lệch giá và độ tin cậy của tín hiệu. Sự đồng thuận giữa các chỉ báo có thể cung cấp thêm ngữ cảnh, dù vẫn không loại bỏ rủi ro giao dịch.

Kiểm tra thanh khoản trước khi cân nhắc tín hiệu

Giá thị trường hiển thị không cho biết có thể khớp bao nhiêu quy mô ở mức giá đó. Hãy mở sổ lệnh và kiểm tra độ sâu bên mua, bên bán, mức chênh lệch, mức trung điểm và độ mất cân bằng trước khi đánh giá lợi thế hoặc tín hiệu kinh doanh chênh lệch giá.

Sử dụng nhật ký như dấu vết giao dịch

Bot ghi lại các tín hiệu, lệnh khớp và lệnh hủy. Xem lại nhật ký có thể giúp bạn so sánh kết quả chiến lược với các kết quả mô phỏng sau đó, đồng thời xác định những trường hợp tín hiệu có độ tin cậy cao không diễn biến như dự kiến.

Theo dõi thời gian xác định kết quả

Sử dụng trình duyệt thị trường và bảng điều khiển để xác định các thị trường sắp được xác định kết quả. Thời điểm xác định kết quả ảnh hưởng đến khoảng thời gian vốn có thể vẫn chịu rủi ro, trong khi chế độ xem Positions cung cấp đồng hồ đếm ngược cho các thị trường đang mở.

Áp dụng kiểm soát rủi ro trước khi sử dụng trực tiếp

Cấu hình và tuân thủ mức phơi nhiễm USDC tối đa, giới hạn cho từng thị trường và giới hạn thua lỗ hằng ngày. Các kiểm soát này đặc biệt quan trọng khi chiến lược được kết nối với các mẫu lệnh trực tiếp.

Tách biệt quy trình demo và trực tiếp

Sử dụng --demo khi tìm hiểu phím tắt, kiểm thử các cách kết hợp chiến lược và quan sát các lệnh khớp mô phỏng. Chỉ chuyển sang chế độ trực tiếp có thông tin xác thực sau khi xác nhận giao diện, cách diễn giải tín hiệu và các thiết lập rủi ro hoạt động như mong đợi.

Cấu trúc dự án

Kho mã tách biệt phần khởi động dòng lệnh, cấu hình, logic chiến lược, mô hình dữ liệu và giao diện terminal:

polymarket-prediction-bot/
├── main.py
├── polymarket_bot/
│   ├── __main__.py
│   ├── cli.py
│   ├── config.py
│   ├── core/
│   └── tui/
├── support/
├── requirements.txt
├── run.bat
├── run.sh
└── release/

main.py là điểm vào chính, trong khi polymarket_bot/core/ chứa các mô hình, công cụ thực thi chiến lược và dữ liệu mô phỏng. Thư mục polymarket_bot/tui/ chứa các màn hình, tiện ích và kiểu giao diện Textual. Thư mục release/ được dành cho các tệp nhị phân biên dịch sẵn dự kiến phát hành.

Kết luận

Polymarket Prediction Bot cung cấp quy trình terminal thống nhất để duyệt các thị trường dự đoán, kiểm tra thanh khoản CLOB, tạo tín hiệu chiến lược và theo dõi vị thế cũng như lệnh khớp. Bắt đầu bằng python main.py --demo, làm quen với giao diện điều khiển bằng bàn phím, đánh giá tín hiệu trong đúng ngữ cảnh và áp dụng các kiểm soát phơi nhiễm nghiêm ngặt trước khi cân nhắc chế độ trực tiếp có thông tin xác thực.

Dự án được phân phối theo Giấy phép MIT và nhằm phục vụ như một bộ công cụ giáo dục độc lập, không phải lời khuyên tài chính.