TÓM TẮT
Polymarket CLI là một công cụ dòng lệnh dựa trên Rust cho phép bạn duyệt các thị trường dự đoán, đặt lệnh, quản lý vị thế và tương tác với các hợp đồng trên chuỗi trực tiếp từ thiết bị đầu cuối của mình. Cài đặt qua Homebrew hoặc script shell, duyệt thị trường mà không cần ví và giao dịch bằng đầu ra JSON để tự động hóa. Yêu cầu khóa riêng tư cho các hoạt động giao dịch. Hỗ trợ định dạng đầu ra bảng và JSON cho cả mục đích dễ đọc và lập trình.
Giới thiệu
Các thị trường dự đoán đã nổi lên như những công cụ mạnh mẽ để dự báo các sự kiện trong thế giới thực, từ kết quả bầu cử đến biến động giá tiền điện tử. Polymarket, được xây dựng trên Polygon, cung cấp một trong những thị trường dự đoán có tính thanh khoản cao nhất với hàng triệu đô la khối lượng giao dịch. Mặc dù giao diện web trực quan, các nhà phát triển thường muốn truy cập theo chương trình để tự động hóa, viết script và xây dựng bot giao dịch tùy chỉnh.
Đó là lúc Polymarket CLI xuất hiện. Công cụ dòng lệnh dựa trên Rust này cung cấp quyền truy cập hoàn chỉnh vào hệ sinh thái Polymarket từ thiết bị đầu cuối của bạn. Cho dù bạn muốn duyệt thị trường, phân tích sổ lệnh hay thực hiện các giao dịch tự động, Polymarket CLI cung cấp một giao diện mạnh mẽ tích hợp liền mạch với các script shell và quy trình tự động hóa.
Polymarket là gì?
Polymarket là một nền tảng thị trường dự đoán phi tập trung được xây dựng trên blockchain Polygon. Nó cho phép người dùng giao dịch về kết quả của các sự kiện trong thế giới thực bằng cách sử dụng stablecoin USDC. Các thị trường được cấu trúc dưới dạng câu hỏi có/không, với giá thể hiện xác suất của một kết quả (ví dụ: 52¢ nghĩa là xác suất 52%).
Các tính năng chính của Polymarket bao gồm:
- Giao dịch phi tập trung: Được xây dựng trên Polygon cho các giao dịch nhanh chóng, chi phí thấp
- Thị trường thời gian thực: Hàng ngàn thị trường bao gồm chính trị, tiền điện tử, thể thao và nhiều hơn nữa
- Mô hình sổ lệnh: Sổ lệnh giới hạn tập trung (CLOB) để khám phá giá
- Token có điều kiện: Token ERC-1155 đại diện cho cổ phần kết quả
- Chương trình phần thưởng: Các nhà giao dịch có thể kiếm phần thưởng dựa trên khối lượng giao dịch
Polymarket CLI kết nối với các thị trường này thông qua sự kết hợp của API ngoài chuỗi (để đọc dữ liệu thị trường và đặt lệnh) và các hợp đồng trên chuỗi (cho các hoạt động token như tách, hợp nhất và đổi thưởng).
Cài đặt Polymarket CLI
Polymarket CLI hỗ trợ nhiều phương pháp cài đặt. Chọn phương pháp phù hợp với môi trường của bạn.
Tùy chọn 1: Homebrew (macOS / Linux)
Phương pháp cài đặt dễ nhất sử dụng Homebrew:
# Thêm Polymarket tap
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
# Cài đặt polymarket
brew install polymarket
Tùy chọn 2: Shell Script (Linux/macOS)
Để cài đặt nhanh chóng chỉ với một dòng lệnh:
curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
Thao tác này sẽ tải xuống tệp nhị phân mới nhất và cài đặt nó vào PATH của bạn.
Tùy chọn 3: Xây dựng từ mã nguồn (Tất cả nền tảng)
Nếu bạn đã cài đặt Rust, bạn có thể xây dựng từ mã nguồn:
git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .
Xác minh cài đặt
Kiểm tra xem quá trình cài đặt có thành công không:
polymarket --version
polymarket --help
Bạn sẽ thấy thông tin phiên bản và thông báo trợ giúp với các lệnh có sẵn.
Bắt đầu nhanh: Duyệt thị trường không cần ví
Một trong những tính năng tốt nhất của Polymarket CLI là bạn không cần ví để duyệt thị trường. Điều này làm cho nó hoàn hảo cho việc nghiên cứu và giám sát trước khi cam kết quỹ.
Duyệt thị trường gần đây
# Liệt kê 5 thị trường gần đây nhất
polymarket markets list --limit 5
Đầu ra dự kiến:
Tìm kiếm thị trường cụ thể
# Tìm kiếm các thị trường liên quan đến Bitcoin
polymarket markets search "bitcoin" --limit 5
Lọc theo trạng thái và khối lượng
# Liệt kê các thị trường đã đóng
polymarket markets list --closed true --limit 20
Duyệt sự kiện
Các sự kiện nhóm các thị trường liên quan lại với nhau. Ví dụ, sự kiện "Bầu cử 2024" chứa nhiều thị trường về các khía cạnh khác nhau của cuộc bầu cử.
# Liệt kê các sự kiện gần đây
polymarket events list --limit 10
# Lọc sự kiện theo thẻ
polymarket events list --tag politics --active true
# Lấy một sự kiện cụ thể
polymarket events get 500
Thiết lập và cấu hình ví
Mặc dù việc duyệt không yêu cầu ví, nhưng giao dịch thì có. Dưới đây là cách thiết lập ví của bạn.
Tạo ví mới
# Tạo ví mới (tạo khóa ngẫu nhiên, lưu vào cấu hình)
polymarket wallet create
Thao tác này tạo một khóa riêng tư mới và lưu trữ nó trong tệp cấu hình của bạn tại ~/.config/polymarket/config.json.
Nhập ví hiện có
Nếu bạn đã có ví với tiền:
polymarket wallet import 0xYOUR_PRIVATE_KEY_HERE
Vị trí tệp cấu hình
Tệp cấu hình được lưu trữ tại ~/.config/polymarket/config.json và trông như sau:
{
"private_key": "0xabc123...",
"chain_id": 137,
"signature_type": "proxy"
}
Phương pháp cấu hình ví
Bạn có thể cung cấp khóa riêng tư của mình theo ba cách (được kiểm tra theo thứ tự này):
- Cờ CLI:
--private-key 0xabc... - Biến môi trường:
POLYMARKET_PRIVATE_KEY=0xabc... - Tệp cấu hình:
~/.config/polymarket/config.json
Loại chữ ký
Polymarket hỗ trợ ba loại chữ ký:
| Loại | Mô tả |
|---|---|
proxy (mặc định) | Sử dụng hệ thống ví proxy của Polymarket |
eoa | Ký trực tiếp bằng khóa của bạn |
gnosis-safe | Đối với ví multisig |
Ghi đè cho mỗi lệnh bằng --signature-type eoa.
Kiểm tra trạng thái ví
# Hiển thị thông tin ví đầy đủ
polymarket wallet show
# In địa chỉ
polymarket wallet address
Phê duyệt hợp đồng
Trước khi giao dịch, bạn cần phê duyệt các hợp đồng Polymarket:
# Kiểm tra các phê duyệt hiện tại (chỉ đọc)
polymarket approve check
# Phê duyệt tất cả các hợp đồng (gửi 6 giao dịch trên chuỗi)
polymarket approve set
Lưu ý: Việc phê duyệt hợp đồng yêu cầu MATIC để trả phí gas trên Polygon.
Khám phá thị trường và sự kiện
Hãy tìm hiểu sâu hơn về các lệnh khám phá thị trường.
Lệnh thị trường
# Lấy thông tin thị trường chi tiết
polymarket markets get will-bitcoin-hit-100k
# Lấy các thẻ cho một thị trường
polymarket markets tags MARKET_ID
# Liệt kê các thị trường với nhiều bộ lọc khác nhau
polymarket markets list \
--active true \
--order volume_num \
--limit 20 \
--offset 10
Lệnh sự kiện
# Liệt kê các sự kiện với bộ lọc
polymarket events list --active true --limit 10
# Lấy thẻ sự kiện
polymarket events tags EVENT_ID
# Chuỗi (các sự kiện định kỳ như thị trường hàng tuần)
polymarket series list --limit 10
polymarket series get SERIES_ID
Lệnh thẻ
# Liệt kê tất cả các thẻ
polymarket tags list
# Lấy thông tin thẻ cụ thể
polymarket tags get politics
# Tìm các thẻ liên quan
polymarket tags related politics
Lệnh Sổ lệnh CLOB
Kiểm tra giá và sổ lệnh mà không cần ví:
# Kiểm tra tình trạng API
polymarket clob ok
# Lấy giá cho một token
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID
# Lấy chênh lệch
polymarket clob spread TOKEN_ID
# Lấy sổ lệnh
polymarket clob book TOKEN_ID
# Giá giao dịch cuối cùng
polymarket clob last-trade TOKEN_ID
# Lịch sử giá
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
Tùy chọn khoảng thời gian: 1m, 1h, 6h, 1d, 1w, max
Giao dịch trên Polymarket
Bây giờ đến phần thú vị nhất—đặt lệnh. Các lệnh này yêu cầu một ví đã được cấu hình.
Đặt lệnh
# Đặt lệnh giới hạn (mua 10 cổ phần với giá $0.50)
polymarket clob create-order \
--token TOKEN_ID \
--side buy \
--price 0.50 \
--size 10
# Đặt lệnh thị trường (mua trị giá $5)
polymarket clob market-order \
--token TOKEN_ID \
--side buy \
--amount 5
# Đặt nhiều lệnh cùng lúc
polymarket clob post-orders \
--tokens "TOKEN1,TOKEN2" \
--side buy \
--prices "0.40,0.60" \
--sizes "10,10"
Loại lệnh: GTC (Good Till Cancel - mặc định), FOK (Fill or Kill), GTD (Good Till Date), FAK (Fill and Kill)
Thêm --post-only cho các lệnh giới hạn chỉ thêm thanh khoản.
Quản lý lệnh
# Xem các lệnh của bạn
polymarket clob orders
# Lấy chi tiết lệnh cụ thể
polymarket clob order ORDER_ID
# Hủy một lệnh duy nhất
polymarket clob cancel ORDER_ID
# Hủy nhiều lệnh
polymarket clob cancel-orders "ORDER1,ORDER2"
# Hủy tất cả các lệnh cho một thị trường
polymarket clob cancel-market --market CONDITION_ID
# Hủy tất cả các lệnh
polymarket clob cancel-all
Kiểm tra số dư và giao dịch
# Kiểm tra số dư USDC
polymarket clob balance --asset-type collateral
# Kiểm tra số dư token có điều kiện
polymarket clob balance --asset-type conditional --token TOKEN_ID
# Xem các giao dịch của bạn
polymarket clob trades
# Cập nhật số dư (làm mới từ chuỗi)
polymarket clob update-balance --asset-type collateral
Phần thưởng và Khóa API
# Kiểm tra phần thưởng
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards
# Kiểm tra xem các lệnh có đang tính điểm phần thưởng không
polymarket clob order-scoring ORDER_ID
# Tạo khóa API để truy cập theo chương trình
polymarket clob create-api-key
# Liệt kê các khóa API của bạn
polymarket clob api-keys
Thao tác On-Chain
Polymarket CLI cũng hỗ trợ tương tác trực tiếp với các hợp đồng trên chuỗi.
Thao tác CTF (Khung Token có điều kiện)
# Tách $10 USDC thành token CÓ/KHÔNG
polymarket ctf split --condition CONDITION_ID --amount 10
# Hợp nhất token trở lại USDC
polymarket ctf merge --condition CONDITION_ID --amount 10
# Đổi token thắng sau khi giải quyết
polymarket ctf redeem --condition CONDITION_ID
Lưu ý: Các thao tác trên chuỗi yêu cầu MATIC để trả phí gas trên Polygon.
Thao tác Bridge
Gửi tài sản từ các chuỗi khác:
# Lấy địa chỉ gửi tiền cho EVM, Solana, Bitcoin
polymarket bridge deposit YOUR_POLYGON_ADDRESS
# Liệt kê các chuỗi và token được hỗ trợ
polymarket bridge supported-assets
# Kiểm tra trạng thái gửi tiền
polymarket bridge status DEPOSIT_ADDRESS
Dữ liệu danh mục đầu tư
# Xem các vị thế hiện tại
polymarket data positions YOUR_WALLET_ADDRESS
# Xem các vị thế đã đóng
polymarket data closed-positions YOUR_WALLET_ADDRESS
# Tổng giá trị danh mục đầu tư
polymarket data value YOUR_WALLET_ADDRESS
# Lịch sử giao dịch
polymarket data trades YOUR_WALLET_ADDRESS --limit 50
Sử dụng đầu ra JSON cho tập lệnh
Một trong những tính năng mạnh mẽ nhất của Polymarket CLI là đầu ra JSON, làm cho nó hoàn hảo cho việc viết script và tự động hóa.
Đầu ra JSON cơ bản
# Lấy thị trường dưới dạng JSON
polymarket -o json markets list --limit 10
Đầu ra:
[
{"id": "12345", "question": "Will BTC hit $100k?", "outcomePrices": ["0.67", "0.33"], ...},
{"id": "67890", "question": "Will ETH flip BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]
Sử dụng với jq
# Trích xuất chỉ các câu hỏi
polymarket -o json markets list --limit 100 | jq '.[].question'
# Lấy dữ liệu giá cụ thể
polymarket -o json clob midpoint TOKEN_ID | jq '.mid'
# Lọc thị trường theo khối lượng
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'
Xử lý lỗi trong tập lệnh
#!/bin/bash
# Ví dụ: Kiểm tra số dư với xử lý lỗi
if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
echo "Không thể lấy số dư"
exit 1
fi
balance=$(echo "$result" | jq -r '.balance')
echo "Số dư của bạn: $balance USDC"
Tự động hóa giám sát thị trường
Tạo một trình giám sát thị trường đơn giản:
#!/bin/bash
# monitor-market.sh - Giám sát giá của một thị trường cụ thể
TOKEN_ID=$1
INTERVAL=${2:-60} # Mặc định 60 giây
while true; do
clear
echo "Giám sát thị trường: $(date)"
polymarket clob price $TOKEN_ID --side buy
polymarket clob price $TOKEN_ID --side sell
echo ""
polymarket clob book $TOKEN_ID | head -20
sleep $INTERVAL
done
Chạy nó với: ./monitor-market.sh TOKEN_ID 30
Kiểm tra API Polymarket với Apidog
Khi xây dựng các hệ thống giao dịch tự động hoặc tích hợp Polymarket vào ứng dụng của bạn, việc kiểm tra API kỹ lưỡng là điều cần thiết. Apidog cung cấp một nền tảng phát triển API mạnh mẽ, tất cả trong một giúp việc kiểm tra API thị trường dự đoán trở nên đơn giản và hiệu quả.
Tại sao nên dùng Apidog cho tích hợp Polymarket?
Cho dù bạn đang xây dựng một bot giao dịch, một bảng điều khiển phân tích thị trường hay tích hợp dữ liệu Polymarket vào ứng dụng của mình, Apidog đều mang lại một số lợi thế:
- Client API trực quan: Gửi yêu cầu và kiểm tra phản hồi mà không cần viết mã
- Kiểm thử tự động: Tạo các bộ kiểm thử để xác minh logic giao dịch của bạn
- Biến môi trường: Quản lý các điểm cuối API và thông tin xác thực trên các môi trường dev/staging/prod
- Cộng tác: Chia sẻ định nghĩa API với nhóm của bạn
Chế độ Shell tương tác
Để khám phá tương tác, hãy sử dụng shell tích hợp:
polymarket shell
Thao tác này mở một REPL tương tác:
polymarket> markets list --limit 3
polymarket> clob book TOKEN_ID
polymarket> exit
Shell hỗ trợ lịch sử lệnh, giúp dễ dàng thử nghiệm với các lệnh khác nhau.
Các quy trình làm việc phổ biến
Quy trình làm việc 1: Nghiên cứu và Giao dịch
# Bước 1: Tìm các thị trường thú vị
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k
# Bước 2: Kiểm tra sổ lệnh và giá
polymarket clob book TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d
# Bước 3: Kiểm tra số dư của bạn
polymarket clob balance --asset-type collateral
# Bước 4: Đặt lệnh giao dịch
polymarket clob market-order --token TOKEN_ID --side buy --amount 10
Quy trình làm việc 2: Quản lý danh mục đầu tư
# Xem tất cả các vị thế
polymarket data positions YOUR_ADDRESS
# Kiểm tra tổng giá trị
polymarket data value YOUR_ADDRESS
# Xem lịch sử giao dịch
polymarket data trades YOUR_ADDRESS --limit 50
# Kiểm tra các lệnh mở
polymarket clob orders
Quy trình làm việc 3: Bot giao dịch tự động
#!/bin/bash
# Bot đơn giản: mua khi giá giảm xuống dưới ngưỡng
TOKEN_ID="YOUR_TOKEN_ID"
THRESHOLD=0.45
AMOUNT=10
# Lấy giá hiện tại
PRICE=$(polymarket -o json clob midpoint $TOKEN_ID | jq -r '.mid')
# Chuyển đổi sang số thập phân
PRICE_DECIMAL=$(echo "scale=2; $PRICE / 100" | bc)
if (( $(echo "$PRICE_DECIMAL < $THRESHOLD" | bc -l) )); then
echo "Giá ($PRICE_DECIMAL) dưới ngưỡng ($THRESHOLD) - đang mua"
polymarket clob market-order --token $TOKEN_ID --side buy --amount $AMOUNT
else
echo "Giá ($PRICE_DECIMAL) trên ngưỡng - đang giữ"
fi
Những cân nhắc về bảo mật
Khi sử dụng Polymarket CLI, hãy ghi nhớ các thực hành bảo mật tốt nhất sau:
Bảo mật khóa riêng
- Không bao giờ cam kết khóa riêng tư của bạn vào kiểm soát phiên bản
- Sử dụng tệp cấu hình thay vì biến môi trường trong các môi trường được chia sẻ
- Cân nhắc tích hợp ví phần cứng cho các khoản tiền lớn
- Sử dụng một ví riêng biệt để giao dịch CLI (không phải ví chính của bạn)
Xác minh giao dịch
- Luôn xác minh chi tiết giao dịch trước khi xác nhận
- Bắt đầu với số lượng nhỏ để kiểm tra thiết lập của bạn
- Giữ số dư MATIC của bạn đủ để trả phí gas
Quản lý khóa API
# Tạo khóa API chuyên dụng cho các tập lệnh
polymarket clob create-api-key
# Liệt kê và quản lý khóa
polymarket clob api-keys
# Xóa các khóa bị xâm phạm
polymarket clob delete-api-key
Bảo mật mạng
- Sử dụng CLI qua HTTPS (mặc định)
- Cẩn trọng khi sử dụng khóa riêng tư trong môi trường đám mây
- Cân nhắc sử dụng VPN khi giao dịch từ mạng công cộng
Kết luận
Polymarket CLI là một công cụ mạnh mẽ dành cho các nhà phát triển muốn tương tác với các thị trường dự đoán theo chương trình. Cho dù bạn là một nhà giao dịch đang tìm cách tự động hóa chiến lược, một nhà nghiên cứu phân tích dữ liệu thị trường hay một nhà phát triển xây dựng bot giao dịch, CLI đều cung cấp một giao diện mạnh mẽ cho hệ sinh thái Polymarket.
Những điểm chính từ hướng dẫn này:
- Cài đặt qua Homebrew hoặc script shell để thiết lập nhanh chóng
- Duyệt thị trường mà không cần ví để nghiên cứu
- Cấu hình ví của bạn đúng cách trước khi giao dịch
- Sử dụng đầu ra JSON để viết script và tự động hóa
- Luôn ưu tiên bảo mật khi xử lý khóa riêng tư
- Bắt đầu với các giao dịch nhỏ để kiểm tra thiết lập của bạn
- Sử dụng Apidog để kiểm tra và xác thực các tích hợp API Polymarket của bạn
Đối với các trường hợp sử dụng nâng cao hơn, hãy cân nhắc kết hợp Polymarket CLI với các công cụ khác như cron cho các tác vụ theo lịch trình, jq để xử lý dữ liệu hoặc các bot tùy chỉnh được xây dựng bằng Python hoặc Node.js. Khi xây dựng tích hợp giao dịch của bạn, hãy sử dụng Apidog để kiểm tra kỹ lưỡng tất cả các điểm cuối API trước khi triển khai trực tiếp.
Dùng thử Apidog miễn phí để hợp lý hóa quy trình kiểm thử API của bạn và xây dựng niềm tin vào các tích hợp Polymarket của bạn.
Câu hỏi thường gặp
Polymarket CLI có an toàn để sử dụng không?
Polymarket CLI là phần mềm thử nghiệm. Hãy sử dụng cẩn thận và không bao giờ sử dụng với số tiền lớn. Luôn xác minh giao dịch trước khi xác nhận. Dự án là mã nguồn mở, vì vậy bạn có thể tự mình xem xét mã.
Tôi có cần ví để duyệt thị trường không?
Không. Hầu hết các lệnh (thị trường, sự kiện, giá CLOB, sổ lệnh) hoạt động mà không cần ví. Bạn chỉ cần ví để đặt lệnh, kiểm tra số dư và các thao tác trên chuỗi.
Polymarket hỗ trợ những chuỗi nào?
Polymarket được xây dựng trên Polygon (ID chuỗi 137). CLI xử lý cả các hoạt động trên chuỗi (yêu cầu MATIC cho phí gas) và đặt lệnh ngoài chuỗi.
Tôi có thể sử dụng Polymarket CLI để giao dịch tự động không?
Có. Định dạng đầu ra JSON làm cho nó lý tưởng cho việc viết script. Bạn có thể xây dựng các bot giao dịch tự động bằng cách sử dụng script shell, Python hoặc bất kỳ ngôn ngữ nào có thể thực thi các lệnh CLI và phân tích JSON.
Làm cách nào để nhận trợ giúp với Polymarket CLI?
Kiểm tra kho lưu trữ GitHub chính thức để biết tài liệu và theo dõi vấn đề.
Polymarket CLI có hỗ trợ testnet không?
Phiên bản hiện tại hoạt động với việc triển khai Polymarket chính. Để được hỗ trợ testnet, hãy kiểm tra kho lưu trữ GitHub để biết thông tin mới nhất.
Sự khác biệt giữa loại chữ ký proxy và eoa là gì?
proxy (mặc định) sử dụng hệ thống ví proxy của Polymarket, có thể giảm chi phí gas. eoa ký trực tiếp bằng khóa riêng của bạn. Đối với hầu hết người dùng, loại proxy mặc định được khuyến nghị.
Làm cách nào để cập nhật Polymarket CLI lên phiên bản mới nhất?
Chạy polymarket upgrade để kiểm tra và cài đặt các bản cập nhật. Đối với các cài đặt Homebrew, hãy sử dụng brew update && brew upgrade polymarket.
Tôi có thể sử dụng Apidog để kiểm tra các cuộc gọi API Polymarket không?
Có. Apidog là một công cụ tuyệt vời để kiểm tra các API thị trường dự đoán. Tạo một dự án mới trong Apidog, thêm các điểm cuối Polymarket của bạn và sử dụng client trực quan để gửi yêu cầu và kiểm tra phản hồi. Các biến môi trường của Apidog giúp dễ dàng quản lý các thông tin xác thực API khác nhau, và bạn có thể tạo các kịch bản kiểm thử tự động để xác minh logic giao dịch của bạn hoạt động chính xác.