markets

市場オーケストレーション

ESPN のライブスケジュール（NBA、NFL、MLB、NHL、WNBA、CFB、CBB）を Kalshi および Polymarket の予測市場と連携します。クエリを記述する前に、サポートされているスポーツコード、コマンドのパラメーター、価格の正規化形式について、references/api-reference.md を参照してください。

クイックスタート

sports-skills markets get_todays_markets --sport=nba
sports-skills markets search_entity --query="Lakers" --sport=nba
sports-skills markets compare_odds --sport=nba --event_id=401234567
sports-skills markets compare_market_url --url=https://polymarket.com/event/nfl-sf-sea-2026-10-11
sports-skills markets get_sport_markets --sport=nfl
sports-skills markets get_sport_schedule --sport=nba
sports-skills markets normalize_price --price=0.65 --source=polymarket
sports-skills markets evaluate_market --sport=nba --event_id=401234567 --fee_per_contract=<verified fee>
sports-skills markets match_markets --sport=mlb --date=2026-06-06
sports-skills markets get_market_price --venue=kalshi --ticker=KXMENWORLDCUP-26-FR
sports-skills markets get_price_history --venue=kalshi --ticker=KXMENWORLDCUP-26-FR --interval=1d

Python SDK：

from sports_skills import markets

markets.get_todays_markets(sport="nba")
markets.search_entity(query="Lakers", sport="nba")
markets.compare_odds(sport="nba", event_id="401234567")
markets.compare_market_url(url="https://kalshi.com/markets/kxnflgame/sf-vs-sea/kxnflgame-26oct11sfsea")
markets.get_sport_markets(sport="nfl")
markets.get_sport_schedule(sport="nba", date="2025-02-26")
markets.normalize_price(price=0.65, source="polymarket")
markets.evaluate_market(sport="nba", event_id="401234567", fee_per_contract=fee)  # fee: verified (user-stated or documented venue fee)
markets.match_markets(sport="mlb", date="2026-06-06")
markets.get_market_price(venue="kalshi", ticker="KXMENWORLDCUP-26-FR", at_time="2026-05-01T12:00:00+00:00")
markets.get_price_history(venue="polymarket", token_id="<token_id>", interval="1h")

重要：クエリを実行する前に

重要：オーケストレーションコマンドを呼び出す前に、次の点を確認してください。

• スポーツに対応するコマンド（get_todays_markets、compare_odds、get_sport_markets、evaluate_market）には、sport コードが指定されていること。
• 正規化の前に価格ソースが正しく識別されていること：espn = アメリカンオッズ、polymarket／novig／gemini = 0～1 の確率、kalshi = 0～100 の整数。

重要な注意事項

• スポーツのコンテキストは引き継がれます。 --sport=nba は、適切な Polymarket のスポーツコードおよび Kalshi のシリーズティッカーに自動的に対応付けられます。
• コマンドによって対応する取引所が異なります。 get_todays_markets、search_entity、compare_odds は、対応している場合、Kalshi、Polymarket、ProphetX、Novig、Gemini を含みます。Gemini の検索では、スポーツを指定しないか、nba、wnba、nfl、cfb、mlb、nhl、epl、laliga、mls、ligamx、ufc、f1、golf を指定できます。日次ダッシュボードには、対応する ESPN のスコアボードスポーツ（nba、wnba、nfl、cfb、mlb、nhl）の Gemini が含まれます。**他のスポーツについては決済の同等性が確認されるまで、Gemini との比較は NBA のみです。**これらのスポーツでは、sources に Gemini は含まれません。対応していないスポーツの検索では、リクエストを送信せず Gemini をスキップします。normalize_price は gemini（0～1 の確率）を受け付けます。get_sport_markets、match_markets、evaluate_market が使用するのは Kalshi と Polymarket のみです。compare_market_url、get_market_price、get_price_history は Gemini に対応していません。
• スポーツに対応した検索。 Polymarket は sport を series_id に対応付けます。Kalshi は、そのスポーツに対応付けられたすべてのシリーズ（試合の勝者、ハンディキャップ、合計、先物）を検索します。
• 価格は正規化されます。 比較のため、すべての値が含意確率に変換されます。
• 検索結果は検証済みではありません。 生の市場リスト（*_markets、get_sport_markets、search_entity）は検索結果であり、特定の試合の契約と同等であることが確認されたものではありません。同一性が確認されるのは、compare_odds の side_prices（および evaluate_market）のみです。

