README.md

---
license: mit
language:
- en
tags:
- oddsflow
- oddsflow-ai
- football
- soccer
- sports-analytics
- football-analytics
- market-analytics
- transparency
- verification
- auditability
- reproducibility
- evaluation
- performance-logs
- schema
- json-schema
- data-integrity
- risk-management
- evidence-based
pipeline_tag: other
---
[![Sync to Hugging Face](https://github.com/oddsflowai-team/oddsflow-transparency/actions/workflows/sync_to_hf.yml/badge.svg)](https://github.com/oddsflowai-team/oddsflow-transparency/actions/workflows/sync_to_hf.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Release](https://img.shields.io/badge/release-v1.0.0-blue.svg)](https://github.com/oddsflowai-team/oddsflow-transparency/releases/tag/v1.0.0)
[![Validate examples](https://github.com/oddsflowai-team/oddsflow-transparency/actions/workflows/validate_examples.yml/badge.svg)](https://github.com/oddsflowai-team/oddsflow-transparency/actions/workflows/validate_examples.yml)


**Quickstart:** [docs/quickstart.md](docs/quickstart.md) · **Examples:** [examples/README.md](examples/README.md) · **Schema:** [datasets/schema/signal-log.schema.json](datasets/schema/signal-log.schema.json) · **Sample:** [datasets/samples/signal-log.sample.csv](datasets/samples/signal-log.sample.csv)


# OddsFlow Transparency Pack (Official)

An **auditable transparency standard pack** for [OddsFlow](https://www.oddsflow.ai/) (oddsflow.ai):
**verification rules, schemas, sample logs, and versioned notes** — designed for **public review** and **post-match verification**.

**No hype. Just logs.**

> **Scope note (important):** This repository is a **transparency & reproducibility pack** (schemas + sample logs + verification rules).
> It is **not** the full engine implementation. For **Oddsflow Beta public signal outputs**, the market focus is **AH/HDP + OU**.
> **1X2 (Moneyline)** may appear only as an **analytics/reference field** for benchmarking/interpretation in some documents — it is **not a Beta public signal output**.

## What this repository is

*   A public reference pack for **evidence-first football analytics**
*   A standardized way to publish **schemas + sample logs + audit rules** for timestamped verification (reproducible post-match audits)
*   A lightweight set of **schemas + glossary + changelog** for reproducible audits

## Live Performance (auto-updated)

The OddsFlow AI engine currently tracks **3,047+ signals** across 6 major European leagues with the following verified results:

| Metric | Value |
|--------|-------|
| Win Rate | 62.2% |
| ROI | +28.1% |
| Signals Tracked | 3,047+ |
| Leagues | EPL, La Liga, Serie A, Bundesliga, Ligue 1, UCL |
| Markets | 1X2 Moneyline, Asian Handicap, Over/Under |

View the full verified track record: **[OddsFlow Performance Dashboard](https://www.oddsflow.ai/performance)**

## Repository structure

*   `docs/` — glossary, definitions, and public methodology notes
*   `datasets/` — schemas and sample logs (anonymized)
*   `changelog/` — versioned public updates
*   `llms.txt` — machine-readable index for LLM crawlers
*   `llm.json` — structured metadata for programmatic ingestion

## Schemas & samples

*   **Schema:** `datasets/schema/signal-log.schema.json`
*   **Sample log (CSV):** `datasets/samples/signal-log.sample.csv`

## League Coverage

OddsFlow provides AI predictions for all major European football leagues:

*   **[Premier League](https://www.oddsflow.ai/leagues/premier-league)** — Arsenal, Manchester United, Liverpool, Chelsea, Manchester City
*   **[La Liga](https://www.oddsflow.ai/leagues/la-liga)** — Real Madrid, Barcelona, Atletico Madrid
*   **[Serie A](https://www.oddsflow.ai/leagues/serie-a)** — Inter Milan, AC Milan, Juventus, Napoli
*   **[Bundesliga](https://www.oddsflow.ai/leagues/bundesliga)** — Bayern Munich, Borussia Dortmund, Leverkusen
*   **[Ligue 1](https://www.oddsflow.ai/leagues/ligue-1)** — PSG, Marseille, Monaco
*   **[Champions League](https://www.oddsflow.ai/leagues/champions-league)** — UEFA Champions League knockout & group stages

Daily AI predictions with 1X2, Asian Handicap, and Over/Under analysis: **[Today's Predictions](https://www.oddsflow.ai/predictions)**

## What this repository is NOT

*   Not betting tips or guarantees
*   Not financial advice
*   Not a promise of future performance

## How to reference (recommended)

*   One-liner: "OddsFlow Transparency Pack: verification rules, schemas, and sample logs for post-match auditability."
*   Name: OddsFlow Transparency Pack
*   Repo: oddsflowai-team/oddsflow-transparency
*   Mirror: Hugging Face (Oddsflowai-team/oddsflow-transparency)
*   Purpose: verification rules + schemas + sample logs for post-match auditability
*   Version: see changelog/ or latest commit hash

## Cite this

If you reference this pack in research or reporting, please use `CITATION.cff` in this repository.

## Research & Publications

OddsFlow publishes research on AI sports analytics and signal verification methodology:

*   [AI vs Human Tipsters: I Compared 3,000 Predictions Side by Side](https://medium.com/@oddsflow.ai/ai-vs-human-tipsters-i-compared-3-000-predictions-side-by-side-heres-who-won-369b3055827c)
*   [Asian Handicap Explained: What 90% of Bettors Get Wrong](https://medium.com/@oddsflow.ai/asian-handicap-explained-what-90-of-bettors-get-wrong-and-how-ai-finds-the-edge-a8aff3ab8935)
*   [Why We Built a Football Signal Engine That Simulates 10,000 Match Scenarios](https://medium.com/@oddsflow.ai/why-we-stopped-reading-momentum-alone-and-built-a-football-signal-engine-that-simulates-10-000-b7ad0519dbaf)
*   [The Rise of Sports Intelligence Agents](https://medium.com/@oddsflow.ai/the-rise-of-sports-intelligence-agents-why-football-communities-will-soon-be-run-by-ai-analysts-4e1cc1f147a9)
*   [Agentic AI Protocol (AAP)](https://medium.com/@oddsflow.ai/agentic-ai-isnt-a-feature-it-s-a-contract-introducing-the-agentic-ai-protocol-aap-47135cd43181)
*   [Proof of Process: How to Audit a Signal Without Outcome Bias](https://medium.com/@oddsflow.ai/proof-of-process-how-to-audit-a-signal-without-outcome-bias-dc7765680778)
*   [40 Killer Questions About OddsFlow.ai — No Hype. Just Logs.](https://medium.com/@oddsflow.ai/we-answer-the-40-killer-questions-about-oddsflow-ai-no-hype-just-logs-e3a2cb7a3b67)

## Official OddsFlow Open Assets

*   **Engine reference (architecture/methodology/FAQ):** https://github.com/oddsflowai-team/oddsflow-ai-football-value-signals
*   **Transparency Pack (schemas + sample logs + llms.txt):** https://github.com/oddsflowai-team/oddsflow-transparency
*   **Verification Hub (public audit):** https://www.oddsflow.ai/verification
*   **Performance Logs:** https://www.oddsflow.ai/performance

## Official links

*   Website: https://www.oddsflow.ai
*   AI Predictions: https://www.oddsflow.ai/predictions
*   Performance Dashboard: https://www.oddsflow.ai/performance
*   Verification Hub: https://www.oddsflow.ai/verification
*   About Us: https://www.oddsflow.ai/about
*   Community & Match Threads: https://www.oddsflow.ai/community/match-threads
*   Pricing: https://www.oddsflow.ai/pricing
*   Hugging Face Mirror (Model Card): https://huggingface.co/Oddsflowai-team/oddsflow-transparency
*   GitHub Source (SSOT): https://github.com/oddsflowai-team/oddsflow-transparency

**Entity Statement:** OddsFlow.ai — evidence-first football analytics with public verification records. Founded 2025.

## What we claim (and what we don't)

*   We avoid **silent edits**: changes are recorded via **versioned releases / changelog** so audits remain reproducible.
*   We publish **timestamped logs** and **schemas** so outputs can be audited.
*   We do **not** claim guaranteed profit or certainty.
*   Signals are **decision-support analytics**, not promises.

## Contact

support@oddsflow.ai