TL;DR
Polymarket CLI adalah alat baris perintah berbasis Rust yang memungkinkan Anda menjelajahi pasar prediksi, menempatkan pesanan, mengelola posisi, dan berinteraksi dengan kontrak on-chain langsung dari terminal Anda. Instal melalui Homebrew atau skrip shell, jelajahi pasar tanpa dompet, dan berdagang menggunakan output JSON untuk otomatisasi. Membutuhkan kunci pribadi untuk operasi perdagangan. Mendukung format output tabel dan JSON untuk penggunaan yang dapat dibaca manusia dan terprogram.
Pendahuluan
Pasar prediksi telah muncul sebagai alat yang ampuh untuk memproyeksikan peristiwa dunia nyata, dari hasil pemilihan hingga pergerakan harga kripto. Polymarket, dibangun di atas Polygon, menawarkan salah satu pasar prediksi paling likuid dengan volume perdagangan jutaan. Meskipun antarmuka web intuitif, pengembang sering kali menginginkan akses terprogram untuk otomatisasi, pembuatan skrip, dan membangun bot perdagangan kustom.
Di sinilah Polymarket CLI hadir. Alat baris perintah berbasis Rust ini menyediakan akses lengkap ke ekosistem Polymarket dari terminal Anda. Baik Anda ingin menjelajahi pasar, menganalisis buku pesanan, atau mengeksekusi perdagangan secara otomatis, Polymarket CLI menghadirkan antarmuka yang tangguh yang terintegrasi dengan mulus dengan skrip shell dan alur kerja otomatisasi.
Apa itu Polymarket?
Polymarket adalah platform pasar prediksi terdesentralisasi yang dibangun di atas blockchain Polygon. Ini memungkinkan pengguna untuk berdagang pada hasil peristiwa dunia nyata menggunakan stablecoin USDC. Pasar distrukturkan sebagai pertanyaan ya/tidak, dengan harga yang mewakili probabilitas suatu hasil (misalnya, 52¢ berarti probabilitas 52%).
Fitur utama Polymarket meliputi:
- Perdagangan terdesentralisasi: Dibangun di atas Polygon untuk transaksi cepat dan berbiaya rendah
- Pasar waktu nyata: Ribuan pasar meliputi politik, kripto, olahraga, dan lainnya
- Model buku pesanan: Buku pesanan batas pusat (CLOB) untuk penemuan harga
- Token kondisional: Token ERC-1155 yang mewakili saham hasil
- Program hadiah: Pedagang dapat memperoleh hadiah berdasarkan volume perdagangan
Polymarket CLI terhubung ke pasar-pasar ini melalui kombinasi API off-chain (untuk membaca data pasar dan menempatkan pesanan) dan kontrak on-chain (untuk operasi token seperti membagi, menggabungkan, dan menukarkan).
Menginstal Polymarket CLI
Polymarket CLI mendukung beberapa metode instalasi. Pilih salah satu yang sesuai dengan lingkungan Anda.
Opsi 1: Homebrew (macOS / Linux)
Metode instalasi termudah menggunakan Homebrew:
# Tambahkan tap Polymarket
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
# Instal polymarket
brew install polymarket
Opsi 2: Skrip Shell (Linux/macOS)
Untuk instalasi satu baris cepat:
curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
Ini mengunduh biner terbaru dan menginstalnya ke PATH Anda.
Opsi 3: Buat dari Sumber (Semua Platform)
Jika Anda memiliki Rust terinstal, Anda dapat membuat dari sumber:
git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .
Memverifikasi Instalasi
Periksa apakah instalasi berhasil:
polymarket --version
polymarket --help
Anda akan melihat informasi versi dan pesan bantuan dengan perintah yang tersedia.
Mulai Cepat: Jelajahi Pasar Tanpa Dompet
Salah satu fitur terbaik Polymarket CLI adalah Anda tidak memerlukan dompet untuk menjelajahi pasar. Ini membuatnya sempurna untuk penelitian dan pemantauan sebelum menginvestasikan dana.
Jelajahi Pasar Terbaru
# Daftar 5 pasar terbaru
polymarket markets list --limit 5
Output yang diharapkan:
Cari Pasar Tertentu
# Cari pasar terkait Bitcoin
polymarket markets search "bitcoin" --limit 5
Filter berdasarkan Status dan Volume
# Daftar pasar yang ditutup
polymarket markets list --closed true --limit 20
Jelajahi Event
Event mengelompokkan pasar terkait bersama-sama. Misalnya, event "Pemilu 2024" berisi beberapa pasar tentang berbagai aspek pemilu.
# Daftar event terbaru
polymarket events list --limit 10
# Filter event berdasarkan tag
polymarket events list --tag politics --active true
# Dapatkan event tertentu
polymarket events get 500
Pengaturan dan Konfigurasi Dompet
Meskipun menjelajahi tidak memerlukan dompet, perdagangan memerlukannya. Berikut cara menyiapkan dompet Anda.
Membuat Dompet Baru
# Buat dompet baru (menghasilkan kunci acak, menyimpan ke konfigurasi)
polymarket wallet create
Ini menghasilkan kunci pribadi baru dan menyimpannya di file konfigurasi Anda di ~/.config/polymarket/config.json.
Mengimpor Dompet yang Sudah Ada
Jika Anda sudah memiliki dompet dengan dana:
polymarket wallet import 0xYOUR_PRIVATE_KEY_HERE
Lokasi File Konfigurasi
File konfigurasi disimpan di ~/.config/polymarket/config.json dan terlihat seperti:
{
"private_key": "0xabc123...",
"chain_id": 137,
"signature_type": "proxy"
}
Metode Konfigurasi Dompet
Anda dapat menyediakan kunci pribadi Anda dengan tiga cara (diperiksa dalam urutan ini):
- Flag CLI:
--private-key 0xabc... - Variabel lingkungan:
POLYMARKET_PRIVATE_KEY=0xabc... - File konfigurasi:
~/.config/polymarket/config.json
Jenis Tanda Tangan
Polymarket mendukung tiga jenis tanda tangan:
| Tipe | Deskripsi |
|---|---|
proxy (default) | Menggunakan sistem dompet proxy Polymarket |
eoa | Menandatangani langsung dengan kunci Anda |
gnosis-safe | Untuk dompet multisig |
Ganti per perintah dengan --signature-type eoa.
Memeriksa Status Dompet
# Tampilkan info dompet lengkap
polymarket wallet show
# Cetak hanya alamatnya
polymarket wallet address
Persetujuan Kontrak
Sebelum berdagang, Anda perlu menyetujui kontrak Polymarket:
# Periksa persetujuan saat ini (hanya baca)
polymarket approve check
# Setujui semua kontrak (mengirim 6 transaksi on-chain)
polymarket approve set
Catatan: Menyetujui kontrak memerlukan MATIC untuk biaya gas di Polygon.
Menjelajahi Pasar dan Event
Mari kita selami lebih dalam perintah eksplorasi pasar.
Perintah Pasar
# Dapatkan info pasar terperinci
polymarket markets get will-bitcoin-hit-100k
# Dapatkan tag untuk pasar
polymarket markets tags MARKET_ID
# Daftar pasar dengan berbagai filter
polymarket markets list \
--active true \
--order volume_num \
--limit 20 \
--offset 10
Perintah Event
# Daftar event dengan filter
polymarket events list --active true --limit 10
# Dapatkan tag event
polymarket events tags EVENT_ID
# Seri (event berulang seperti pasar mingguan)
polymarket series list --limit 10
polymarket series get SERIES_ID
Perintah Tag
# Daftar semua tag
polymarket tags list
# Dapatkan info tag spesifik
polymarket tags get politics
# Temukan tag terkait
polymarket tags related politics
Perintah CLOB (Buku Pesanan)
Periksa harga dan buku pesanan tanpa dompet:
# Periksa kesehatan API
polymarket clob ok
# Dapatkan harga untuk token
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID
# Dapatkan spread
polymarket clob spread TOKEN_ID
# Dapatkan buku pesanan
polymarket clob book TOKEN_ID
# Harga perdagangan terakhir
polymarket clob last-trade TOKEN_ID
# Riwayat harga
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
Opsi interval: 1m, 1h, 6h, 1d, 1w, max
Berdagang di Polymarket
Sekarang untuk bagian yang menarik—menempatkan perdagangan. Perintah ini memerlukan dompet yang dikonfigurasi.
Menempatkan Pesanan
# Tempatkan pesanan batas (beli 10 saham seharga $0.50)
polymarket clob create-order \
--token TOKEN_ID \
--side buy \
--price 0.50 \
--size 10
# Tempatkan pesanan pasar (beli senilai $5)
polymarket clob market-order \
--token TOKEN_ID \
--side buy \
--amount 5
# Kirim beberapa pesanan sekaligus
polymarket clob post-orders \
--tokens "TOKEN1,TOKEN2" \
--side buy \
--prices "0.40,0.60" \
--sizes "10,10"
Jenis pesanan: GTC (Good Till Cancel - default), FOK (Fill or Kill), GTD (Good Till Date), FAK (Fill and Kill)
Tambahkan --post-only untuk pesanan batas yang hanya menambah likuiditas.
Mengelola Pesanan
# Lihat pesanan Anda
polymarket clob orders
# Dapatkan detail pesanan spesifik
polymarket clob order ORDER_ID
# Batalkan satu pesanan
polymarket clob cancel ORDER_ID
# Batalkan beberapa pesanan
polymarket clob cancel-orders "ORDER1,ORDER2"
# Batalkan semua pesanan untuk pasar
polymarket clob cancel-market --market CONDITION_ID
# Batalkan semua pesanan
polymarket clob cancel-all
Memeriksa Saldo dan Perdagangan
# Periksa saldo USDC
polymarket clob balance --asset-type collateral
# Periksa saldo token kondisional
polymarket clob balance --asset-type conditional --token TOKEN_ID
# Lihat perdagangan Anda
polymarket clob trades
# Perbarui saldo (refresh dari chain)
polymarket clob update-balance --asset-type collateral
Hadiah dan Kunci API
# Periksa hadiah
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards
# Periksa apakah pesanan mencetak hadiah
polymarket clob order-scoring ORDER_ID
# Buat kunci API untuk akses terprogram
polymarket clob create-api-key
# Daftar kunci API Anda
polymarket clob api-keys
Operasi On-Chain
Polymarket CLI juga mendukung interaksi langsung dengan kontrak on-chain.
Operasi CTF (Conditional Token Framework)
# Pisahkan $10 USDC menjadi token YES/NO
polymarket ctf split --condition CONDITION_ID --amount 10
# Gabungkan token kembali ke USDC
polymarket ctf merge --condition CONDITION_ID --amount 10
# Tukarkan token pemenang setelah resolusi
polymarket ctf redeem --condition CONDITION_ID
Catatan: Operasi on-chain memerlukan MATIC untuk gas di Polygon.
Operasi Bridge
Setorkan aset dari chain lain:
# Dapatkan alamat setoran untuk EVM, Solana, Bitcoin
polymarket bridge deposit YOUR_POLYGON_ADDRESS
# Daftar chain dan token yang didukung
polymarket bridge supported-assets
# Periksa status setoran
polymarket bridge status DEPOSIT_ADDRESS
Data Portofolio
# Lihat posisi saat ini
polymarket data positions YOUR_WALLET_ADDRESS
# Lihat posisi yang ditutup
polymarket data closed-positions YOUR_WALLET_ADDRESS
# Total nilai portofolio
polymarket data value YOUR_WALLET_ADDRESS
# Riwayat perdagangan
polymarket data trades YOUR_WALLET_ADDRESS --limit 50
Menggunakan Output JSON untuk Skrip
Salah satu fitur paling ampuh Polymarket CLI adalah output JSON, menjadikannya sempurna untuk scripting dan otomatisasi.
Output JSON Dasar
# Dapatkan pasar sebagai JSON
polymarket -o json markets list --limit 10
Output:
[
{"id": "12345", "question": "Will BTC hit $100k?", "outcomePrices": ["0.67", "0.33"], ...},
{"id": "67890", "question": "Will ETH flip BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]
Menggunakan dengan jq
# Ekstrak hanya pertanyaannya
polymarket -o json markets list --limit 100 | jq '.[].question'
# Dapatkan data harga spesifik
polymarket -o json clob midpoint TOKEN_ID | jq '.mid'
# Filter pasar berdasarkan volume
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'
Penanganan Kesalahan dalam Skrip
#!/bin/bash
# Contoh: Periksa saldo dengan penanganan kesalahan
if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
echo "Gagal mengambil saldo"
exit 1
fi
balance=$(echo "$result" | jq -r '.balance')
echo "Saldo Anda: $balance USDC"
Mengotomatiskan Pemantauan Pasar
Buat pemantau pasar sederhana:
#!/bin/bash
# monitor-market.sh - Memantau harga pasar tertentu
TOKEN_ID=$1
INTERVAL=${2:-60} # Default 60 detik
while true; do
clear
echo "Memantau pasar: $(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
Jalankan dengan: ./monitor-market.sh TOKEN_ID 30
Menguji API Polymarket dengan Apidog
Saat membangun sistem perdagangan otomatis atau mengintegrasikan Polymarket ke dalam aplikasi Anda, pengujian API yang menyeluruh sangat penting. Apidog menyediakan platform pengembangan API yang kuat dan terpadu yang membuat pengujian API pasar prediksi menjadi mudah dan efisien.
Mengapa Menggunakan Apidog untuk Integrasi Polymarket?
Baik Anda membangun bot perdagangan, dasbor analitik pasar, atau mengintegrasikan data Polymarket ke dalam aplikasi Anda, Apidog menawarkan beberapa keuntungan:
- Klien API Visual: Kirim permintaan dan periksa respons tanpa menulis kode
- Pengujian Otomatis: Buat suite pengujian untuk memverifikasi logika perdagangan Anda
- Variabel Lingkungan: Kelola endpoint dan kredensial API di seluruh dev/staging/prod
- Kolaborasi: Bagikan definisi API dengan tim Anda
Mode Shell Interaktif
Untuk eksplorasi interaktif, gunakan shell bawaan:
polymarket shell
Ini membuka REPL interaktif:
polymarket> markets list --limit 3
polymarket> clob book TOKEN_ID
polymarket> exit
Shell mendukung riwayat perintah, membuatnya mudah untuk bereksperimen dengan perintah yang berbeda.
Alur Kerja Umum
Alur Kerja 1: Riset dan Perdagangan
# Langkah 1: Temukan pasar yang menarik
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k
# Langkah 2: Periksa buku pesanan dan harga
polymarket clob book TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d
# Langkah 3: Periksa saldo Anda
polymarket clob balance --asset-type collateral
# Langkah 4: Tempatkan perdagangan
polymarket clob market-order --token TOKEN_ID --side buy --amount 10
Alur Kerja 2: Manajemen Portofolio
# Lihat semua posisi
polymarket data positions YOUR_ADDRESS
# Periksa total nilai
polymarket data value YOUR_ADDRESS
# Lihat riwayat perdagangan
polymarket data trades YOUR_ADDRESS --limit 50
# Periksa pesanan terbuka
polymarket clob orders
Alur Kerja 3: Bot Perdagangan Terprogram
#!/bin/bash
# Bot sederhana: beli saat harga turun di bawah ambang batas
TOKEN_ID="YOUR_TOKEN_ID"
THRESHOLD=0.45
AMOUNT=10
# Dapatkan harga saat ini
PRICE=$(polymarket -o json clob midpoint $TOKEN_ID | jq -r '.mid')
# Konversi ke desimal
PRICE_DECIMAL=$(echo "scale=2; $PRICE / 100" | bc)
if (( $(echo "$PRICE_DECIMAL < $THRESHOLD" | bc -l) )); then
echo "Harga ($PRICE_DECIMAL) di bawah ambang batas ($THRESHOLD) - membeli"
polymarket clob market-order --token $TOKEN_ID --side buy --amount $AMOUNT
else
echo "Harga ($PRICE_DECIMAL) di atas ambang batas - menahan"
fi
Pertimbangan Keamanan
Saat menggunakan Polymarket CLI, perhatikan praktik terbaik keamanan berikut:
Keamanan Kunci Pribadi
- Jangan pernah menyerahkan kunci pribadi Anda ke kontrol versi
- Gunakan file konfigurasi daripada variabel lingkungan di lingkungan bersama
- Pertimbangkan integrasi dompet perangkat keras untuk dana besar
- Gunakan dompet terpisah untuk perdagangan CLI (bukan dompet utama Anda)
Verifikasi Transaksi
- Selalu verifikasi detail transaksi sebelum mengonfirmasi
- Mulai dengan jumlah kecil untuk menguji pengaturan Anda
- Jaga saldo MATIC Anda cukup untuk biaya gas
Manajemen Kunci API
# Buat kunci API khusus untuk skrip
polymarket clob create-api-key
# Daftar dan kelola kunci
polymarket clob api-keys
# Hapus kunci yang dikompromikan
polymarket clob delete-api-key
Keamanan Jaringan
- Gunakan CLI melalui HTTPS (default)
- Berhati-hatilah saat menggunakan kunci pribadi di lingkungan cloud
- Pertimbangkan untuk menggunakan VPN saat berdagang dari jaringan publik
Kesimpulan
Polymarket CLI adalah alat yang ampuh bagi pengembang yang ingin berinteraksi dengan pasar prediksi secara terprogram. Baik Anda seorang pedagang yang ingin mengotomatiskan strategi, seorang peneliti yang menganalisis data pasar, atau seorang pengembang yang membangun bot perdagangan, CLI menyediakan antarmuka yang tangguh ke ekosistem Polymarket.
Poin-poin penting dari panduan ini:
- Instal melalui Homebrew atau skrip shell untuk pengaturan cepat
- Jelajahi pasar tanpa dompet untuk penelitian
- Konfigurasi dompet Anda dengan benar sebelum berdagang
- Gunakan output JSON untuk scripting dan otomatisasi
- Selalu prioritaskan keamanan saat menangani kunci pribadi
- Mulai dengan perdagangan kecil untuk menguji pengaturan Anda
- Gunakan Apidog untuk menguji dan memvalidasi integrasi API Polymarket Anda
Untuk kasus penggunaan yang lebih canggih, pertimbangkan untuk menggabungkan Polymarket CLI dengan alat lain seperti cron untuk tugas terjadwal, jq untuk pemrosesan data, atau bot kustom yang dibangun di Python atau Node.js. Saat membangun integrasi perdagangan Anda, gunakan Apidog untuk menguji semua endpoint API secara menyeluruh sebelum go live.
Coba Apidog gratis untuk merampingkan alur kerja pengujian API Anda dan membangun kepercayaan pada integrasi Polymarket Anda.
FAQ
Apakah Polymarket CLI aman digunakan?
Polymarket CLI adalah perangkat lunak eksperimental. Gunakan dengan hati-hati dan jangan pernah menggunakan dengan dana besar. Selalu verifikasi transaksi sebelum mengonfirmasi. Proyek ini open source, jadi Anda dapat meninjau kodenya sendiri.
Apakah saya perlu dompet untuk menjelajahi pasar?
Tidak. Sebagian besar perintah (pasar, event, harga CLOB, buku pesanan) berfungsi tanpa dompet. Anda hanya memerlukan dompet untuk menempatkan pesanan, memeriksa saldo, dan operasi on-chain.
Chain apa saja yang didukung Polymarket?
Polymarket dibangun di atas Polygon (chain ID 137). CLI menangani operasi on-chain (membutuhkan MATIC untuk gas) dan penempatan pesanan off-chain.
Dapatkah saya menggunakan Polymarket CLI untuk perdagangan otomatis?
Ya. Format output JSON membuatnya ideal untuk scripting. Anda dapat membangun bot perdagangan otomatis menggunakan skrip shell, Python, atau bahasa apa pun yang dapat mengeksekusi perintah CLI dan mengurai JSON.
Bagaimana cara mendapatkan bantuan dengan Polymarket CLI?
Periksa repositori GitHub resmi untuk dokumentasi dan pelacakan masalah.
Apakah Polymarket CLI mendukung testnet?
Versi saat ini bekerja dengan deployment Polymarket utama. Untuk dukungan testnet, periksa repositori GitHub untuk informasi terbaru.
Apa perbedaan antara jenis tanda tangan proxy dan eoa?
proxy (default) menggunakan sistem dompet proxy Polymarket, yang dapat mengurangi biaya gas. eoa menandatangani langsung dengan kunci pribadi Anda. Untuk sebagian besar pengguna, jenis proxy default direkomendasikan.
Bagaimana cara memperbarui Polymarket CLI ke versi terbaru?
Jalankan polymarket upgrade untuk memeriksa dan menginstal pembaruan. Untuk instalasi Homebrew, gunakan brew update && brew upgrade polymarket.
Dapatkah saya menggunakan Apidog untuk menguji panggilan API Polymarket?
Ya. Apidog adalah alat yang sangat baik untuk menguji API pasar prediksi. Buat proyek baru di Apidog, tambahkan endpoint Polymarket Anda, dan gunakan klien visual untuk mengirim permintaan dan memeriksa respons. Variabel lingkungan Apidog memudahkan pengelolaan kredensial API yang berbeda, dan Anda dapat membuat skenario pengujian otomatis untuk memverifikasi bahwa logika perdagangan Anda berfungsi dengan benar.