ワークフロー

本日の NBA ダッシュボード

sports-skills markets get_todays_markets --sport=nba

各試合について、ESPN の情報、DraftKings のオッズ、および一致する Kalshi、Polymarket、ProphetX、Novig、Gemini（gemini_markets）の市場を返します。Gemini のダッシュボード検索は NBA、WNBA、NFL、CFB、MLB、NHL に対応していますが、各検索結果が同一の契約であることは検証しません。

特定の試合でアービトラージを見つける

1. ESPN のイベント ID を取得します：get_sport_schedule --sport=nba
2. オッズを比較します：compare_odds --sport=nba --event_id=<id>
3. アービトラージが検出された場合、レスポンスには配分率と ROI が含まれます。これは参照価格（price_basis: "reference"）に基づいて計算されるため、取引する前に各会場のオーダーブックで両方の賭けを確認してください。
4. sources と completeness には、実際にこの試合の価格を提示した会場が示されます。プロバイダーのエラーは「マーケットなし」ではなく、error として報告されます。
5. 価格を直接比較するには、side_prices.home／side_prices.away を参照してください。それぞれに、この試合の全試合マネーラインとして認められた quotes（venue、implied_probability、price_basis: "reference"、execution_guaranteed: false）と、lowest_reference（そのサイドの価格提示がない場合は null。同率の場合は最初に記載された会場を採用）が含まれます。最安の参照価格は執行可能な価格提示ではなく、手数料調整もされていません。また、賭けの推奨でもありません。比較が完了したと判断する前に、warnings と completeness.complete を確認してください。
6. 検索対象の会場は、Kalshi、Polymarket、ProphetX、Novig です。Novig が対象に含まれるのは、イベントの日付が一致し、全試合の MONEY マーケットに双方向のオーダーブックがある場合のみです。価格は算出されたアスク（1 − 最良の反対サイドのビッド）で、キャッシュされたスナップショットです。カタログにのみ存在するマーケット、スプレッド、期間マーケットは novig_markets に表示されますが、サイドの価格には反映されません。search_entity と get_todays_markets にも、同じ結果を含む novig セクションがあります。
7. Gemini（nba のみ）が対象に含まれるのは、リーグが一致し、startTime が ESPN の開始時刻と一致する、アクティブな全試合マネーライン（moneyline／contest／full_contest）がちょうど 1 つあり、さらにサイドが ESPN のチームと一致する、アクティブでオープンな非コンボのコントラクトがちょうど 2 つあり、両方の買い YES 価格が (0, 1) の範囲内にある場合のみです。その価格は、キャッシュされた公開スナップショットから取得した買い YES 価格です。これは参照価格であり、執行可能な価格提示ではありません。また、出来高は流動性を示すものではありません。子マーケット（スプレッド、合計、プロップ、期間）、コンボ、三者間マーケット、クローズ済み／決済済みのコントラクト、価格の欠落や形式不正、異なる開始時刻、候補の重複は理由とともに sources.gemini.detail で拒否されます。それらも gemini_markets には表示されます。Gemini のエラーは error です。部分スキャン（後続ページの取得失敗、またはスキャンの打ち切り）は sources.gemini.warnings に記載されます。

貼り付けたマーケットリンクを比較する

compare_market_url

