flash-props-api

Flash Props API + MCP

Flash Props API は、スポーツやeスポーツ全般の公開されたライン、Flashの予測値、根拠、状況、ラインの変動を提供する、Flash AI Solutionsによる選手成績予測APIおよびMCPサーバーです。

このリポジトリは、ホスト型のFlash Props APIおよびMCPサービスの公開コネクターとメタデータの窓口です。このリポジトリからインストールできる、独自のFlash Propsバックエンドサーバーはありません。クライアントをホスト型エンドポイントに接続し、ボードデータを取得するにはFlash Props APIキーで認証してください。

Flash Propsの公式リンク

• ウェブサイト：https://api.flashodds.live/
• ドキュメント：https://api.flashodds.live/docs
• OpenAPI：https://api.flashodds.live/openapi.json
• 公開コントラクト：https://api.flashodds.live/contract.json
• MCPエンドポイント：https://api.flashodds.live/mcp
• 無料APIキー：https://api.flashodds.live/billing/free
• 提供元：https://www.flashaisolutions.org
• Postmanセットアップガイド
• 公開Postmanワークスペース
• Postman JSONコレクション

PostmanでAPIを試す

Flash Props公開Postmanワークスペースには、グラフィカルに試したり、フォークしたりするためのコレクションが含まれています。SDKを使わずに最初のリクエストを成功させるには、まずPostmanクイックスタートを確認し、無料キーを作成してから、Start hereフォルダー内のList supported sports with live status + capabilityリクエストを実行してください。

ブラウザーからPostmanにアクセスできない場合は、認証情報を含まないコレクションJSONをダウンロードし、Postmanのインポート操作を使用してください。APIホストでは、このJSONを参照用コピーとして管理しています。マーケットプレイス上のコピーは、製品リリース後に更新が遅れることがあります。

キーをGitHub、URL、共有コレクション変数、スクリーンショットに貼り付けないでください。コレクションのapiKey変数は意図的に空になっています。認証が必要なリクエストを実行する前に、Postmanでキーを非公開に設定してください。

REST APIを2つのリクエストで試す（Node 20+）

スポーツデータ連携が初めてですか？依存関係なしで実行できる最初のリクエストの例を実行してください。現在のスポーツカタログを読み込み、選択したスポーツのマーケット用語を取得します。これは読み取り専用の例で、賭け、賭けの自動化、SDKのインストール、有料プランは必要ありません。

1. 無料のFlash Props APIキーを取得します。
2. キーをローカルの FLASH_PROPS_API_KEY 環境変数に設定します。コミットやクエリ文字列には含めないでください。
3. CS2の場合は node examples/first-request.mjs、NFLの場合は node examples/first-request.mjs nfl を実行します。

macOS/Linuxでは、コマンド履歴に保存せずにキーを入力する方法として、read -rs FLASH_PROPS_API_KEY && export FLASH_PROPS_API_KEY を使用できます。PowerShellでは、$env:FLASH_PROPS_API_KEY = Read-Host "Flash Props API key" を使用します。使用後は変数をクリアしてください。

このスクリプトは、キーを漏らしたり、クォータ制限に達するまで暗黙に再試行したりすることなく、401、403、429を確認します。現在の対応状況の信頼できる情報源として GET /api/v1/sports を使用します。選択したスポーツのライブボードが現在利用できない場合があります。テストはモックレスポンスを使い、ネットワークに接続せずに実行できる examples/first-request.test.mjs に含まれています。

代わりにAIエージェントを接続しますか？ 以下のリモートMCPエンドポイントを、同じキーとプランで使用してください。サードパーティのディレクトリにキャッシュされた機能一覧がホストサーバーの情報より古い場合は、公開中のコントラクトを優先してください。

接続

Streamable HTTPエンドポイント：

https://api.flashodds.live/mcp

AuthorizationヘッダーにAPIキーを指定します：

Authorization: Bearer <your_api_key>

