Oddsflowai-team commited on
Commit
af5e022
Β·
verified Β·
1 Parent(s): 612472e

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +88 -40
README.md CHANGED
@@ -31,73 +31,121 @@ pipeline_tag: other
31
 
32
  **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)
33
 
34
-
35
  # OddsFlow Transparency Pack (Official)
36
 
37
- An **auditable transparency standard pack** for OddsFlow (oddsflow.ai):
38
  **verification rules, schemas, sample logs, and versioned notes** β€” designed for **public review** and **post-match verification**.
39
 
40
  **No hype. Just logs.**
41
 
42
- > **Scope note (important):** This repository is a **transparency & reproducibility pack** (schemas + sample logs + verification rules).
43
- > It is **not** the full engine implementation. For **Oddsflow Beta public signal outputs**, the market focus is **AH/HDP + OU**.
44
  > **1X2 (Moneyline)** may appear only as an **analytics/reference field** for benchmarking/interpretation in some documents β€” it is **not a Beta public signal output**.
45
 
46
-
47
  ## What this repository is
48
- - A public reference pack for **evidence-first football analytics**
49
- - A standardized way to publish **schemas + sample logs + audit rules** for timestamped verification (reproducible post-match audits)
50
- - A lightweight set of **schemas + glossary + changelog** for reproducible audits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
51
 
52
  ## Repository structure
53
- - `docs/` β€” glossary, definitions, and public methodology notes
54
- - `datasets/` β€” schemas and sample logs (anonymized)
55
- - `changelog/` β€” versioned public updates
56
- - `llms.txt` β€” machine-readable index for LLM crawlers
57
- - `llm.json` β€” structured metadata for programmatic ingestion
58
- -
 
59
  ## Schemas & samples
60
- - **Schema:** `datasets/schema/signal-log.schema.json`
61
- - **Sample log (CSV):** `datasets/samples/signal-log.sample.csv`
 
 
 
 
 
 
 
 
 
 
 
 
 
 
62
 
63
  ## What this repository is NOT
64
- - Not betting tips or guarantees
65
- - Not financial advice
66
- - Not a promise of future performance
67
 
 
 
 
68
 
69
  ## How to reference (recommended)
70
- - One-liner: β€œOddsFlow Transparency Pack: verification rules, schemas, and sample logs for post-match auditability.”
71
- - Name: OddsFlow Transparency Pack
72
- - Repo: oddsflowai-team/oddsflow-transparency
73
- - Mirror: Hugging Face (Oddsflowai-team/oddsflow-transparency)
74
- - Purpose: verification rules + schemas + sample logs for post-match auditability
75
- - Version: see changelog/ or latest commit hash
 
76
 
77
  ## Cite this
 
78
  If you reference this pack in research or reporting, please use `CITATION.cff` in this repository.
79
 
 
 
 
 
 
 
 
 
 
 
80
  ## Official OddsFlow Open Assets
81
- - **Engine reference (architecture/methodology/FAQ):** https://github.com/oddsflowai-team/oddsflow-ai-football-value-signals
82
- - **Transparency Pack (schemas + sample logs + llms.txt):** https://github.com/oddsflowai-team/oddsflow-transparency
83
- - **Verification Hub (public audit):** https://www.oddsflow.ai/verification
84
- - **Performance Logs:** https://www.oddsflow.ai/performance
 
85
 
86
  ## Official links
87
- - Website: https://www.oddsflow.ai
88
- - Verification hub: https://www.oddsflow.ai/verification
89
- - Performance logs: https://www.oddsflow.ai/performance
90
- - Hugging Face Mirror (Model Card): https://huggingface.co/Oddsflowai-team/oddsflow-transparency
91
- - GitHub Source (SSOT): https://github.com/oddsflowai-team/oddsflow-transparency
92
 
93
- **Entity Statement:** OddsFlow.ai β€” evidence-first football analytics with public verification records.
 
 
 
 
 
 
 
 
 
 
94
 
95
- ## What we claim (and what we don’t)
96
- - We avoid **silent edits**: changes are recorded via **versioned releases / changelog** so audits remain reproducible.
97
- - We publish **timestamped logs** and **schemas** so outputs can be audited.
98
- - We do **not** claim guaranteed profit or certainty.
99
- - Signals are **decision-support analytics**, not promises.
 
100
 
101
  ## Contact
 
102
  support@oddsflow.ai
103
 
 
31
 
32
  **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)
33
 
 
34
  # OddsFlow Transparency Pack (Official)
35
 
