Polymarket API’sini veya Polymarket belgelerini aradiysaniz, kisa yanit su: evet, Polymarket’in tam, cogunlukla herkese acik bir gelistirici API’si var ve bu rehber onu haritalandirir, boylece dakikalar icinde piyasa okumaya veya bir sey insa etmeye baslayabilirsiniz. Polymarket uc REST hizmeti ve bir WebSocket akisi sunar ve cogu hicbir anahtar gerektirmez. Asagida her parcanin ne yaptigi, kimlik dogrulamanin nasil calistigi, gercekten kullanacaginiz uc noktalar, resmi SDK’lar ve ne insa edebileceginiz var, kesin parametreler icin resmi referansa baglantilarla birlikte.
Yatirim tavsiyesi degildir. Bu teknik bir rehberdir. Tahmin piyasalarinda islem yapmak gercek para ve gercek kayip riski icerir ve erisim Polymarket’in cografi kisitlamalarina tabidir. Kendi yargi bolgenizdeki yasalara uyun, her seyi resmi belgelere gore dogrulayin ve once risk uyarimizi okuyun.
Temel Cikarimlar
- Polymarket’in uc REST API’si ve bir WebSocket’i var: Gamma (veri), CLOB (islem), Data (analitik).
- Piyasalari, fiyatlari ve liderlik tablolarini okumak Gamma ve Data API’lerinde ucretsiz ve anahtarsizdir.
- Islem CLOB API uzerinden calisir ve klasik bir API anahtariyla degil, Polygon cuzdaninizla imzalanarak kimlik dogrulanir.
- Python (py-clob-client), TypeScript ve Rust icin resmi SDK’lar mevcuttur ve okumalar icin herhangi bir HTTP istemcisi calisir.
- docs.polymarket.com adresindeki resmi referans, kesin uc noktalar ve limitler icin tek dogru kaynaktir.
Harita: uc API ve bir WebSocket
Polymarket API’sini ise gore boler, bu da her parcayi basit tutar. Asagidaki tablo aklinizda tutmaniz gereken zihinsel modeldir.
| Hizmet | Temel URL | Ne ise yarar | Kimlik dogrulama |
|---|---|---|---|
| Gamma API | gamma-api.polymarket.com | Piyasalar, etkinlikler, etiketler, seriler, arama, herkese acik profiller | Public, no key |
| CLOB API | clob.polymarket.com | Emir defterleri, fiyatlar, orta noktalar, spreadler, fiyat gecmisi, emir yerlestirme ve iptal | Herkese acik okumalar, cuzdanla imzalanan islemler |
| Data API | data-api.polymarket.com | Pozisyonlar, islemler, etkinlik, sahipler, acik pozisyon, liderlik tablolari | Public, no key |
| WebSocket | wss://ws-subscriptions-clob.polymarket.com | Canli emir defteri ve fiyat guncellemeleri ve kendi emir durumunuz | Herkese acik market kanali, kimlik dogrulamali user kanali |
Cogu uygulama Gamma ve Data API’sinden okur ve hicbir zaman kimlik dogrulamaya ihtiyac duymaz. CLOB’un kimlik dogrulamali tarafina yalnizca gercekten emir yerlestirmek veya iptal etmek istediginizde uzanirsiniz.
Gamma API: piyasa katalogu
gamma-api.polymarket.com adresindeki Gamma API, neyin var oldugunu buldugunuz yerdir. Surekli kullanacaginiz iki uc nokta markets ve events’tir, burada bir etkinlik bir veya daha fazla ilgili piyasayi gruplar (tek bir soru altinda birden fazla sonuc piyasasi olabilir). Gamma ayrica etiketler, seriler, spor, arama ve herkese acik profiller sunar. Tamamen herkese aciktir, dolayisiyla basit bir GET istegi piyasa meta verisini, guncel fiyatlari ve diger her sey icin ihtiyaciniz olan token ID’lerini dondurur. Bir pano, bir piyasa tarayici veya bir botun kesif katmanini insa ediyorsaniz, buradan baslarsiniz.
CLOB API: emir defteri ve islem
clob.polymarket.com adresindeki CLOB API borsadir. Herkese acik tarafi size herhangi bir piyasa tokeni icin emir defterini, fiyatlari, orta noktalari, spreadleri ve fiyat gecmisini verir. Kimlik dogrulamali tarafi islemin gerceklestigi yerdir: bir token ID, bir fiyat, bir boyut ve bir taraf (al veya sat) ile bir emir olusturur, cuzdaninizla imzalar ve gonderirsiniz, ve emirleri ayni sekilde iptal edebilirsiniz.
Buradaki kimlik dogrulama, geleneksel API’lerden gelen insanlari sasirtan kisimdir. Bir panodan yapistiracaginiz bir anahtar yoktur. Bunun yerine mesajlari Ethereum veya Polygon cuzdaninizla imzalayarak kimlik dogrularsiniz, ki bu bir sunucuya gizli bir bilgi vermeden fonlari kontrol ettiginizi kanitlar. Resmi SDK’lar bu imzalama akisini sizin yerinize halleder, ki bu da islem icin kendi cozumunuzu yazmak yerine onlari kullanmanin ana nedenidir.
Data API: pozisyonlar, islemler ve liderlik tablolari
data-api.polymarket.com adresindeki Data API analitik katmanidir. Kullanici pozisyonlarini, islemleri, etkinligi, sahip verilerini, acik pozisyonu, gelistirici analitigini ve herkese acik liderlik tablolarini sunar. Bu, “kim neyi tutuyor” ve “kim en cok karda” tarzi ozelliklerin arkasindaki API’dir. Tamamen herkese aciktir, ki bu da onu arastirma, kopya analizi panolari ve emir yerlestirmek yerine davranisi inceleyen her sey icin ideal kilar. En iyi yatirimcilarin nasil konumlandigini incelemek istiyorsaniz, bu veri burada bulunur.
WebSocket: canli guncellemeler
REST uc noktalarini bir dongude yoklamak yavas veri icin sorun degildir, ancak canli her sey icin wss://ws-subscriptions-clob.polymarket.com adresindeki WebSocket’i istersiniz. Herkese acik emir defteri ve fiyat guncellemeleri icin market kanalina, veya gercek zamanli kendi emir durumunuz icin kimlik dogrulamali olan user kanalina abone olun. Canli panolar, piyasa yapici botlar ve uyari sistemleri WebSocket’e aittir, cunku degisiklikleri size siz tekrar tekrar sormaya zorlamak yerine iter.
Resmi SDK’lar ve diller
Veri okumak icin bir SDK’ya ihtiyaciniz yoktur, duz bir HTTP istegi herhangi bir dilde calisir, ancak islem icin resmi istemciler gercek emek tasarrufu saglar. Polymarket bir Python istemcisi (py-clob-client) ile TypeScript ve Rust istemcileri tutar, ve topluluk daha fazlasini eklemistir. SDK’lar cuzdan imzalamayi, emir olusturmayi ve elle yapildiginda kolayca yanlis gidebilen kucuk ayrintilari halleder. Yalnizca okuma yapan bir proje icin curl veya fetch yeterlidir; bir islem projesi icin resmi bir SDK’dan baslayin.
Ne insa edebilirsiniz
API birkac net proje acar. Yalnizca okuma yapan bir piyasa panosu veya tarayici Gamma ile Data API’sini ceker ve hicbir kimlik dogrulamaya ihtiyac duymaz. Konumlanmayi ve liderlik tablolarini inceleyen bir arastirma araci tamamen Data API uzerinde yasar. Bir canli oran widget’i veya uyari botu WebSocket’e biner. Ve bir islem botu, ideal olarak uzun bir kagit uzerinde islem asamasindan sonra, emirleri CLOB uzerinden imzalamak ve gondermek icin resmi bir SDK kullanir. Ayni piyasalarin manuel tarafi icin, Polymarket’te nasil islem yapilir ve Polymarket ucretleri rehberlerimiz mekanikleri ele alir, ve UMA oracle’in piyasalari nasil sonuclandirdigi kodunuzun nihayetinde bahse girdigi uzlasmayi aciklar.
Pratik notlar ve tuzaklar
Birkac sey zaman kazandirir. Herkese acik uc noktalari hiz limitli olarak ele alin: yanitlari onbellekleyin, hatalarda geri cekilin ve WebSocket varken siki bir dongude yoklama yapmayin. Token ID’leri, piyasa adlari degil, Gamma, CLOB ve Data API’sini birbirine baglayan anahtarlardir, bu yuzden onlari erkenden alin. Fiyatlar dolar degil, 0 ile 1 arasinda olasiliklardir, dolayisiyla boyut ve risk matematigi buna saygi gostermelidir. Ve islem Polygon uzerinde gercek zincir parasi oldugundan, mumkun olan en kucuk boyutla test edin, kismi dolumlari ve basarisizliklari yonetin ve dogrulamadiginiz bir stratejiyi asla dagitmayin. Kesin uc nokta yollarini, parametreleri ve limitleri her zaman resmi API referansina gore onaylayin, cunku bunlar yetkili ve guncel kaynaktir.
Sonuc
Polymarket API’si itibarinin one surdugunden daha erisilebilir: uc REST hizmeti ve bir WebSocket, veri tarafi tamamen herkese acik ve yalnizca islem cuzdan imzalamanin arkasinda. Gamma ve Data API’si ile okuyun, WebSocket ile canliya gecin ve resmi bir SDK ile CLOB uzerinden islem yapin. Once yalnizca okuma yapani insa edin, dikkatle dogrulayin ve herhangi bir gercek islemden once cografi kisitlamalara ve kendi yerel yasaniza saygi gosterin. Platformun kendisinde yeni misiniz? Polymarket nedir ve izlenecek en iyi piyasalar ile baslayin, sonra insa etmeye geri donun.
Bu makale genel teknik bilgidir, finansal veya yasal tavsiye degildir. Tahmin piyasalarinda islem yapmak gercek kayip riski tasir, API’ler ve uc noktalar degisir ve erisim cografi olarak kisitlidir. Resmi belgelere gore dogrulayin, risk uyarimizi okuyun ve asla kaybetmeyi goze alamayacaginiz parayi riske atmayin.
Sıkça sorulan sorular
Polymarket'in herkese acik bir API'si var mi?
Evet. Polymarket, uc REST hizmetine bolunmus tam bir gelistirici API'si sunar: piyasa ve etkinlik verileri icin Gamma API, emir defteri ve islem icin CLOB API, pozisyonlar, islemler ve liderlik tablolari icin Data API, ayrica canli guncellemeler icin bir WebSocket akisi. Gamma ve Data API'leri tamamen herkese aciktir ve anahtar gerektirmez. Resmi referans docs.polymarket.com adresinde bulunur ve kesin parametreler icin bunu tek dogru kaynak olarak ele almalisiniz.
Polymarket API ucretsiz mi ve API anahtarina ihtiyacim var mi?
Veri okumak ucretsizdir ve cogunlukla anahtarsizdir. Gamma API (gamma-api.polymarket.com) ve Data API (data-api.polymarket.com) tamamen herkese aciktir, dolayisiyla piyasalari, fiyatlari, pozisyonlari ve liderlik tablolarini kimlik dogrulama olmadan cekebilirsiniz. CLOB API (clob.polymarket.com) emir defteri ve fiyat okumalari icin herkese aciktir, ancak emir yerlestirme veya iptal etme kimlik dogrulamasi gerektirir. Klasik bir API anahtari kaydi yoktur; cuzdaninizla imzalayarak kimlik dogrularsiniz.
Gamma, CLOB ve Data API'leri arasindaki fark nedir?
Gamma (gamma-api.polymarket.com) katalogdur: piyasalar, etkinlikler, etiketler, arama ve profiller. CLOB (clob.polymarket.com) borsadir: emir defterleri, fiyatlar, orta noktalar, spreadler, fiyat gecmisi ve emir yerlestirme veya iptal. Data API (data-api.polymarket.com) analitiktir: kullanici pozisyonlari, islemler, etkinlik, sahipler, acik pozisyon ve liderlik tablolari. Cogu uygulama Gamma ve Data'dan okur ve yalnizca islem yapmak icin CLOB'un kimlik dogrulamali tarafina dokunur.
Polymarket API uzerinden islem yapabilir miyim?
Evet, CLOB API'sinin kimlik dogrulamali uc noktalari uzerinden. Bir token ID, fiyat, boyut ve taraf (al veya sat) ile bir emir olusturur, bunu Polygon cuzdaninizla imzalar ve gonderirsiniz. Bu, zincir uzerinde gercek paradir, bu yuzden once cok kucuk boyutla test edin, hatalari ve kismi dolumlari yonetin ve dogrulamadiginiz bir stratejiyi asla calistirmayin. Tahmin piyasalarinda islem yapmak gercek kayip riski tasir. Bu yatirim tavsiyesi degildir.
Polymarket hangi dilleri ve SDK'lari destekler?
Polymarket resmi bir Python istemcisi (py-clob-client) ile TypeScript ve Rust istemcileri tutar, ve topluluk baska dillerde kutuphaneler insa etmistir. Her sey HTTP uzerinden REST ve WebSocket oldugundan, duz curl, Go veya HTTP istemcisi olan herhangi bir dili de kullanabilirsiniz. Ozellikle islem yapmak icin resmi SDK'lar kullanmaya degerdir, cunku cuzdan imzalamayi ve emir bicimlendirmeyi sizin yerinize hallederler.
Canli Polymarket verisi icin bir WebSocket var mi?
Evet. CLOB WebSocket'ine wss://ws-subscriptions-clob.polymarket.com adresinden baglanin ve herkese acik emir defteri ve fiyat guncellemeleri icin market kanalina, veya kendi emir durumunuz icin (kimlik dogrulamali) user kanalina abone olun. WebSocket'ler, canli panolar, islem botlari ve saniyenin altinda guncelleme gerektiren her sey icin dogru aractir, cunku ayni veriyi REST uc noktalarindan yoklamak daha yavas ve daha agirdir.
Hiz limitleri var mi ve API'yi her ulkeden kullanabilir miyim?
Herkese acik uc noktalari hiz limitli olarak ele alin ve agresif sekilde onbellekleyin, hatalarda geri cekilin ve onlari zorlamak yerine guncel limitler icin resmi belgeleri kontrol edin. Erisim ayrica Polymarket'in cografi kisitlamalarina tabidir, ki bunlar belgelenmis ve uygulanmaktadir, dolayisiyla API bolgesel kurallari asmanin bir yolu degildir. Kendi yargi bolgenizdeki yasalara uyun. Bu makale genel bilgidir, yasal veya finansal tavsiye degildir.
#Polymarket#API#CLOB#gelistiriciler#tahmin piyasalari#guide
Tartışma
Yorumlar yükleniyor…