匿名アクセスでも機能の検出（list_sports、get_market_metadata）を利用できるため、クライアントは初回実行時に現在の対応状況を確認できます。ボードデータの取得には、少なくとも無料キーが必要です。https://api.flashodds.live/billing/free から取得してください。

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "flash-props": {
      "type": "streamable-http",
      "url": "https://api.flashodds.live/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

ツール

以下のアクセス段階は、ホストされているコントラクトから生成されています。手作業で編集しないでください。

ツール	アクセス
list_sports	匿名での機能検出
get_market_metadata	匿名での機能検出
list_games	匿名プレビュー（最初の5件）；完全な日程表はFree+
get_game_props	Free+
scan_props	匿名プレビュー（最初の5行）；Free+；プランごとに行数上限あり（Freeは15行、Builderは100行、Proは3,000行、Enterpriseは5,000行）
find_game	Free+
find_player_props	Free+
get_player_context	Free/Builderは基本；Proは全機能
get_prop_evidence	Freeはティーザー；Builderは基本；Proは全機能
get_prop_history	Builderは制限あり（最新25ポイント）；Proは全機能
scan_movers	Builderは制限あり（上位25件の変動）；Proは全機能
get_leaders	Freeは上位3件；Builderは上位10件；Proは上位100件

各ツールが返す内容：

• list_sports：ライブ状況、データの鮮度、予測／コンテキスト機能を含む、すべてのスポーツ
• get_market_metadata：マーケットのラベル、ファミリー、対象範囲、モデル化の有無
• list_games：指定したスポーツのプロップを含む試合
• get_game_props：1試合のすべての選手プロップ
• scan_props：日程表全体を対象としたマーケット横断のプロップスキャン
• find_game：チーム名からイベントIDを特定
• find_player_props：1人の選手のすべての有効なプロップ
• get_player_context：シーズンの基準値、直近の調子、詳細なコンテキスト
• get_prop_evidence：ブックのライン、Flashのライン、差、調子、信頼度、分割データ、変動
• get_prop_history：プロップのラインとオッズの時系列履歴
• scan_movers：指定期間内の最大のライン変動
• get_leaders：差、調子、サンプルの強さで順位付けされたボード

RESTとMCPでは同じ権限に基づく制御が適用されるため、どちらのトランスポートでも、キーに応じて同じ製品ティアが適用されます。

プロバイダー主導のカバレッジ

Flash の予測を利用できるスポーツのリストをハードコードしないでください。カバレッジはサーバーに登録されたモデルプロバイダーから解決され、スポーツ + マーケットによって異なる場合があります。

list_sports（または GET /api/v1/sports）を使用して projectionCapability、effectiveProjection、contextCapability を確認し、次に get_market_metadata を使用して特定のマーケットがモデル化されているかを判断してください。一部のみモデル化されているスポーツでは、あるスタッツについて Flash の予測を公開しつつ、別のスタッツについては掲載ラインのみを提供することがあります。

分析が利用できない場合は、明示的に報告されます。Flash Props は、未対応のマーケットを補うために予測を捏造することはありません。

予測とボードのスナップショットを読み取る

• すべての予測で basis を確認してください。 current_season は今シーズンのデータを基にしています。prior_season は前シーズンのベースラインであり、現在の調子として提示してはいけません。basisNote と seasonId で、どのシーズンのデータかを確認できます。
• snapshotId を使って、数値が同じボードを示しているかを確認してください。 スポーツ、ゲーム、プロップのレスポンスで snapshotId が一致していれば、件数と行は同じ論理ボードのものです。整合性の値が mixed の場合、レスポンスは一部のみであるため、その件数を別のスナップショットの行と比較しないでください。

ティア

ホストされたコントラクトから生成されています。手動で編集しないでください。

• Free：$0、1 日あたり 300 リクエスト、1 分あたり 10 リクエスト、スキャン上限 15 行、エビデンスの概要、基本コンテキスト、履歴なし、変動なし、上位 3 件のリーダー
• Builder（内部 ID starter）：月額 $19、1 日あたり 25,000 リクエスト、1 分あたり 120 リクエスト、スキャン上限 100 行、基本エビデンス、基本コンテキスト、限定的な履歴、限定的な変動、上位 10 件のリーダー
• Pro：月額 $49、1 日あたり 150,000 リクエスト、1 分あたり 600 リクエスト、スキャン上限 3,000 行、すべてのエビデンス、すべてのコンテキスト、すべての履歴、すべての変動、上位 100 件のリーダー
• Enterprise：カスタム制限

現在の料金と REST リファレンスは https://api.flashodds.live/ をご覧ください。

コントラクト

この README に記載されているティアの制限、エンタイトルメント、MCP ツールの段階は、手動で記述するのではなく生成されます。ホストされた API は、キー不要で機械可読なコントラクトを公開しており、このリポジトリには contract/flash-props-contract.json にコピーが格納されています。

機械可読な情報源は、権威の高い順に以下のとおりです。

• GET https://api.flashodds.live/contract.json：ティア、クォータ、エンタイトルメント、MCP ツールとアクセス権、スポーツ用語、予測とスナップショットのルール。API リリースごとに固定されています。
• GET https://api.flashodds.live/api/v1/sports（Free キーが必要）または匿名で使える MCP の list_sports ツール：ランタイムの状態。どのスポーツが現在モデル化されているか、ライブか、新鮮なデータを利用できるかはここに記載され、コントラクトやこの README には記載されません。

メンテナー：

node scripts/contract.mjs sync          # regenerate README blocks and server.json version
node scripts/contract.mjs check         # offline drift gate (runs on every push and PR)
node scripts/contract.mjs check --live  # also compare the vendored copy to the hosted contract
node scripts/contract.mjs links         # check every https link in this README

生成されたブロックが古い場合、コントラクトに記載されていないクォータや価格を本文で引用している場合、廃止されたティア名が含まれている場合、モデル化されたスポーツの固定リストが含まれている場合、server.json がコントラクトのバージョンまたは MCP エンドポイントと一致しない場合、あるいは README とコントラクトで存在するツールの認識が一致しない場合、CI は失敗します。また、日次のスケジュール済みジョブで、リポジトリに変更がない場合でも差異を検出できるよう、リポジトリに格納されたコントラクトとホストされたコントラクトを比較します。

免責事項

データは情報提供のみを目的としています。Flash Props はスポーツブックではなく、リーグ、チーム、選手、スポーツブック、または DFS 運営事業者とも提携していません。

リンク

• API と料金：https://api.flashodds.live/
• REST リファレンス：https://api.flashodds.live/docs
• 公開コントラクト：https://api.flashodds.live/contract.json
• Flash AI Solutions が開発