すべてのAPI

Polymarket APIのオッズをNarwhalから取得

中央銀行の決定、CPI、雇用、GDP、金属、エネルギーに関するPolymarketとKalshiの確率を、Narwhalの1つのスキーマで読み取れます。Narwhalは読み取り専用です。

稼働中100.00% uptime, last 30日288 ms 標準応答

最初のリクエスト

イベントのオッズを取得する

curl --request GET \
  --url "https://api.narwhalapi.com/v1/predictions/scalar/usa-fed-2026-10" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
2026年10月のFOMC決定のレスポンス例(2つの結果に絞って抜粋)
{
  "event_id": "usa-fed-2026-10",
  "topic_id": "usa-fed",
  "question": "Federal Reserve rate decision, 28 October 2026",
  "status": "trading",
  "closes_at": "2026-10-28T17:59:00Z",
  "resolves_at": "2026-10-28T18:00:00Z",
  "release_id": "ae2a77cc-3b5b-4541-a060-3bc2ea1145d9",
  "resolution": "Change in the Federal Reserve policy rate announced at the meeting, in basis points",
  "resolves_with": "/v1/economics/USA/central-bank/policy-rate",
  "unit": "bps",
  "venues": [
    {
      "venue": "kalshi",
      "weight": "0.3353",
      "volume_24h_usd": "15376.51"
    },
    {
      "venue": "polymarket",
      "weight": "0.6647",
      "volume_24h_usd": "531149.67"
    }
  ],
  "outcomes": [
    {
      "key": "cut_25",
      "label": "Cut of 25 bps",
      "lower": "-37.5",
      "upper": "-12.5",
      "probability": "0.0059",
      "quotes": [
        {
          "venue": "kalshi",
          "probability": "0.0049",
          "market_ids": [
            "KXFEDDECISION-26OCT-C25"
          ]
        },
        {
          "venue": "polymarket",
          "probability": "0.0064",
          "market_ids": [
            "3326851035…5947"
          ]
        }
      ]
    },
    {
      "key": "cut_50_plus",
      "label": "Cut of 50 bps or more",
      "lower": null,
      "upper": "-37.5",
      "probability": "0.0026",
      "quotes": [
        {
          "venue": "kalshi",
          "probability": "0.0050",
          "market_ids": [
            "KXFEDDECISION-26OCT-C26"
          ]
        },
        {
          "venue": "polymarket",
          "probability": "0.0015",
          "market_ids": [
            "1701037799…5586"
          ]
        }
      ]
    }
  ]
}

エンドポイント

GET予測トピックを一覧表示する/v1/predictions/topics

Narwhalが対象とするすべてのトピックを、シェイプ、単位、取引所とあわせて返します。トピックIDを探すときに使います。

パラメータ

  • group任意

    central_banks、us_prices、us_jobs、us_activity、global_activity、global_prices、metals、energy のいずれか。

一覧内の各トピック

  • topic_idフィールド

    トピックID。usa-cpi-yoy など。

  • groupフィールド

    トピックが属するグループ。central_banks や metals など。

  • titleフィールド

    トピック名。

  • shapeフィールド

    オッズの構成。scalar や binary など。

  • unitフィールド

    値の単位。usd_per_barrel など。ない場合は含まれません。

  • venuesフィールド

    クォートを提供している取引所。kalshi、polymarket、または両方。

  • resolution_kindフィールド

    release、price_fix、price_window、occurrence のいずれか。

  • calendarフィールド

    トピックが追う経済指標の発表ファミリー。国とファミリー付き。追うものがない場合は含まれません。

  • next_event_idフィールド

    トピックで最初に open のイベント。ない場合は含まれません。


リファレンス全文 →
GET日付付きのイベントを一覧表示する/v1/predictions/events

トピックをまたぐ日付付きのイベントを、ステータスと時刻とあわせて返します。トピック、シェイプ、ステータス、決着時刻で絞り込めます。

