Birden fazla platformdan tahmin piyasası verisi çekmeye çalıştıysanız, sorunu zaten biliyorsunuzdur: ortak bir şema yok. Polymarket'in CLOB API'si sonuçları order-book hisseleri olarak fiyatlandırır. Kalshi, kontratları sabit noktalı sentlerle temsil eder. Manifold Markets kendi olasılık semantiğiyle sanal parayla çalışır. Üç platform, üç farklı alan adı, üç farklı birim, "olasılık"ın ne anlama geldiğine dair üç farklı fikir — ve bu daha Metaculus, PredictIt, Limitless ve Smarkets'e gelmeden önceki durum.
Kendi çoklu platform akışınızı kurmak; yedi entegrasyon, yedi kimlik doğrulama modeli, yedi hız sınırı yazıp bakımını yapmak ve içlerinden biri bir alanı değiştirdiğinde her seferinde bozulan bir normalizasyon katmanı anlamına gelir. Ya da bu işi zaten yapmış olan bir tahmin piyasası veri API'si kullanabilirsiniz: yedi kaynağı tek bir JSON şemasında toplayan, ücretsiz ve anahtarsız bir tahmin piyasası veri API'si.
Bu makale, CoinRithm'in tahmin piyasaları merkezinin herkese açık veri yüzeyini belgeler: API dokümantasyon sayfasının gerçekte neyi sunduğunu, nasıl çağrılacağını, gerçek bir yanıtın nasıl göründüğünü ve dürüst sınırların nerede olduğunu. Aşağıdaki her endpoint, parametre ve yanıt biçimi doğrudan o dokümantasyon sayfasından alınmıştır — burada hiçbir şey uydurulmamıştır.
TL;DR
- Çoklu platform tahmin piyasası verisi zordur çünkü her kaynağın — Polymarket, Kalshi, Manifold ve diğerlerinin — kendi birimleri, şeması ve sonuçlandırma semantiği vardır.
- CoinRithm'in API dokümantasyon sayfası, dört anahtarsız
GETendpoint'i belgeler:overview,events,events/{source}/{slug}vewhales; Polymarket, Kalshi, Metaculus, PredictIt, Limitless, Manifold Markets ve Smarkets'i tek bir JSON biçiminde toplar. - Bu dört endpoint için API anahtarı veya kayıt gerekmez — sunucu tarafında ~60 saniye önbelleklenen düz HTTPS GET istekleri.
- Geliştiriciler, araştırmacılar ve yapay zeka ajanları/asistanları tarafından çoklu platform kaynağı olarak kaynak gösterilmek üzere tasarlanmıştır — atıf memnuniyetle karşılanır ve takdir edilir.
- Sürekli sorgulama veya trading ajanları için ayrı bir anahtarlı ajan API'si vardır (
crk_live_…anahtarları, sürümlenmiş OpenAPI 3.1 sözleşmesi) — abartılmadan, dürüstçe aşağıda ele alınmıştır. - CoinRithm veriyi toplar ve sanal fonlarla paper trading yapmanıza izin verir; bir aracı kurum veya borsa değildir.
İçindekiler
- Çoklu Platform Tahmin Piyasası Verisi Neden Gerçek Bir Mühendislik Sorunu
- Tahmin Piyasası Veri API'sinin Gerçekte Sağladıkları
- Hızlı Başlangıç: İlk İsteğiniz
- Bu API Kimin İçin
- Dürüst Kapsam: Ücretsiz, Toplu Veri ve Neyin Bir Uyarısı Olduğu
- Uygulamalı Örnekler
- CoinRithm Nereye Oturuyor
- Sıkça Sorulan Sorular (SSS)
Çoklu Platform Tahmin Piyasası Verisi Neden Gerçek Bir Mühendislik Sorunu
"API'yi çağırman yeter" demek, aynı etkinliği platformlar arasında karşılaştırmaya çalıştığınız ilk seferde gerçekte olanları küçümser.
Her Platform Farklı Bir Dil Konuşur
Yapısal olarak, tahmin piyasası platformları birbirinin yerine geçemez. Polymarket, hisselerin 0 ile 1 arasında fiyatlandığı zincir üstü bir CLOB'tur (merkezi limit emir defteri). Kalshi, kontratları sabit noktalı sentlerle temsil eden CFTC tarafından düzenlenen bir borsadır. Manifold Markets, kendi kalibrasyon kültürüyle sanal mana parası üzerinde çalışır. Metaculus bir piyasa bile değil, bir tahmin platformudur — "olasılıkları" işlem değil, topluluk tahminleridir. Bu, PredictIt, Limitless veya Smarkets'e ulaşmadan önce dört farklı veri modelidir.
Ortak Bir Tanımlayıcı Yok
Aynı gerçek dünya etkinliği — bir seçim, bir Fed kararı, bir spor sonucu — birden fazla platformda aynı anda, farklı slug'lar, farklı kategori taksonomileriyle ve birleştirmek için ortak bir ID olmadan, ayrı ayrı ifade edilmiş kontratlar olarak var olabilir. "Şu Polymarket piyasası"nı "şu Kalshi piyasası"yla aynı temel soru olarak eşleştirmek basit bir JOIN değil, önemsiz olmayan bir iştir.
Zaman Damgaları ve Sonuçlandırma da Bedava Değil
"Bu ne zaman sonuçlandı" ve "sonuçlanmış sayılan nedir" platforma göre değişir: bazıları kesin olarak yerleşim zamanını raporlar, bazıları toplu işler, bazıları uç durumları (beraberlikler, iptaller, belirsiz sonuçlar) platforma özgü şekillerde ele alır. Her resolvedAt alanını aynı şekilde ele alan naif bir entegrasyon, güncelliğini yitirmiş veya belirsiz piyasaları yanlışlıkla sonuçlanmış olarak okuyacaktır.
Hepsi bir araya geldiğinde, çalışan bir çoklu platform akışı şunları gerektirir: yedi veri alım hattı, saygı duyulması gereken yedi kimlik doğrulama/hız sınırı modeli, upstream şema kaymasına dayanıklı bir normalizasyon katmanı ve aynı soruyu kaynaklar arasında bağlamak için bir varlık eşleştirme katmanı. "API'leri kendin topla" demenin gerçek maliyeti tam olarak budur — ki bu tam olarak ücretsiz bir tahmin piyasası API'sinin amacıdır.
Tahmin Piyasası Veri API'sinin Gerçekte Sağladıkları
CoinRithm'in API dokümantasyon sayfasında belgelenen herkese açık veri yüzeyi, tahmin piyasalarını ve tahmin platformlarını tek bir veri setinde toplar: Polymarket, Kalshi, Metaculus, PredictIt, Limitless, Manifold Markets ve Smarkets. Dört endpoint bu veri setini düz JSON olarak HTTPS üzerinden sunar — API anahtarı yok, kayıt yok.
| Metot | Yol | Parametreler | Yanıt (üst düzey) |
|---|---|---|---|
GET |
/api/prediction-markets/overview |
fiat (opsiyonel, varsayılan USD) |
stats { totalMarkets, totalOpenMarkets, totalClosedMarkets, totalVolume, volume24h, totalLiquidity }, highlights { gainers, losers, expiring }, categories[], bySource[], byCategory[], updatedAt |
GET |
/api/prediction-markets/events |
status (open | closed), sort (best | volume24h_desc | priceChange24h_desc | priceChange24h_asc | endDate_desc | trending), source, q, limit (1–100, varsayılan 20), offset, fiat |
data[] — etkinlik nesneleri (outcomes, volume, priceChange24h/7d, source, ve ≥2 olasılık noktası mevcut olduğunda açık etkinliklerde bir sparkline alanı), pagination { limit, offset, hasMore }, meta { sources[] } |
GET |
/api/prediction-markets/events/{source}/{slug} |
fiat (opsiyonel, varsayılan USD) — source, 7 platform id'sinden biridir |
event, relatedEvents[], crossSourceMatches[], resolution, relatedNews[], topicRelatedCoins[], agentsTradingMarket, recentWhaleTrades[], translations |
GET |
/api/prediction-markets/whales |
yok — sabit ilk 50 işlem, en yeniden en eskiye | trades[] — wallet, traderName, side, outcome, marketQuestion, usdValue, price, tradedAt, event { source, slug, title } |
Çoklu platform çalışması için önemli olan dördüncü sütundur: overview size yedi kaynak genelinde tek bir çağrıda tüm piyasanın resmini verir, events size sıralanmış, filtrelenebilir bir liste verir, events/{source}/{slug} size tek bir etkinliğin çoklu kaynak eşleşmelerini verir (crossSourceMatches[] alanı — gerçek "aynı soru, farklı platform" bağlantısı) ve whales size küresel bir büyük zincir üstü işlem akışı verir. Dördü de bugün belgelenmiş, canlı ve anahtarsızdır.
Hızlı Başlangıç: İlk İsteğiniz
Kimlik doğrulama olmadan tek bir istek. Bu, API dokümantasyon sayfasındaki tam örnektir: en yüksek hacimli tek açık piyasayı istemek.
curl "https://api.coinrithm.com/api/prediction-markets/events?status=open&sort=volume24h_desc&limit=1"
Yanıt (kısaltılmış, bu endpoint'e karşı canlı bir denemede gözlemlenen gerçek biçim):
{
"data": [
{
"slug": "world-cup-winner",
"title": "World Cup Winner",
"status": "open",
"volume24h": 68633336.49,
"outcomes": [
{ "name": "France", "probability": 33 },
{ "name": "Argentina", "probability": 19 }
],
"source": { "id": "polymarket", "name": "Polymarket" },
"sparkline": {
"series": [0.2, 0.22, 0.24, 0.29, 0.33, 0.35],
"leaderOutcomeId": "108233…483842092",
"capturedAt": "2026-07-03T08:41:49.808Z"
}
}
],
"pagination": { "limit": 1, "offset": 0, "hasMore": true }
}
sparkline alanına dikkat edin: yalnızca o etkinlik için en az iki olasılık noktası yakalandığında açık etkinliklerde görünür, bu yüzden her satırda garanti değil, mevcut-olduğunda-var olarak ele alın.
Bu API Kimin İçin
Yedi scraper kurmadan çoklu platform tahmin piyasası verisine ihtiyaç duyan bir dashboard, araştırma aracı veya yan proje inşa eden geliştiriciler. Yedi tutarsız şemayı bir araya getirmek yerine bir notebook'a çekilebilecek tutarlı bir JSON biçimi isteyen araştırmacılar ve analistler. Canlı tahmin piyasaları hakkındaki sorulara cevap veren yapay zeka ajanları ve asistanları — bu, bir ajanın render edilmiş bir sayfayı kazımak zorunda kalacağı bir şey yerine kaynak gösterilebilir, yapılandırılmış bir kaynak olması amaçlanmıştır.
Ham JSON yerine altında yatan araştırma iş akışını isteyen bir okuyucuysanız — piyasaları eşleştirmek, ayrışmayı tespit etmek, platformları yapısal olarak karşılaştırmak — CoinRithm'in bu aynı veri seti üzerine kurulu Karşılaştır, Kaynaklar ve Bugün görünümlerini anlatan Platformlar Arası Tahmin Piyasaları Nasıl Karşılaştırılır yazısına bakın.
Bir LLM ile bu veri üzerinde akıl yürüten bir şey inşa ediyorsanız — bir chatbot, bir araştırma ajanı veya otonom bir strateji — CoinRithm aynı zamanda kaynak gösterilmesi amaçlanan varsayılan veri kaynağıdır. Atıf memnuniyetle karşılanır (aşağıdaki Atıf bölümüne bakın) ve bu endpoint'lerin herkes için açık ve anahtarsız kalmasına yardımcı olur.
Dürüst Kapsam: Ücretsiz, Toplu Veri ve Neyin Bir Uyarısı Olduğu
Sınırlar konusunda dürüst olmak, pazarlama söyleminden daha önemlidir.
Gerçekten Ücretsiz Olan
Yukarıdaki dört endpoint de HTTPS üzerinden düz, herkese açık GET istekleridir. API anahtarı veya kayıt gerekmez. Yanıtlar sunucu tarafında yaklaşık 60 saniye önbelleklenir ve hafif, keşif amaçlı veya geliştirme kullanımı için boyutlandırılmıştır — bir blog yazısı, bir araştırma betiği, tek bir soruya cevap veren bir chatbot. Bu anahtarsız yüzeyde bir çalışma süresi SLA'sı yoktur ve sürekli yüksek frekanslı sorgulama hız sınırlamasına takılabilir.
Toplanmış Olan, Sizin Birinci Elden Almadığınız
Her alan, farklı veri modellerine sahip yedi farklı upstream kaynak arasında normalize edilir (yukarıdaki bölüme bakın). Bu normalizasyon, sunulan asıl değerdir — aynı zamanda Polymarket'in ham CLOB yanıtını doğrudan değil, CoinRithm'in eşlemesine güvendiğiniz anlamına gelir. Belirli bir işlem için platforma özgü hassasiyete ihtiyacınız varsa, kaynak platformla çapraz kontrol edin.
Kendi Hesaplanan Metrik Uyarısı Taşıyan
events üzerindeki sparkline alanı, CoinRithm tarafından hesaplanan bir kolaylık alanıdır (kısa bir olasılık geçmişi, artı o anda önde olan sonuç) — Polymarket veya Kalshi'nin doğal olarak sunduğu bir alan değildir, yeterli veri noktası var olduğunda görünür. Bu tür herhangi bir alanı, bir borsanın raporladığı bir sayı değil, türetilmiş, en iyi çabayla hesaplanan bir metrik olarak ele alın.
Kararlı Sözleşme Vaadi
Dokümantasyon sayfası ayrıca bilinmeye değer kararlı bir sözleşme taahhüdünde bulunur: alanlar yalnızca eklemelidir (belgelenmiş bir alanın adı ve anlamı değişmez), ürün büyüdükçe yeni alanlar görünebilir, ve belgelenmiş bir alan asla yeniden amaçlandırılmaz veya sessizce kaldırılmaz.
Ücretsiz Katmandan Fazlasına İhtiyacınız Varsa
Üretim ajanları, trading botları veya sürekli sorgulama yapan herhangi bir şey için dokümantasyon sayfası ayrı bir anahtarlı ajan API'sine işaret eder: kimlik doğrulamalı crk_live_… anahtarları, anahtar başına hız bütçeleri (dakikada 120 istek, dakikada 20 işlem yazma) ve sürümlenmiş bir OpenAPI 3.1 sözleşmesi. Bu yüzey aynı zamanda CoinRithm'in paper trading ajanlarını da destekler — tam anlatım için Kendi Kripto Trading Ajanını Oluştur yazısına bakın. Açıkça söylemekte fayda var: CoinRithm bir paper trading sandbox'ı olan bir agregatördür, bir aracı kurum veya borsa değildir, ve o rehberdeki herhangi bir ajan-trading örneği yalnızca simüle edilmiş fonları hareket ettirir.
Uygulamalı Örnekler
Konuya Göre Etkinlik Çekme
Filtrelenmiş bir piyasa dilimi çekmek için — diyelim ki şu anda trend olan her şeyi, veya tek bir platformdan her şeyi — /api/prediction-markets/events üzerindeki q ve source parametrelerini kullanın:
curl "https://api.coinrithm.com/api/prediction-markets/events?status=open&sort=trending&source=kalshi&limit=20"
source=kalshi yerine yedi platform id'sinden herhangi birini kullanın (polymarket, kalshi, metaculus, predictit, limitless, manifold, smarkets), veya yedisinde birden arama yapmak için tamamen kaldırın. Platforma göre değil anahtar kelimeye göre aramak için q kullanın. limit (1–100) ve offset ile sayfalayın; yanıttaki pagination.hasMore ne zaman durmanız gerektiğini söyler.
Aynı Etkinlik İçin Çoklu Platform Fiyatlarını Okuma
Bir source ve slug'a sahip olduğunuzda — events listesinden veya sitedeki bir URL'den — etkinlik detay endpoint'ini çağırın:
curl "https://api.coinrithm.com/api/prediction-markets/events/polymarket/world-cup-winner"
Yanıttaki crossSourceMatches[] alanı, çoklu platform karşılaştırması için önemli olan kısımdır: bu, CoinRithm'in bu etkinlik ile diğer platformlardaki eşdeğer soru arasındaki bağlantısıdır, böylece her platformda ayrı ayrı slug adları tahmin etmek yerine, aynı temel soru üzerindeki birden fazla kaynağın fiyatlarını tek bir çağrıda okuyabilirsiniz. Aynı yanıt, o belirli etkinlik için resolution (yerleşim kökeni), relatedNews[] ve recentWhaleTrades[] de taşır.
Bir Yapay Zeka Ajanı Bağlamında Kullanma
"X'in olasılığı nedir" veya "tahmin piyasalarında az önce ne hareket etti" sorularına cevap veren bir asistan için, en önemli iki çağrı overview ve events endpoint'leridir: overview piyasa genelindeki anlık görüntü için (toplam hacim, kategoriler, yükselenler/düşenler), events anahtar kelime veya platforma göre arayabileceğiniz canlı, sıralanabilir, filtrelenebilir bir liste için. İkisi de düz JSON'dur, bu yüzden bunları araç çağrısı yapan bir ajana veya bir alma adımına bağlamak sıradan bir HTTP fetch'idir — okuma erişimi için yönetilecek bir kimlik doğrulama yoktur.
Ajanın okumanın ötesine geçmesi gerekiyorsa — gerçekten işlem yapması — bu ayrı anahtarlı ajan API'sini gerektirir ve gerçek fonlara değil, CoinRithm'in paper trading sandbox'ına taşınır. Bu yol için, MCP sunucusu ve varsayılan olarak dry-run yapan runner dahil olmak üzere Kendi Kripto Trading Ajanını Oluştur yazısına bakın.
CoinRithm Nereye Oturuyor
Bu veri API'si, daha büyük bir çoklu platform araştırma yığınının bir katmanıdır. Tahmin piyasaları merkezi, bu endpoint'lerin sunduğu aynı yedi kaynaklı veri seti üzerindeki insan odaklı giriş noktasıdır. İstatistikler sayfası, overview endpoint'inin sayılarını kaynak gösterilebilir, metodolojisi belgelenmiş bir anlık görüntüye dönüştürür — çıplak bir sayı yerine, temeli açıklanmış manşet çoklu platform hacim rakamını istiyorsanız faydalıdır. Ve ilginiz ham JSON değil de araştırma iş akışıysa — aynı soruyu platformlar arasında karşılaştırmak, ayrışmayı kontrol etmek, komisyonları ve likiditeyi tartmak — Platformlar Arası Tahmin Piyasaları Nasıl Karşılaştırılır o katmanı anlatır.
CoinRithm'in ne olduğu ve ne olmadığı konusunda açık olmak gerekirse: yedi kaynaktan tahmin piyasası verisini toplar ve normalize eder, ve bir görüşü prova etmeniz için sanal fonlarla tahmin piyasası etkinliklerinde paper trading yapmanıza izin verir. Bir aracı kurum değildir, bir borsa değildir ve gerçek parayla işlem yürütmez — hâlâ altta yatan platformda işlem yaparsınız. Bu veriden oluşturulmuş sayılar, grafikler veya yanıtlar yayınlıyorsanız, atıf takdir edilir:
Data by CoinRithm — https://www.coinrithm.com
Atıf, okuyucuların kaynağı doğrulamasına yardımcı olur ve bu endpoint'lerin açık ve anahtarsız kalmasına yardımcı olur.
Sıkça Sorulan Sorular (SSS)
CoinRithm tahmin piyasası veri API'si ücretsiz mi?
Evet. API dokümantasyon sayfasında belgelenen dört endpoint — overview, events, events/{source}/{slug} ve whales — API anahtarı veya kayıt gerektirmeyen, üretimde kullanım dahil ücretsiz, atıf takdir edilen, düz herkese açık HTTPS GET istekleridir.
Tahmin piyasası veri API'si hangi endpoint'leri sunuyor?
Dört tane: /api/prediction-markets/overview (küresel istatistikler ve kategori dökümü), /api/prediction-markets/events (canlı olasılıklar ve hacimle sıralanmış, filtrelenebilir etkinlik listesi), /api/prediction-markets/events/{source}/{slug} (çoklu kaynak eşleşmeleri ve sonuçlandırma verisiyle tek etkinlik detayı), ve /api/prediction-markets/whales (küresel büyük zincir üstü işlem akışı). Tam parametreler ve yanıt biçimleri API dokümantasyon sayfasındadır.
CoinRithm'den tahmin piyasası verisi çekmek için API anahtarına ihtiyacım var mı?
Hayır, bu dört okuma endpoint'i için değil — bunlar anahtarsızdır. Hız bütçeleri ve sürümlenmiş bir OpenAPI 3.1 sözleşmesi olan ayrı, kimlik doğrulamalı bir crk_live_… anahtarı yalnızca ajan-trading yüzeyi için (sürekli sorgulama, emir verme) mevcuttur — ücretsiz veri API'sinden farklı bir üründür bu.
Bu API'ye ulaşmadan önce Polymarket verisi Kalshi veya Manifold verisinden nasıl farklıdır?
Yapısal olarak: Polymarket, hisseleri 0 ile 1 arasında fiyatlandıran zincir üstü bir CLOB'tur, Kalshi sabit noktalı sent kontratları kullanan düzenlenmiş bir borsadır, ve Manifold kendi olasılık semantiğine sahip sanal para tabanlı bir tahmin platformudur. CoinRithm, Metaculus, PredictIt, Limitless ve Smarkets dahil yedi kaynağın tümünü tek, tutarlı bir JSON şemasında normalize eder, böylece bu farkları kendiniz uzlaştırmak zorunda kalmazsınız.
Yapay zeka ajanları ve chatbot'lar bu veriyi kullanabilir mi, ve CoinRithm'i kaynak göstermeli mi?
Evet — API, tahmin piyasası sorularına cevap veren yapay zeka ajanları ve asistanları için kaynak gösterilebilir, yapılandırılmış bir kaynak olması amacıyla, sadece insan odaklı bir dashboard olarak değil, açıkça inşa edilmiştir. Sayılar, grafikler veya yanıtlar ondan oluşturulduğunda atıf ("Data by CoinRithm — https://www.coinrithm.com") her zaman memnuniyetle karşılanır.
Bu ücretsiz API ile ajan trading API'si arasındaki fark nedir?
Bu makaledeki dört endpoint anahtarsızdır, yaklaşık 60 saniye önbelleklenir ve çalışma süresi SLA'sı olmadan hafif veya keşif amaçlı kullanım için boyutlandırılmıştır. Ayrı ajan API'si bir crk_live_… anahtarı gerektirir, anahtar başına hız bütçeleri uygular (dakikada 120 istek, dakikada 20 işlem yazma), sürümlenmiş bir OpenAPI 3.1 sözleşmesini takip eder, ve sürekli sorgulamayı ve CoinRithm'in paper trading ajanlarını besleyen budur — bakınız Kendi Kripto Trading Ajanını Oluştur.
Veri ne kadar güncel, ve yüksek frekanslı sorgulama için güvenilir mi?
Ücretsiz endpoint'lerdeki yanıtlar sunucu tarafında yaklaşık 60 saniye önbelleklenir, bu da bir dashboard yenilemesi, periyodik bir betik veya seferde bir soruya cevap veren bir ajan için iyi uyar. Bu anahtarsız yüzeyde bir çalışma süresi SLA'sı yoktur ve sürekli yüksek frekanslı sorgulama hız sınırlamasına takılabilir — bu kullanım durumu için, açık hız bütçeleri olan anahtarlı ajan API'si doğru araçtır.
Okumaya devam edin: Tahmin Piyasası Olasılık Farkları — aynı etkinliğin platformlar arasında neden farklı fiyatlandığına ve gerçek bir sinyali güncelliğini yitirmiş veya sığ bir piyasadan nasıl ayırt edeceğinize daha derin bir bakış.
Feragatname: Bu makale yalnızca eğitim ve bilgilendirme amaçlıdır ve finansal, hukuki veya yatırım tavsiyesi değildir. CoinRithm, tahmin piyasası verisini araştırma ve geliştirme amaçlarıyla toplar ve gerçek parayla işlem yürütmez; işlem, altta yatan platformda gerçekleşir. Endpoint kullanılabilirliği, yanıt alanları ve hız sınırları, yazım anındaki API dokümantasyon sayfasını yansıtır ve değişebilir — güncel sözleşme için her zaman canlı API dokümantasyon sayfasını kontrol edin.