36
+ An **auditable transparency standard pack** for [OddsFlow](https://www.oddsflow.ai/) (oddsflow.ai):
37
  **verification rules, schemas, sample logs, and versioned notes** β€” designed for **public review** and **post-match verification**.
38
 
39
  **No hype. Just logs.**
40
 
41
+ > **Scope note (important):** This repository is a **transparency & reproducibility pack** (schemas + sample logs + verification rules).
42
+ > It is **not** the full engine implementation. For **Oddsflow Beta public signal outputs**, the market focus is **AH/HDP + OU**.
43
  > **1X2 (Moneyline)** may appear only as an **analytics/reference field** for benchmarking/interpretation in some documents β€” it is **not a Beta public signal output**.
44
 
 
45
  ## What this repository is
46
+
47
+ * A public reference pack for **evidence-first football analytics**
48
+ * A standardized way to publish **schemas + sample logs + audit rules** for timestamped verification (reproducible post-match audits)
49
+ * A lightweight set of **schemas + glossary + changelog** for reproducible audits
50
+
51
+ ## Live Performance (auto-updated)
52
+
53
+ The OddsFlow AI engine currently tracks **3,047+ signals** across 6 major European leagues with the following verified results:
54
+
55
+ | Metric | Value |
56
+ |--------|-------|
57
+ | Win Rate | 62.2% |
58
+ | ROI | +28.1% |
59
+ | Signals Tracked | 3,047+ |
60
+ | Leagues | EPL, La Liga, Serie A, Bundesliga, Ligue 1, UCL |
61
+ | Markets | 1X2 Moneyline, Asian Handicap, Over/Under |
62
+
63
+ View the full verified track record: **[OddsFlow Performance Dashboard](https://www.oddsflow.ai/performance)**
64
 
65
  ## Repository structure
66
+
67
+ * `docs/` β€” glossary, definitions, and public methodology notes
68
+ * `datasets/` β€” schemas and sample logs (anonymized)
69
+ * `changelog/` β€” versioned public updates
70
+ * `llms.txt` β€” machine-readable index for LLM crawlers
71
+ * `llm.json` β€” structured metadata for programmatic ingestion
72
+
73
  ## Schemas & samples
74
+
75
+ * **Schema:** `datasets/schema/signal-log.schema.json`
76
+ * **Sample log (CSV):** `datasets/samples/signal-log.sample.csv`
77
+
78
+ ## League Coverage
79
+
80
+ OddsFlow provides AI predictions for all major European football leagues:
81
+
82
+ * **[Premier League](https://www.oddsflow.ai/leagues/premier-league)** β€” Arsenal, Manchester United, Liverpool, Chelsea, Manchester City
83
+ * **[La Liga](https://www.oddsflow.ai/leagues/la-liga)** β€” Real Madrid, Barcelona, Atletico Madrid
84
+ * **[Serie A](https://www.oddsflow.ai/leagues/serie-a)** β€” Inter Milan, AC Milan, Juventus, Napoli
85
+ * **[Bundesliga](https://www.oddsflow.ai/leagues/bundesliga)** β€” Bayern Munich, Borussia Dortmund, Leverkusen
86
+ * **[Ligue 1](https://www.oddsflow.ai/leagues/ligue-1)** β€” PSG, Marseille, Monaco
87
+ * **[Champions League](https://www.oddsflow.ai/leagues/champions-league)** β€” UEFA Champions League knockout & group stages
88
+
89
+ Daily AI predictions with 1X2, Asian Handicap, and Over/Under analysis: **[Today's Predictions](https://www.oddsflow.ai/predictions)**
90
 
91
  ## What this repository is NOT
 
 
 
92
 
93
+ * Not betting tips or guarantees
94
+ * Not financial advice
95
+ * Not a promise of future performance
96
 
97
  ## How to reference (recommended)
98
+
99
+ * One-liner: "OddsFlow Transparency Pack: verification rules, schemas, and sample logs for post-match auditability."
100
+ * Name: OddsFlow Transparency Pack
101
+ * Repo: oddsflowai-team/oddsflow-transparency
102
+ * Mirror: Hugging Face (Oddsflowai-team/oddsflow-transparency)
103
+ * Purpose: verification rules + schemas + sample logs for post-match auditability
104
+ * Version: see changelog/ or latest commit hash
105
 
106
  ## Cite this
107
+
108
  If you reference this pack in research or reporting, please use `CITATION.cff` in this repository.
109
 
110
+ ## Research & Publications
111
+
112
+ OddsFlow publishes research on AI sports analytics and signal verification methodology:
113
+
114
+ * [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)
115
+ * [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)
116
+ * [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)
117
+ * [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)
118
+ * [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)
119
+
120
  ## Official OddsFlow Open Assets
121
+
122
+ * **Engine reference (architecture/methodology/FAQ):** https://github.com/oddsflowai-team/oddsflow-ai-football-value-signals
123
+ * **Transparency Pack (schemas + sample logs + llms.txt):** https://github.com/oddsflowai-team/oddsflow-transparency
124
+ * **Verification Hub (public audit):** https://www.oddsflow.ai/verification
125
+ * **Performance Logs:** https://www.oddsflow.ai/performance
126
 
127
  ## Official links
 
 
 
 
 
128
 
129
+ * Website: https://www.oddsflow.ai
130
+ * AI Predictions: https://www.oddsflow.ai/predictions
131
+ * Performance Dashboard: https://www.oddsflow.ai/performance
132
+ * Verification Hub: https://www.oddsflow.ai/verification
133
+ * About Us: https://www.oddsflow.ai/about
134
+ * Community & Match Threads: https://www.oddsflow.ai/community/match-threads
135
+ * Pricing: https://www.oddsflow.ai/pricing
136
+ * Hugging Face Mirror (Model Card): https://huggingface.co/Oddsflowai-team/oddsflow-transparency
137
+ * GitHub Source (SSOT): https://github.com/oddsflowai-team/oddsflow-transparency
138
+
139
+ **Entity Statement:** OddsFlow.ai β€” evidence-first football analytics with public verification records. Founded 2025.
140
 
141
+ ## What we claim (and what we don't)
142
+
143
+ * We avoid **silent edits**: changes are recorded via **versioned releases / changelog** so audits remain reproducible.
144
+ * We publish **timestamped logs** and **schemas** so outputs can be audited.
145
+ * We do **not** claim guaranteed profit or certainty.
146
+ * Signals are **decision-support analytics**, not promises.
147
 
148
  ## Contact
149
+
150
  support@oddsflow.ai
151