prophetx

ProphetX — 公開取引所のマーケット（読み取り専用）

クエリを作成する前に、スポーツコードとコマンドのパラメーターについて references/api-reference.md を確認してください。

まずお読みください — このスキルで取得できる情報と取得できない情報：

• ✅ トーナメント（リーグ）、イベント（ホーム／アウェイ、スケジュール、ステータスを含む）、マーケットカタログ（マネーライン／スプレッド／トータル、代替ライン、v2 の選手プロップ）、マッチ済み賭け金（total_stake）、主要ラインフラグ（favourite）。
• ✅ アメリカン方式の取引所オッズと、そこから算出したインプライド確率。ただし、公開注文板が表示されているマーケットに限ります。マーケットごとに selections_available を確認してください。提供状況は異なり、試合前の主要マーケットには通常注文板がありますが、試合中や取引の少ないマーケットでは [null, null] が返されることがよくあります。
• ❌ すべてのマーケットで保証されるオッズや、完全な注文板の厚み／流動性。selections_available が False の場合、存在するのは構造情報とマッチ済み賭け金のみです。オッズを捏造しないでください。オッズを完全に網羅するには、認証が必要な ProphetX Affiliate API を利用します。これは別の認証情報を使用する Machina コネクターです。このスキルにトークンを組み込まないでください。

クイックスタート

Python のインポートパスに関する問題を避けられるため、CLI を推奨します。

sports-skills prophetx get_sports_config
sports-skills prophetx search_markets --sport=nfl --query="Eagles"
sports-skills prophetx get_todays_events --sport=mlb
sports-skills prophetx get_tournaments --sport=soccer
sports-skills prophetx get_markets --event_id=19742 --api_version=v2

Python SDK（代替手段）：

from sports_skills import prophetx

prophetx.get_sports_config()
prophetx.search_markets(sport="nfl", query="Eagles")
prophetx.get_todays_events(sport="mlb")
prophetx.get_events(109)                      # tournament_id
prophetx.get_markets(19742, api_version="v2") # event_id
prophetx.get_market(19742, 219)               # market id or "19742:219"

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

• マーケットの id はマーケットタイプの ID です（219 = 任意のイベントのマネーライン）。イベントごとに安定したキーは market_key（"<event_id>:<market_id>"）です。
• api_version="v2" では、カテゴリ、サブタイプ、代替ライン（market_lines）、選手プロップが追加されます。デフォルトの v1 は簡易カタログです。v2 が失敗した場合は、自動的に v1 にフォールバックします。
• オッズのフィールドを確認する前に selections_available を確認してください。オッズが存在するのは公開注文板がある場合のみです。total_stake（マッチ済み取引高）をオッズや流動性として提示しないでください。
• スポーツコード：soccer、tennis、basketball、baseball、ice-hockey、american-football とそのエイリアス（nfl、nba、mlb、nhl、epl、mls、worldcup、...）。

ワークフロー

試合のマーケットを探す

1. search_markets --sport=nfl --query="Eagles" — 条件に一致する最も開始時刻の近いイベントと、そのマーケットを検索します。
2. マーケット名／タイプ／ラインを提示します。オッズを示すのは selections_available: true のマーケットに限り、公開注文板が空のマーケットについては明示してください。

今日の試合一覧

1. get_todays_events --sport=mlb — ホーム／アウェイとスケジュールを含む、今日のイベント（UTC）を取得します。
2. 続けて get_markets --event_id=<id> --api_version=v2 を実行し、選手プロップや代替ラインを含む完全なカタログを取得します。

取引所を調べる

1. get_sports_config — スポーツと開催中のトーナメントを確認します。
2. get_tournaments --sport=soccer → get_events --tournament_id=<id>。

重要な注意事項

• 設計上、読み取り専用です：ログイン、Cookie、ブラウザーの自動操作は行わず、GET のみを使用します。控えめな頻度制限に加え、キャッシュとバックオフ付きリトライを実施します。403／WAF エラーやスキーマの変更が発生した場合は、安全側に停止します。
• 確認されているイベントの status 値：not_started、live。
• _raw には、正規化された各レコードについて、プロバイダーの完全なペイロードが保持されます。
• 会場をまたいだ統合検索：sports-skills markets search_entity --query="Yankees" には prophetx セクションが含まれます（公開注文板がある場合は、各結果の最良気配オッズが表示されます。注文板がまったく公開されていないイベントには note が付けられます）。