1. compare_market_url --url=<link>。対応するリンクは、nfl、nba、mlb、nhl、wnba、cfb、cbb の単一試合を対象とする https://polymarket.com/event/<event-slug>[/<market-slug>] および https://kalshi.com/markets/<series>/<slug>/<event-ticker> です（www. も使用できます）。
2. リンク先は取得されません。ホスト名が完全一致する必要があります。認証情報、ポート、フラグメント、エンコードされたパスセグメントや特殊なパスセグメント、未知のクエリキーは、呼び出し前に拒否されます（utm_* とその他のクリック追跡キーのみ無視されます）。
3. 会場 API は、オープンな全試合の双方向マネーライン（Polymarket）、またはオープンな試合勝者コントラクト 2 つ（Kalshi）を正確に 1 つ解決します。クローズ済み、マネーライン以外、三者間、または曖昧なソースは拒否されます。また、別のスラッグ／ティッカーを示すプロバイダーの応答も拒否されます。
4. ソースの日付の前後 1 日分を対象とする ESPN のスコアボードから、チームと日付が一致する試合が正確に 1 つ見つかる必要があります。ダブルヘッダーと複数の一致は拒否されます。スコアボードの取得失敗は「試合なし」ではなく、失敗として報告されます。
5. compare_odds のペイロード（side_prices、sources、warnings、…）を変更せずに返し、さらに source_market（会場、正規化された url、イベント／マーケット ID、espn_event_id、in_downstream_search）を含めます。比較時の会場検索にソースコントラクトが見つからない場合は警告が表示され、価格は推測されません。
6. これは同じ試合のマネーラインを比較するものです。各会場で同じ条件で決済されることを意味するものではなく、執行も保証されません。現時点では Novig、ProphetX、Gemini のリンクは受け付けていませんが、compare_odds で検索される場合、これらの会場は比較結果に表示されます。

すべての賭けの評価

1. evaluate_market --sport=nba --event_id=<id> --outcome=0 --fee_per_contract=<dollars per $1 contract>
2. 対象の市場が、選択した側のこの試合の全試合勝者市場であることを確認し、注文板から売り気配値を読み取ります。
3. 売り気配値と手数料を betting.evaluate_bet に渡します：確率のデビギング → エッジ → ケリー
4. 公正確率、エッジ、期待値、ケリー比率、推奨を返します。

fee_per_contract が指定されていない場合、売り気配値は報告されますが、手数料なしとは仮定できないため、evaluation は null になります。別のチーム、別の日付、またはデリバティブ（前半戦、ハンディキャップ）の市場を示すティッカーや token_id が渡された場合、代わりの市場は選ばず、処理を拒否します。手数料は CLI（--fee_per_contract=<dollars>）または Python ラッパー経由で渡してください。手数料は明示的に確認された前提である必要があります。ユーザーが明示したもの、または会場が公式に公開している手数料体系を使用し、その場合はどちらかを明記してください。0 を黙って仮定してはいけません。手数料を確認できない場合、evaluation は null のままです。

両方の会場での同一試合

1. match_markets --sport=mlb --date=2026-06-06
2. 各試合の組み合わせでは、同じ試合に対応する Kalshi のイベント（市場ティッカーを含む）と Polymarket のイベント（マネーラインのトークン ID を含む）を対応付けます。日付とチームコードで決定的に照合し、フォールバックとしてあいまいなタイトル照合を行います。
3. kalshi.market_tickers[i] と polymarket.markets[i].token_ids[j] をそのまま get_market_price に渡して、価格を比較します。

時間経過に伴う価格変動

1. get_market_price --venue=kalshi --ticker=<ticker> --at_time=2026-05-01 で、特定時点の価格（両方の yes／no 側、0～1）を取得します。
2. get_price_history --venue=kalshi --ticker=<ticker> --interval=1d で全期間の価格系列を取得します。どちらの会場でも、同じ {timestamp, price} 形式です。

使用例

例 1：本日の試合と予測市場のオッズ ユーザーの発言：「今日のNBAの試合と、予測市場のオッズを教えてください」 操作：

1. get_todays_markets(sport="nba") を呼び出します 結果：各試合のESPN情報とKalshi／Polymarket／ProphetX／Novig／Geminiの市場をまとめたダッシュボードが表示されます

例 2：プラットフォーム横断のチーム検索 ユーザーの発言：「KalshiとPolymarketでLakersの市場を探してください」 操作：

1. search_entity(query="Lakers", sport="nba") を呼び出します 結果：Kalshi、Polymarket、ProphetX、Novig、GeminiでのLakersの検索結果が表示されます（検索結果のみ。同一の契約であることは確認されていません）

