予測市場

GET /predictions
ListPredictionMarkets

Polymarket と Kalshi の契約を閲覧します。価格は各ベニューの結果確率であり、ソーシャルセンチメントではありません。出来高はベニューの単位を維持します。同等の契約は同じマーケットを共有し、関連する契約は別々に保持されます。サブジェクトのメトリクスは既存のサブジェクトおよびアセットのエンドポイントを使用します。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/predictions で利用できます。Nebula アカウントや API キーは不要です。署名する前に支払いオファーを確認してください。x402 支払いガイド。

パラメータ

query string QUERY

公開識別子と名前を対象とした大文字小文字を区別しない検索。

Example:NVIDIA

provider string QUERY

ベニュー(任意)

指定可能な値
polymarketkalshi

Example:polymarket

status string QUERY

デフォルトは open

指定可能な値
openclosedresolveddisputedall

Default:open

subject_id string QUERY

/subjects または /search が返す正規の非資産識別子(例: text:jensen huang、handle:elonmusk)。大文字と小文字は区別されません。asset_id または asset_class と組み合わせることはできません。

Example:text:jensen huang

limit integer QUERY

返される結果の最大数。

Default:25

offset integer QUERY

ページネーションのオフセット

Default:0

cURL の例

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

レスポンス

200 OK
400 不正なリクエスト
401 未認証
402 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます
403 アクセス拒否
404 見つかりません
405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。
429 リクエストが多すぎます
500 内部サーバーエラー
503 サービス利用不可

メディアタイプ application/json

has_more
boolean 必須

返されたレコードの後に別のページが利用可能な場合は true。

limit
integer 必須

要求された最大レコード数。

markets
array<object> 必須

各ベニュー内の最良アクティビティランク順に並んだ正規マーケット。ベニューの出来高は合算されません。

markets[].id
string 必須

このオブジェクトタイプ内での安定した識別子。

markets[].listings
array<object> 必須

ルールとクォートを個別に保持したベニュー別リスト。

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

ベニューの取引終了時刻(UTC)。イベントの発生時刻や決済時刻とは限りません。

markets[].listings[].event_id
string 必須

ベニューのイベント識別子。存在しない場合は空。

markets[].listings[].id
string 必須

このオブジェクトタイプ内での安定した識別子。

markets[].listings[].liquidity_usd
number (double) 必須

ベニューが報告する流動性(米ドル)。利用できない場合は null。

markets[].listings[].market_id
string 必須

正規マーケットの識別子。同等のベニューリストはこれを共有します。

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

Nebula がこのクォートを取得した UTC 時刻。比較前に鮮度を確認してください。

markets[].listings[].open_interest
number (double) 必須

ベニューの未決済建玉。利用できない場合は null。

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

ベニューの取引開始時刻(UTC)。利用できない場合は null。

markets[].listings[].outcomes
array<object> 必須

独立した価格エビデンスを持つ、順序付けられたネイティブ結果。

markets[].listings[].provider
string 必須

ベニュー: polymarket または kalshi。

markets[].listings[].provider_id
string 必須

ネイティブのベニュー市場識別子。

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

ベニューのメタデータ更新時刻。利用できない場合は null。

markets[].listings[].question
string 必須

元の契約質問。

markets[].listings[].resolution_source
string 必須

ベニューの決済ソース。存在しない場合は空。

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

ベニューの予定決済時刻(UTC)。利用できない場合は null。

markets[].listings[].result
string 必須

ベニューの決済結果。既知の結果が出るまでは空。

markets[].listings[].revision
string 必須

質問、ルール、ソース、クローズ、結果の方向性の SHA-256。

markets[].listings[].rules
string 必須

ベニューの完全な決済ルール。

markets[].listings[].source_url
string 必須

元のベニュー決済ルール。

markets[].listings[].status
string 必須

上場ライフサイクル: open、closed、resolved、disputed。サブジェクトの場合は resolved または pending。

markets[].listings[].volume
number (double) 必須

volume_unit で表した会場の累計出来高。利用できない場合は null。

markets[].listings[].volume_24h
number (double) 必須

volume_unit で表した直近24時間の会場出来高。利用できない場合は null。

markets[].listings[].volume_unit
string 必須

Polymarket では usd、Kalshi では contracts。これらの数量は加算できません。

markets[].question
string 必須

元の契約質問。

markets[].subjects
array<object> 必須

リンクされたサブジェクト。既存のアナリティクスエンドポイントを個別に使用してください。市場センチメントは推測されません。

markets[].subjects[].fallback_image_urls
array<string> 必須

バックエンドで解決されたフォールバックアイコン候補を順に並べたもの。

markets[].subjects[].image_url
string 必須

バックエンドで解決された最初のサブジェクトアイコン候補。空の場合はフォールバックを使用します。

markets[].subjects[].name
string 必須

サブジェクトの正規表示名。

markets[].subjects[].role
string 必須

質問の添付ロール: entity、topic、place。

markets[].subjects[].status
string 必須

上場ライフサイクル: open、closed、resolved、disputed。サブジェクトの場合は resolved または pending。

markets[].subjects[].subject_id
string 必須

レジストリの正規サブジェクト識別子。既存のアセットまたはトピックの対象資格を保持します。

markets[].subjects[].types
array<string> 必須

既存のアイデンティティリゾルバーによる正規サブジェクトタイプ。

offset
integer 必須

スキップされた一致レコードの数。

{
  "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
}