Özet
Polymarket CLI, tahmin piyasalarına göz atmanıza, emir vermenize, pozisyonları yönetmenize ve terminalinizden doğrudan zincir üstü sözleşmelerle etkileşim kurmanıza olanak tanıyan Rust tabanlı bir komut satırı aracıdır. Homebrew veya kabuk betiği aracılığıyla kurun, cüzdan olmadan piyasalara göz atın ve otomasyon için JSON çıktısını kullanarak işlem yapın. İşlem operasyonları için bir özel anahtar gerektirir. Hem insan tarafından okunabilir hem de programatik kullanım için tablo ve JSON çıktı formatlarını destekler.
Giriş
Tahmin piyasaları, seçim sonuçlarından kripto fiyat hareketlerine kadar gerçek dünya olaylarını tahmin etmek için güçlü araçlar olarak ortaya çıkmıştır. Polygon üzerinde inşa edilen Polymarket, milyonlarca işlem hacmiyle en likit tahmin piyasalarından birini sunmaktadır. Web arayüzü sezgisel olsa da, geliştiriciler otomasyon, betikleme ve özel işlem botları oluşturmak için genellikle programatik erişim isterler.
İşte bu noktada Polymarket CLI devreye giriyor. Bu Rust tabanlı komut satırı aracı, terminalinizden Polymarket ekosistemine tam erişim sağlar. İster piyasalara göz atmak, ister emir defterlerini analiz etmek veya işlemleri otomatik olarak yürütmek isteyin, Polymarket CLI, kabuk betikleri ve otomasyon iş akışlarıyla sorunsuz bir şekilde entegre olan sağlam bir arayüz sunar.
Polymarket Nedir?
Polymarket, Polygon blok zinciri üzerine inşa edilmiş merkezi olmayan bir tahmin piyasası platformudur. Kullanıcıların USDC stablecoin kullanarak gerçek dünya olaylarının sonuçları üzerine işlem yapmalarına olanak tanır. Piyasalar evet/hayır soruları şeklinde yapılandırılmıştır; fiyatlar bir sonucun olasılığını temsil eder (örn. 52¢, %52 olasılık anlamına gelir).
Polymarket'in temel özellikleri şunlardır:
- Merkezi olmayan ticaret: Hızlı, düşük maliyetli işlemler için Polygon üzerinde inşa edilmiştir
- Gerçek zamanlı piyasalar: Politika, kripto, spor ve daha fazlasını kapsayan binlerce piyasa
- Emir defteri modeli: Fiyat keşfi için merkezi limit emir defteri (CLOB)
- Koşullu tokenlar: Sonuç paylarını temsil eden ERC-1155 tokenları
- Ödül programı: İşlem hacmine göre ödül kazanabilirler
Polymarket CLI, bu piyasalara zincir dışı API'lar (piyasa verilerini okumak ve emir vermek için) ve zincir üstü sözleşmeler (bölme, birleştirme ve geri alma gibi token işlemleri için) kombinasyonu aracılığıyla bağlanır.
Polymarket CLI Kurulumu
Polymarket CLI birden fazla kurulum yöntemini destekler. Ortamınıza uygun olanı seçin.
Seçenek 1: Homebrew (macOS / Linux)
En kolay kurulum yöntemi Homebrew kullanmaktır:
# Polymarket tap'ını ekleyin
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
# polymarket'i kurun
brew install polymarket
Seçenek 2: Kabuk Betiği (Linux/macOS)
Hızlı, tek satırlık bir kurulum için:
curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
Bu, en son ikili dosyayı indirir ve PATH'inize kurar.
Seçenek 3: Kaynaktan Derleme (Tüm Platformlar)
Rust yüklüyse, kaynaktan derleyebilirsiniz:
git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .
Kurulumu Doğrulama
Kurulumun başarılı olduğunu kontrol edin:
polymarket --version
polymarket --help
Sürüm bilgilerini ve mevcut komutlarla birlikte bir yardım mesajı görmelisiniz.
Hızlı Başlangıç: Cüzdan Olmadan Piyasalara Göz Atın
Polymarket CLI'nin en iyi özelliklerinden biri, piyasalara göz atmak için bir cüzdana ihtiyacınız olmamasıdır. Bu, fon taahhüt etmeden önce araştırma ve izleme için mükemmel kılar.
Yakın Zamandaki Piyasalara Göz Atın
# En yeni 5 piyasayı listeleyin
polymarket markets list --limit 5
Beklenen çıktı:
Belirli Piyasalarda Arama Yapın
# Bitcoin ile ilgili piyasalarda arama yapın
polymarket markets search "bitcoin" --limit 5
Durum ve Hacme Göre Filtrele
# Kapalı piyasaları listeleyin
polymarket markets list --closed true --limit 20
Etkinliklere Göz Atın
Etkinlikler ilgili piyasaları bir araya getirir. Örneğin, "2024 Seçimleri" etkinliği, seçimin farklı yönleri hakkında birden fazla piyasa içerir.
# Yakın zamandaki etkinlikleri listeleyin
polymarket events list --limit 10
# Etkinlikleri etikete göre filtrele
polymarket events list --tag politics --active true
# Belirli bir etkinliği al
polymarket events get 500
Cüzdan Kurulumu ve Yapılandırması
Göz atmak cüzdan gerektirmese de, işlem yapmak gerektirir. Cüzdanınızı nasıl kuracağınız aşağıda açıklanmıştır.
Yeni Bir Cüzdan Oluşturma
# Yeni bir cüzdan oluştur (rastgele anahtar oluşturur, yapılandırmaya kaydeder)
polymarket wallet create
Bu, yeni bir özel anahtar oluşturur ve onu ~/.config/polymarket/config.json adresindeki yapılandırma dosyanıza kaydeder.
Mevcut Bir Cüzdanı İçeri Aktarma
Zaten fonları olan bir cüzdanınız varsa:
polymarket wallet import 0xYOUR_PRIVATE_KEY_HERE
Yapılandırma Dosyası Konumu
Yapılandırma dosyası ~/.config/polymarket/config.json adresinde saklanır ve şuna benzer:
{
"private_key": "0xabc123...",
"chain_id": 137,
"signature_type": "proxy"
}
Cüzdan Yapılandırma Yöntemleri
Özel anahtarınızı üç şekilde sağlayabilirsiniz (bu sırayla kontrol edilir):
- CLI bayrağı:
--private-key 0xabc... - Ortam değişkeni:
POLYMARKET_PRIVATE_KEY=0xabc... - Yapılandırma dosyası:
~/.config/polymarket/config.json
İmza Türleri
Polymarket üç imza türünü destekler:
| Tür | Açıklama |
|---|---|
proxy (varsayılan) | Polymarket'in proxy cüzdan sistemini kullanır |
eoa | Anahtarınızla doğrudan imzalar |
gnosis-safe | Çoklu imza cüzdanları için |
Komut başına --signature-type eoa ile geçersiz kılın.
Cüzdan Durumunu Kontrol Etme
# Tam cüzdan bilgisini göster
polymarket wallet show
# Sadece adresi yazdır
polymarket wallet address
Sözleşme Onayları
İşlem yapmadan önce Polymarket sözleşmelerini onaylamanız gerekir:
# Mevcut onayları kontrol et (salt okunur)
polymarket approve check
# Tüm sözleşmeleri onayla (6 zincir üstü işlem gönderir)
polymarket approve set
Not: Sözleşmeleri onaylamak için Polygon üzerinde gas ücretleri için MATIC gereklidir.
Piyasaları ve Etkinlikleri Keşfetme
Piyasa keşfetme komutlarına daha yakından bakalım.
Piyasa Komutları
# Detaylı piyasa bilgisi al
polymarket markets get will-bitcoin-hit-100k
# Bir piyasa için etiketleri al
polymarket markets tags MARKET_ID
# Çeşitli filtrelerle piyasaları listele
polymarket markets list \
--active true \
--order volume_num \
--limit 20 \
--offset 10
Etkinlik Komutları
# Filtrelerle etkinlikleri listele
polymarket events list --active true --limit 10
# Etkinlik etiketlerini al
polymarket events tags EVENT_ID
# Seriler (haftalık piyasalar gibi tekrar eden etkinlikler)
polymarket series list --limit 10
polymarket series get SERIES_ID
Etiket Komutları
# Tüm etiketleri listele
polymarket tags list
# Belirli etiket bilgisini al
polymarket tags get politics
# İlgili etiketleri bul
polymarket tags related politics
CLOB (Emir Defteri) Komutları
Cüzdan olmadan fiyatları ve emir defterlerini kontrol edin:
# API sağlığını kontrol et
polymarket clob ok
# Bir token için fiyat al
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID
# Spread'i al
polymarket clob spread TOKEN_ID
# Emir defterini al
polymarket clob book TOKEN_ID
# Son işlem fiyatı
polymarket clob last-trade TOKEN_ID
# Fiyat geçmişi
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
Aralık seçenekleri: 1m, 1s, 6s, 1g, 1h, maks
Polymarket Üzerinde İşlem Yapma
Şimdi heyecan verici kısım: işlem yapma. Bu komutlar yapılandırılmış bir cüzdan gerektirir.
Emir Verme
# Bir limit emri ver (10 hisseyi 0,50 dolardan satın al)
polymarket clob create-order \
--token TOKEN_ID \
--side buy \
--price 0.50 \
--size 10
# Bir piyasa emri ver (5 dolar değerinde satın al)
polymarket clob market-order \
--token TOKEN_ID \
--side buy \
--amount 5
# Birden fazla emri aynı anda gönder
polymarket clob post-orders \
--tokens "TOKEN1,TOKEN2" \
--side buy \
--prices "0.40,0.60" \
--sizes "10,10"
Emir türleri: GTC (İptal Edilene Kadar Geçerli - varsayılan), FOK (Doldur ya da İptal Et), GTD (Tarihe Kadar Geçerli), FAK (Doldur ve İptal Et)
Yalnızca likidite ekleyen limit emirleri için --post-only ekleyin.
Emirleri Yönetme
# Emirlerinizi görüntüleyin
polymarket clob orders
# Belirli bir emir detaylarını al
polymarket clob order ORDER_ID
# Tek bir emri iptal et
polymarket clob cancel ORDER_ID
# Birden fazla emri iptal et
polymarket clob cancel-orders "ORDER1,ORDER2"
# Bir piyasa için tüm emirleri iptal et
polymarket clob cancel-market --market CONDITION_ID
# Tüm emirleri iptal et
polymarket clob cancel-all
Bakiyeleri ve İşlemleri Kontrol Etme
# USDC bakiyesini kontrol et
polymarket clob balance --asset-type collateral
# Koşullu token bakiyesini kontrol et
polymarket clob balance --asset-type conditional --token TOKEN_ID
# İşlemlerinizi görüntüleyin
polymarket clob trades
# Bakiyeyi güncelle (zincirden yenile)
polymarket clob update-balance --asset-type collateral
Ödüller ve API Anahtarları
# Ödülleri kontrol et
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards
# Emirlerin ödül alıp almadığını kontrol et
polymarket clob order-scoring ORDER_ID
# Programatik erişim için API anahtarı oluştur
polymarket clob create-api-key
# API anahtarlarınızı listeleyin
polymarket clob api-keys
Zincir Üstü İşlemler
Polymarket CLI, zincir üstü sözleşmelerle doğrudan etkileşimi de destekler.
CTF (Koşullu Token Çerçevesi) Operasyonları
# 10$ USDC'yi EVET/HAYIR tokenlarına böl
polymarket ctf split --condition CONDITION_ID --amount 10
# Tokenları tekrar USDC'ye birleştir
polymarket ctf merge --condition CONDITION_ID --amount 10
# Çözümden sonra kazanan tokenları kullan
polymarket ctf redeem --condition CONDITION_ID
Not: Zincir üstü işlemler, Polygon üzerinde gas için MATIC gerektirir.
Köprü İşlemleri
Diğer zincirlerden varlık yatırın:
# EVM, Solana, Bitcoin için yatırma adreslerini al
polymarket bridge deposit YOUR_POLYGON_ADDRESS
# Desteklenen zincirleri ve tokenları listele
polymarket bridge supported-assets
# Yatırma durumunu kontrol et
polymarket bridge status DEPOSIT_ADDRESS
Portföy Verileri
# Mevcut pozisyonları görüntüle
polymarket data positions YOUR_WALLET_ADDRESS
# Kapalı pozisyonları görüntüle
polymarket data closed-positions YOUR_WALLET_ADDRESS
# Toplam portföy değeri
polymarket data value YOUR_WALLET_ADDRESS
# İşlem geçmişi
polymarket data trades YOUR_WALLET_ADDRESS --limit 50
Betikler İçin JSON Çıktısını Kullanma
Polymarket CLI'nin en güçlü özelliklerinden biri, betikleme ve otomasyon için mükemmel kılan JSON çıktısıdır.
Temel JSON Çıktısı
# Piyasa verilerini JSON olarak al
polymarket -o json markets list --limit 10
Çıktı:
[
{"id": "12345", "question": "Will BTC hit $100k?", "outcomePrices": ["0.67", "0.33"], ...},
{"id": "67890", "question": "Will ETH flip BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]
jq ile Kullanma
# Sadece soruları çıkar
polymarket -o json markets list --limit 100 | jq '.[].question'
# Belirli fiyat verilerini al
polymarket -o json clob midpoint TOKEN_ID | jq '.mid'
# Piyasa hacmine göre piyasaları filtrele
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'
Betiklerde Hata Yönetimi
#!/bin/bash
# Örnek: Hata yönetimiyle bakiyeyi kontrol et
if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
echo "Bakiye alınamadı"
exit 1
fi
balance=$(echo "$result" | jq -r '.balance')
echo "Bakiyeniz: $balance USDC"
Piyasa İzlemeyi Otomatikleştirme
Basit bir piyasa izleyici oluşturun:
#!/bin/bash
# monitor-market.sh - Belirli bir piyasanın fiyatını izler
TOKEN_ID=$1
INTERVAL=${2:-60} # Varsayılan 60 saniye
while true; do
clear
echo "Piyasa izleniyor: $(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
Şu şekilde çalıştırın: ./monitor-market.sh TOKEN_ID 30
Polymarket API'sini Apidog ile Test Etme
Otomatik işlem sistemleri oluştururken veya Polymarket'i uygulamalarınıza entegre ederken, kapsamlı API testi çok önemlidir. Apidog, tahmin piyasası API'larını test etmeyi basit ve verimli hale getiren güçlü, hepsi bir arada bir API geliştirme platformu sunar.
Polymarket Entegrasyonu İçin Neden Apidog Kullanılmalı?
İster bir işlem botu, ister bir piyasa analizi kontrol paneli oluşturuyor olun, ister Polymarket verilerini uygulamanıza entegre ediyor olun, Apidog çeşitli avantajlar sunar:
- Görsel API İstemcisi: Kod yazmadan istek gönderin ve yanıtları inceleyin
- Otomatik Test: İşlem mantığınızı doğrulamak için test paketleri oluşturun
- Ortam Değişkenleri: Dev/staging/prod ortamlarında API uç noktalarını ve kimlik bilgilerini yönetin
- İşbirliği: API tanımlarını ekibinizle paylaşın
Etkileşimli Kabuk Modu
Etkileşimli keşif için yerleşik kabuğu kullanın:
polymarket shell
Bu, etkileşimli bir REPL açar:
polymarket> markets list --limit 3
polymarket> clob book TOKEN_ID
polymarket> exit
Kabuk, komut geçmişini destekleyerek farklı komutlarla deneme yapmayı kolaylaştırır.
Yaygın İş Akışları
İş Akışı 1: Araştırma ve Ticaret
# Adım 1: İlginç piyasaları bul
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k
# Adım 2: Emir defterini ve fiyatları kontrol et
polymarket clob book TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d
# Adım 3: Bakiyenizi kontrol edin
polymarket clob balance --asset-type collateral
# Adım 4: Bir işlem yapın
polymarket clob market-order --token TOKEN_ID --side buy --amount 10
İş Akışı 2: Portföy Yönetimi
# Tüm pozisyonları görüntüle
polymarket data positions YOUR_ADDRESS
# Toplam değeri kontrol et
polymarket data value YOUR_ADDRESS
# İşlem geçmişini görüntüle
polymarket data trades YOUR_ADDRESS --limit 50
# Açık emirleri kontrol et
polymarket clob orders
İş Akışı 3: Programatik İşlem Botu
#!/bin/bash
# Basit bot: fiyat eşiğin altına düştüğünde satın al
TOKEN_ID="YOUR_TOKEN_ID"
THRESHOLD=0.45
AMOUNT=10
# Mevcut fiyatı al
PRICE=$(polymarket -o json clob midpoint $TOKEN_ID | jq -r '.mid')
# Ondalık sayıya dönüştür
PRICE_DECIMAL=$(echo "scale=2; $PRICE / 100" | bc)
if (( $(echo "$PRICE_DECIMAL < $THRESHOLD" | bc -l) )); then
echo "Fiyat ($PRICE_DECIMAL) eşiğin ($THRESHOLD) altında - satın alınıyor"
polymarket clob market-order --token $TOKEN_ID --side buy --amount $AMOUNT
else
echo "Fiyat ($PRICE_DECIMAL) eşiğin üzerinde - tutuluyor"
fi
Güvenlik Hususları
Polymarket CLI kullanırken şu güvenlik en iyi uygulamalarını aklınızda bulundurun:
Özel Anahtar Güvenliği
- Özel anahtarınızı asla sürüm kontrolüne kaydetmeyin
- Paylaşılan ortamlarda ortam değişkenleri yerine yapılandırma dosyasını kullanın
- Büyük fonlar için donanım cüzdanı entegrasyonunu düşünün
- CLI ticareti için ayrı bir cüzdan kullanın (ana cüzdanınız değil)
İşlem Doğrulaması
- Onaylamadan önce her zaman işlem detaylarını doğrulayın
- Kurulumunuzu test etmek için küçük miktarlarla başlayın
- Gas ücretleri için MATIC bakiyenizi yeterli tutun
API Anahtarı Yönetimi
# Betikler için özel API anahtarları oluştur
polymarket clob create-api-key
# Anahtarları listele ve yönet
polymarket clob api-keys
# Güvenliği ihlal edilmiş anahtarları sil
polymarket clob delete-api-key
Ağ Güvenliği
- CLI'yi HTTPS üzerinden kullanın (varsayılan)
- Bulut ortamlarında özel anahtarları kullanırken dikkatli olun
- Genel ağlardan işlem yaparken VPN kullanmayı düşünün
Sonuç
Polymarket CLI, tahmin piyasalarıyla programatik olarak etkileşim kurmak isteyen geliştiriciler için güçlü bir araçtır. İster stratejileri otomatikleştirmek isteyen bir trader, ister piyasa verilerini analiz eden bir araştırmacı, ister işlem botları geliştiren bir geliştirici olun, CLI Polymarket ekosistemine sağlam bir arayüz sağlar.
Bu rehberden çıkarılacak temel noktalar:
- Hızlı kurulum için Homebrew veya kabuk betiği aracılığıyla kurun
- Araştırma için cüzdan olmadan piyasalara göz atın
- İşlem yapmadan önce cüzdanınızı doğru şekilde yapılandırın
- Betikleme ve otomasyon için JSON çıktısını kullanın
- Özel anahtarları kullanırken her zaman güvenliğe öncelik verin
- Kurulumunuzu test etmek için küçük işlemlerle başlayın
- Polymarket API entegrasyonlarınızı test etmek ve doğrulamak için Apidog'u kullanın
Daha gelişmiş kullanım durumları için, Polymarket CLI'yi zamanlanmış görevler için cron, veri işleme için jq veya Python veya Node.js'de oluşturulmuş özel botlar gibi diğer araçlarla birleştirmeyi düşünün. İşlem entegrasyonunuzu oluştururken, yayına girmeden önce tüm API uç noktalarını kapsamlı bir şekilde test etmek için Apidog'u kullanın.
API test iş akışınızı kolaylaştırmak ve Polymarket entegrasyonlarınıza güven oluşturmak için Apidog'u ücretsiz deneyin.
Sıkça Sorulan Sorular
Polymarket CLI kullanmak güvenli mi?
Polymarket CLI deneysel bir yazılımdır. Dikkatli kullanın ve asla büyük miktarda fonla kullanmayın. Onaylamadan önce her zaman işlemleri doğrulayın. Proje açık kaynaklıdır, bu nedenle kodu kendiniz inceleyebilirsiniz.
Piyasalara göz atmak için bir cüzdana ihtiyacım var mı?
Hayır. Çoğu komut (piyasalar, etkinlikler, CLOB fiyatları, emir defterleri) cüzdan olmadan çalışır. Yalnızca emir vermek, bakiyeleri kontrol etmek ve zincir üstü işlemler için bir cüzdana ihtiyacınız vardır.
Polymarket hangi zincirleri destekliyor?
Polymarket, Polygon (zincir ID 137) üzerine kuruludur. CLI hem zincir üstü işlemleri (gas için MATIC gerektiren) hem de zincir dışı emir yerleştirmeyi yönetir.
Polymarket CLI'yı otomatik işlem yapmak için kullanabilir miyim?
Evet. JSON çıktı formatı, betikleme için idealdir. Kabuk betikleri, Python veya CLI komutlarını çalıştırabilen ve JSON'ı ayrıştırabilen herhangi bir dili kullanarak otomatik işlem botları oluşturabilirsiniz.
Polymarket CLI ile ilgili nasıl yardım alabilirim?
Dokümantasyon ve sorun takibi için resmi GitHub deposunu kontrol edin.
Polymarket CLI testnet'i destekliyor mu?
Mevcut sürüm ana Polymarket dağıtımıyla çalışır. Testnet desteği için en son bilgiler için GitHub deposunu kontrol edin.
Proxy ve eoa imza türleri arasındaki fark nedir?
proxy (varsayılan), gas maliyetlerini azaltabilen Polymarket'in proxy cüzdan sistemini kullanır. eoa, özel anahtarınızla doğrudan imzalar. Çoğu kullanıcı için varsayılan proxy türü önerilir.
Polymarket CLI'yı en son sürüme nasıl güncellerim?
Güncellemeleri kontrol etmek ve kurmak için polymarket upgrade komutunu çalıştırın. Homebrew kurulumları için brew update && brew upgrade polymarket komutunu kullanın.
Polymarket API çağrılarını test etmek için Apidog'u kullanabilir miyim?
Evet. Apidog, tahmin piyasası API'larını test etmek için mükemmel bir araçtır. Apidog'da yeni bir proje oluşturun, Polymarket uç noktalarınızı ekleyin ve istek göndermek ve yanıtları incelemek için görsel istemciyi kullanın. Apidog'un ortam değişkenleri, farklı API kimlik bilgilerini yönetmeyi kolaylaştırır ve işlem mantığınızın doğru çalıştığını doğrulamak için otomatik test senaryoları oluşturabilirsiniz.