Tahmin piyasaları

GET /predictions
ListPredictionMarkets

Polymarket ve Kalshi sözleşmelerine göz atın. Fiyatlar, her mekânın sonuç olasılıklarıdır; sosyal duyarlılık değildir. Hacim, mekân birimini korur. Eşdeğer sözleşmeler aynı piyasayı paylaşır; ilgili sözleşmeler ayrı kalır. Konu metrikleri, mevcut konu ve varlık uç noktalarını kullanır.

Cüzdanla ödeme https://nebula-api.hiddensystems.ai/api/v1/x402/predictions adresinde kullanılabilir. Nebula hesabı veya API anahtarı gerekmez; imzalamadan önce ödeme teklifini kontrol edin. x402 ödeme kılavuzu.

Parametreler

query string QUERY

Genel tanımlayıcılar ve adlar üzerinde büyük/küçük harfe duyarsız arama.

Example:NVIDIA

provider string QUERY

İsteğe bağlı mekân

İzin verilen değerler
polymarketkalshi

Example:polymarket

status string QUERY

Varsayılan: açık

İzin verilen değerler
openclosedresolveddisputedall

Default:open

subject_id string QUERY

/subjects veya /search tarafından döndürülen kanonik varlık dışı tanımlayıcı, örneğin text:jensen huang veya handle:elonmusk. Her durumda kabul edilir. asset_id veya asset_class ile birleştirilemez.

Example:text:jensen huang

limit integer QUERY

Döndürülen maksimum sonuç sayısı.

Default:25

offset integer QUERY

Sayfalama kayması

Default:0

cURL Örneği

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/predictions' \
  --header 'X-API-Key: YOUR_API_KEY'

Yanıtlar

200 OK
400 Hatalı İstek
401 Yetkisiz
402 Krediler tükendi; yanıt, yenileme zamanlamasını ve satın alınan kredi bakiyesini içerir
403 Yasak
404 Bulunamadı
405 Yönteme izin verilmiyor; Allow başlığı desteklenen yöntemi listeler
429 Çok Fazla İstek
500 Sunucu İçi Hata
503 Hizmet Kullanılamıyor

Medya türü application/json

has_more
boolean zorunlu

Döndürülen kayıtlardan sonra başka bir sayfa mevcut olduğunda true.

limit
integer zorunlu

İstenen maksimum kayıt sayısı.

markets
array<object> zorunlu

Kanonik piyasalar, her mekân içinde en iyi etkinlik sırasına göre sıralanır. Mekân hacimleri toplanmaz.

markets[].id
string zorunlu

Bu nesne türü içinde kararlı kimlik.

markets[].listings
array<object> zorunlu

Kuralları ve fiyat teklifleri ayrı ayrı korunan mekân listeleri.

markets[].listings[].closes_at
string (date-time) zorunlu

Mekân işlem kapanışı UTC cinsinden; olayın gerçekleşmesi veya uzlaşması anlamına gelmez.

markets[].listings[].event_id
string zorunlu

Mekân olay tanımlayıcısı; yoksa boş.

markets[].listings[].id
string zorunlu

Bu nesne türü içinde kararlı kimlik.

markets[].listings[].liquidity_usd
number (double) zorunlu

Mekân tarafından bildirilen likidite, ABD doları cinsinden; kullanılamadığında null.

markets[].listings[].market_id
string zorunlu

Kanonik piyasa kimliği; eşdeğer mekân listeleri bunu paylaşır.

markets[].listings[].observed_at
string (date-time) zorunlu

Nebula'nın bu fiyat teklifini getirdiği UTC zamanı. Karşılaştırmadan önce tazeliği kontrol edin.

markets[].listings[].open_interest
number (double) zorunlu

Mekân açık sözleşmeleri; kullanılamadığında null.

markets[].listings[].opens_at
string (date-time) zorunlu

Mekân açılış saati UTC cinsinden; kullanılamadığında null.

markets[].listings[].outcomes
array<object> zorunlu

Bağımsız fiyat kanıtına sahip, sıralı yerel sonuçlar.

markets[].listings[].provider
string zorunlu

Mekân: polymarket veya kalshi.

markets[].listings[].provider_id
string zorunlu

Yerel mekân piyasa tanımlayıcısı.