例 3：特定の試合のオッズ比較 ユーザーの発言：「このCelticsの試合のオッズをESPNとPolymarketで比較してください」 操作：

1. get_sport_schedule(sport="nba") からevent_idを取得します
2. compare_odds(sport="nba", event_id="<id>") を呼び出します 結果：各サイドのside_prices（採用された参照気配値とlowest_reference）および参照価格に基づく裁定取引の確認結果が表示されます

例 4：市場の完全な評価 ユーザーの発言：「Chiefsの試合に優位性はありますか？」 操作：

1. get_sport_schedule(sport="nfl") からevent_idを取得します
2. 確認済みの手数料（ユーザーが提示したもの、または会場が公開している手数料）を確定してから、evaluate_market(sport="nfl", event_id="<id>", fee_per_contract=<verified fee>) を呼び出します 結果：公正確率、優位性の割合、EV、ケリー比率、賭けの推奨が表示されます。手数料が確認できない場合は、実行可能な売り気配値が報告され、evaluationはnullになります。

例 5：スポーツの全市場を閲覧 ユーザーの発言：「NFLの予測市場をすべて表示してください」 操作：

1. get_sport_markets(sport="nfl") を呼び出します 結果：KalshiとPolymarketのすべてのオープン中のNFL市場が表示されます

例 6：価格の換算 ユーザーの発言：「Polymarketの65セントの価格をアメリカンオッズに換算してください」 操作：

1. normalize_price(price=0.65, source="polymarket") を呼び出します 結果：インプライド確率（0.65）、アメリカンオッズ（-185.7）、小数オッズ（1.54）を含む共通の形式で表示されます

例 7：会場間で試合を対応付ける ユーザーの発言：「Metsの試合をKalshiとPolymarketの両方で探してください」 操作：

1. match_markets(sport="mlb", date="<game date>") を呼び出します 結果：会場間で対応付けられた試合が表示されます。Kalshiの市場ティッカーとPolymarketのマネーラインのトークンIDが並べて表示されます

例 8：過去の価格 ユーザーの発言：「1か月前のフランスのワールドカップ価格はいくらでしたか？」 操作：

1. get_market_price(venue="kalshi", ticker="KXMENWORLDCUP-26-FR", at_time="2026-05-03T12:00:00+00:00") を呼び出します 結果：その時点のYes／No価格（0～1）が表示されます。価格推移全体を確認するにはget_price_historyを使用します

存在しないコマンド — 絶対に呼び出さないでください

• get_odds — 存在しません。ソース間のオッズを確認するにはcompare_oddsを使用してください。
• search_markets — marketsモジュールには存在しません。代わりにsearch_entityを使用してください。
• get_schedule — 存在しません。代わりにget_sport_scheduleを使用してください。

コマンドがreferences/api-reference.mdまたはこのファイルのワークフロー（例：compare_market_url）に記載されていない場合、そのコマンドは存在しません。

トラブルシューティング

エラー：スポーツの市場が返されない 原因：スポーツコードが指定されていないか、正しくない可能性があります 解決方法：有効なスポーツコードはreferences/api-reference.mdで確認してください。正確なコードを使用してください（例：nba、epl、laliga）

エラー：compare_oddsがイベントのデータを返さない 原因：event_idが正しくないか、試合がまだインデックスに登録されていません 解決方法：まずget_sport_schedule(sport=...)を呼び出して、正しいevent_idを取得してください

エラー：応答に1つのソースの警告が表示される 原因：KalshiまたはPolymarketが一時的に利用できません 解決方法：このモジュールは部分的な結果を返します。利用可能なデータを使用してください。利用できないソースについては、kalshiまたはpolymarketのスキルを直接使用して再試行してください

エラー：normalize_priceが予期しないアメリカンオッズ値を返す 原因：sourceパラメーターが正しくありません。Kalshiは0～100の整数、Polymarketは0～1の小数を使用します 解決方法：ソースを確認してください。Kalshiの価格65にはsource="kalshi"、Polymarketの価格0.65にはsource="polymarket"が必要です