パラメータ

  • topic任意

    このトピックIDのイベントのみ。

  • shape任意

    このシェイプのイベントのみ。

  • status任意

    upcoming、trading、closed、settled、void のいずれか。

  • release_id任意

    この経済指標の発表で決着するイベントのみ。

  • from, to任意

    resolves_at を絞り込むUTCの時刻。from は to より前にしてください。

  • limit任意

    1から100。デフォルトは50です。

  • cursor任意

    前のページの next_cursor を渡すと、次のページを読めます。

一覧内の各イベント

  • event_idフィールド

    イベントID。

  • questionフィールド

    イベントが問う質問。

  • statusフィールド

    upcoming、trading、closed、settled、void のいずれか。

  • closes_at, resolves_atフィールド

    終了時刻と決着時刻(UTC)。

  • topic_id, shapeフィールド

    トピックと、そのオッズのシェイプ。

  • release_idフィールド

    イベントが決着する経済指標の発表。ない場合は含まれません。

  • resultフィールド

    settled と void のイベントについて、結果が確定しているかどうかと、決着した時刻。

  • next_cursorフィールド

    次のページのカーソル。最後のページでは Null です。


リファレンス全文 →
GET各取引所のクォート付きでイベントのオッズを取得する/v1/predictions/{shape}/{event_id}

1つのイベントの最新のオッズ。各取引所のクォートと、ブレンドした確率付き。

パラメータ

  • shape必須

    scalar、extreme、timing、binary のいずれか。

  • event_id必須

    usa-cpi-yoy-2026-09 のようなイベントID。

  • at任意

    過去に記録された分。UTCで指定します。

レスポンスフィールド

  • event_idフィールド

    イベントID。

  • topic_idフィールド

    イベントが属するトピック。

  • questionフィールド

    イベントが問う質問。

  • statusフィールド

    upcoming、trading、closed、settled、void のいずれか。

  • closes_atフィールド

    終了時刻(UTC)。

  • resolves_atフィールド

    決着時刻(UTC)。

  • as_ofフィールド

    取引所を最後に確認した時刻。

  • staleフィールド

    最後の取引所チェックが3分より前だった場合に true。

  • resolutionフィールド

    イベントがどのように決着するかを説明するテキスト。

  • resolves_withフィールド

    公式の値を公開しているNarwhalのエンドポイント。ない場合は含まれません。

  • venuesフィールド

    取引所の市場ごとに1レコード。リンク、ルール、決着ソース、重み、出来高、建玉を含みます。

  • resultフィールド

    各取引所の結果。イベントが決済または無効になった後に返されます。

  • outcomesスカラー

    各結果には key、label、lower、upper、probability、quotes があります。

  • up, down極値

    期間内に各高値または安値の水準に達する確率。

  • stepsタイミング

    各日付または会合までにそれが起きている確率。

  • probability二値

    yes の確率と、その根拠となるクォート。

  • quotesフィールド

    各取引所の確率と、その根拠となる Kalshi のティッカーまたは Polymarket のマーケットID。


リファレンス全文 →
GETイベントの過去のオッズを取得する/v1/predictions/{shape}/{event_id}/history

1つのイベントのオッズの推移を、バーで返します。

パラメータ

  • shape必須

    scalar、extreme、timing、binary のいずれか。

  • event_id必須

    usa-cpi-yoy-2026-09 のようなイベントID。

  • interval任意

    1m、5m、1h(デフォルト)、1d のいずれか。1m と 5m のバーは30日間保持されます。

  • start必須

    開始時刻(UTC)。

  • end必須

    start より後の終了時刻(UTC)。最大で、1m は2日、5m は7日、1h は92日、1d は3,660日です。

  • cursor任意

    前のページの next_cursor を、同じ start、end、interval とともに渡します。