markets[].listings[].provider_updated_at
string (date-time) zorunlu

Mekân meta veri güncelleme zamanı; kullanılamadığında null.

markets[].listings[].question
string zorunlu

Orijinal sözleşme sorusu.

markets[].listings[].resolution_source
string zorunlu

Mekân uzlaşma kaynağı; yoksa boş.

markets[].listings[].resolves_at
string (date-time) zorunlu

Mekân beklenen uzlaşma zamanı UTC cinsinden; kullanılamadığında null.

markets[].listings[].result
string zorunlu

Mekân uzlaşma sonucu; bilinen bir sonuçtan önce boş.

markets[].listings[].revision
string zorunlu

Soru, kurallar, kaynak, kapanış ve sonuç yöneliminin SHA-256'sı.

markets[].listings[].rules
string zorunlu

Mekânın tam uzlaşma kuralları.

markets[].listings[].source_url
string zorunlu

Orijinal mekân listeleme URL'si.

markets[].listings[].status
string zorunlu

Listeleme yaşam döngüsü: open, closed, resolved veya disputed. Konular için: resolved veya pending.

markets[].listings[].volume
number (double) zorunlu

volume_unit cinsinden kümülatif mekân hacmi; mevcut değilse null.

markets[].listings[].volume_24h
number (double) zorunlu

volume_unit cinsinden son 24 saatlik mekân hacmi; mevcut değilse null.

markets[].listings[].volume_unit
string zorunlu

Polymarket için usd, Kalshi için contracts. Bu miktarlar toplanamaz.

markets[].question
string zorunlu

Orijinal sözleşme sorusu.

markets[].subjects
array<object> zorunlu

Bağlantılı konular. Mevcut analiz uç noktalarını ayrı ayrı kullanın; piyasa duyarlılığı çıkarımı yapılmaz.

markets[].subjects[].fallback_image_urls
array<string> zorunlu

Sıralı, arka uçta çözümlenmiş yedek simge adayları.

markets[].subjects[].image_url
string zorunlu

Arka uçta çözümlenen ilk konu simgesi adayı; boşsa yedekler kullanılır.

markets[].subjects[].name
string zorunlu

Kanonik konu görünen adı.

markets[].subjects[].role
string zorunlu

Soru eki rolü: entity, topic veya place.

markets[].subjects[].status
string zorunlu

Listeleme yaşam döngüsü: open, closed, resolved veya disputed. Konular için: resolved veya pending.

markets[].subjects[].subject_id
string zorunlu

Kanonik kayıt konu tanımlayıcısı; mevcut varlık veya konu uygunluğunu korur.

markets[].subjects[].types
array<string> zorunlu

Mevcut kimlik çözümleyicisinden kanonik konu türleri.

offset
integer zorunlu

Atlanan eşleşen kayıt sayısı.

{
  "has_more": false,
  "limit": 50,
  "markets": [
    {
      "id": "polymarket:123",
      "listings": [
        {
          "closes_at": "2026-10-07T20:00:00Z",
          "event_id": "event-123",
          "id": "polymarket:123",
          "liquidity_usd": 5000,
          "market_id": "polymarket:123",
          "observed_at": "2026-10-06T12:00:00Z",
          "open_interest": 100,
          "opens_at": "2026-10-01T00:00:00Z",
          "outcomes": [],
          "provider": "polymarket",
          "provider_id": "123",
          "provider_updated_at": "2026-10-06T12:00:00Z",
          "question": "Will NVIDIA close above $200 on October 7?",
          "resolution_source": "Official exchange close",
          "resolves_at": "2026-10-08T00:00:00Z",
          "result": "yes",
          "revision": "revision-hash",
          "rules": "Resolves Yes if the official closing price exceeds $200.",
          "source_url": "https://polymarket.com/event/example",
          "status": "open",
          "volume": 10000,
          "volume_24h": 1000,
          "volume_unit": "usd"
        }
      ],
      "question": "Will NVIDIA close above $200 on October 7?",
      "subjects": [
        {
          "fallback_image_urls": [],
          "image_url": "https://example.com/nvda.png",
          "name": "NVIDIA",
          "role": "entity",
          "status": "open",
          "subject_id": "eq:NVDA",
          "types": []
        }
      ]
    }
  ],
  "offset": 0
}