🚤 Turnmark API

⚠️ 注意事項

本 API を利用する前に、以下の内容をご確認ください。

• ⚡ 本 API は非公式です。 BOATRACE 公式サイトおよび関連団体とは一切関係ありません。

• 🕒 データはリアルタイムではありません。 GitHub Actions による定期更新を行っており、前日までのデータを提供しています。更新スケジュールは sync.yml を参照してください。

• 📊 データの正確性・完全性は保証していません。 収集・変換の都合により、欠損や誤りが含まれる可能性があります。

• 🚫 公式な情報が必要な場合は、必ず BOATRACE 公式サイトをご確認ください。

• 🙇‍♂️ 本 API の利用は自己責任でお願いします。

📌 概要

この API では、ボートレース（競艇）のデータを取得できます。
データは GitHub Pages 上で公開されており、JSON 形式で提供されます。

• 対応レース場: 全国 24 場すべてに対応しています。特定のレース場のみを取り出すエンドポイントはなく、1日分のデータに全場の情報が含まれます。
• 取得可能なデータ: 出走表・直前情報・オッズ・結果

🌐 エンドポイント

📅 対応期間: 2026年05月01日以降

https://turnmark.github.io/api/v1/YYYY/YYYYMMDD.json

📅 YYYY → 年
📅 YYYYMMDD → 年月日
（ 日付は日本標準時 JST〔UTC+9〕基準 ）

データが存在しない日付（対応期間外・未来日付など）を指定した場合、GitHub Pages の仕様により HTTP 404 が返されます。

📐 レスポンス仕様

レスポンスの JSON 構造・各フィールドの詳細については、スキーマドキュメントを参照してください。

• docs/v1/schema.md

🧩 サンプル

• 2026年05月01日のデータ
  • https://turnmark.github.io/api/v1/2026/20260501.json

コードサンプル

各言語でのデータ取得・パース例は docs/v1/example.md を参照してください。

📄 ライセンス

Turnmark API は MIT license の元で公開されています。