レスポンスフィールド

  • seriesフィールド

    結果ごとに1系列。それぞれ key、active_from、bars を含みます。

  • barsフィールド

    各バーには、バーの開始時刻である timestamp と close があります。ライブのバーには open、high、low も加わります。

  • active_toフィールド

    系列が終了した時点で送信されます。

  • next_cursorフィールド

    次のページのカーソル。最後のページでは Null です。


リファレンス全文 →
WSWebSocketでライブオッズをストリーム/v1/predictions/stream

WebSocketによるリアルタイムのオッズ。Authorizationヘッダーでキーを送り、購読します。接続ごとに1回と数えます。

パラメータ

  • action必須

    subscribe.

  • topics配列

    最大40件のトピックID。

  • event_ids配列

    最大200件のイベントID。

メッセージ

  • snapshotメッセージ

    シェイプを含む、イベントの全体。

  • updateメッセージ

    変更があったときにイベントを再送します。最大で1分に1回です。

  • statusメッセージ

    イベントの新しいステータス。

  • heartbeatメッセージ

    30秒ごとに送信されます。


リファレンス全文 →

ユースケース

連邦準備制度の金利決定の確率

次回以降の各FOMC会合で、利下げ、据え置き、利上げの確率を読み取ります。

ガイドを読む →

Polymarket と Kalshi の比較

1つの質問について両方の取引所を比較し、その差を確認します。

ガイドを読む →

確率としてのオッズ

価格を暗黙の確率に変換し、オーバーラウンドを取り除きます。

ガイドを読む →

オッズが動いたときのアラート

スクリプトをスケジュールで実行し、オッズがしきい値を超えて動いたときにアラートを受け取ります。

ガイドを読む →

ライブ更新

WebSocketを開き、サブスクライブし、再接続を処理します。

ガイドを読む →

カバレッジ

49件のトピックをすべて表示

ソース

関連 API

予測市場API

KalshiとPolymarketの経済およびコモディティの確率を、1つのスキーマで提供します。

APIを見る →

Kalshi・Polymarket APIでオッズを取得

エンドポイント、フィールド、取引所の役割、履歴、WebSocketストリーム。

リファレンスを読む →

よくある質問

これは Polymarket の公式APIですか。

いいえ。NarwhalはPolymarketの公開マーケットデータを読み取り、Kalshiとあわせて独自の形式で返します。取引する場合や、Narwhalが対象としないマーケットを読む場合は、Polymarket自身のAPIを使ってください。

Narwhalで取引を行えますか。

いいえ。Narwhalは読み取り専用です。返すのは確率と、その根拠となる取引所のマーケットであり、注文や板情報ではありません。

Polymarketのオッズはどのくらい新しいですか。

オッズは60秒ごとに読み取られます。すべてのアカウントでリアルタイムのオッズが見られ、ストリームとWebhookも使えます。

なぜPolymarketをNarwhal経由で読むのですか。

PolymarketとKalshiを1つのスキーマで提供。ブレンドした確率、分単位の履歴、各市場が決着する公式発表へのリンク、ウェブフック、MCPツールを備えています。

どのPolymarketのマーケットIDを取得できますか。

各結果に、その根拠となる Polymarket のマーケットを一覧表示します。同じ質問の Kalshi のティッカーとブレンドした確率も並べて表示します。

市場は公式の発表と対応付けられていますか。

各市場は、決着の基準となる公式の発表にリンクしています。

履歴、ストリーム、ウェブフックとして何を利用できますか。

直近30日分の記録済み分足履歴を読み取れます。すべてのアカウントで、リアルタイムのオッズ、WebSocketストリーム、市場の終了または決済時のWebhookも利用できます。

どのPolymarketのマーケットを対象としていますか。

Narwhalは、Coverageに記載した経済およびコモディティのトピックについて、Polymarketのマーケットを使用しています。スポーツ、政治、暗号資産の価格、その他のPolymarketのマーケットは含まれません。