すべてのAPI

Polymarket APIとKalshiのオッズ | Narwhal API

経済発表、中央銀行の決定、金属とエネルギーの価格に関するKalshiとPolymarketのオッズを、履歴付きの1つのスキーマで提供する1つのAPI。RESTエンドポイントとMCPツールは同じ入力を使います。

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

最初のリクエスト

トピックの詳細を取得する

curl --request GET \
  --url "https://api.narwhalapi.com/v1/predictions/topics/usa-cpi-yoy" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例
{
  "topic_id": "usa-cpi-yoy",
  "group": "us_prices",
  "title": "US CPI, 12-month change",
  "shape": "scalar",
  "unit": "percent",
  "venues": [
    "kalshi",
    "polymarket"
  ],
  "resolution_kind": "release",
  "events": [
    {
      "event_id": "usa-cpi-yoy-2026-09",
      "question": "US CPI, 12-month change, September 2026",
      "status": "trading",
      "closes_at": "2026-10-14T12:29:00Z",
      "resolves_at": "2026-10-14T12:30:00Z"
    }
  ]
}

エンドポイント

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/topics/{topic_id}

1つのトピックと、その upcoming と trading のイベント、そして直近のそれ以外の5件。

パラメータ

  • topic_id必須

    usa-cpi-yoy のようなトピックID。

レスポンスフィールド

  • 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フィールド

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

  • eventsフィールド

    各イベントには event_id、question、status、closes_at、resolves_at、release_id、result があります。


リファレンス全文 →
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 です。


リファレンス全文 →
GET中央銀行の政策パスを取得する/v1/predictions/policy-paths/{authority}

次回以降の各会合での、利下げ、据え置き、利上げのオッズと、ベーシスポイントで表した予想変化幅。

パラメータ

  • authority必須

    federal-reserve、european-central-bank、bank-of-england、bank-of-japan、bank-of-canada、reserve-bank-of-australia、bank-indonesia のいずれか。

レスポンスフィールド

  • as_ofフィールド

    オッズを取得した時刻。

  • meetingsフィールド

    今後の会合ごとに1行。event_id と resolves_at を含みます。

  • p_cut, p_hold, p_hikeフィールド

    利下げ、据え置き、利上げの確率。

  • expected_change_bpsフィールド

    その会合における確率加重の変化幅(ベーシスポイント)。

  • cumulative_change_bpsフィールド

    会合をまたいで合算した、予想される変化。


リファレンス全文 →
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を開き、サブスクライブし、再接続を処理します。

ガイドを読む →

カバレッジ

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

ソース

関連 API

経済データAPI

価格、労働、産出、貿易、金利の公式指標。

APIを見る →

経済指標カレンダーAPI

発表スケジュール、ステータス、公開データのバージョン。

APIを見る →

コモディティAPI

元の単位や系列の定義を保持したスポット金属と現物コモディティの価格。

APIを見る →

PolymarketオッズAPI

Narwhalを通じたPolymarketのオッズ。各結果のPolymarketマーケット付き。

このページを見る →

よくある質問

オッズは遅延しますか?

いいえ。すべてのアカウントでリアルタイムのオッズとWebSocketストリームを利用でき、ストリーム接続ごとに1回と数えます。

イベントは何をもって決着しますか。

各イベントには、公式の決着ソースが指定されています。経済イベントには、実際の値を公開しているNarwhalの経済エンドポイントへのリンクも付いています。

どのような履歴を利用できますか。

各イベントの履歴エンドポイントと対応するMCPツールで、1分、5分、1時間、1日間隔のオッズ履歴を取得できます。1分足と5分足の履歴は直近30日間に限られます。

どのトピックを対象としていますか。

米国のCPIとコアCPI、雇用統計、失業率、GDP、景気後退、そして中央銀行の決定、金属、エネルギー。

イベントには何が含まれますか。

質問、終了時刻と決着時刻、公式の決着ソース、そしてステータス(upcoming、trading、closed、settled、void)。

イベントにはどのような形がありますか。

スカラー分布、バイナリのオッズ、極端な高値と安値、タイミングに関する市場、そして中央銀行の政策パス。

トピックは何を対象としていますか。

対象は7つの中央銀行、金、銀、銅の価格水準と週次または月次の高値と安値、そしてWTI、Brent、天然ガスです。オッズは市場価格であり、結果を保証するものではありません。