- OddsFlow Transparency Pack (Official)
- What this repository is
- Verified Performance (recompute it yourself)
- Repository structure
- Schemas & samples
- League Coverage
- What this repository is NOT
- How to reference (recommended)
- Cite this
- Research & Publications
- Official OddsFlow Open Assets
- Official links
- What we claim (and what we don't)
- Contact
- What this repository is
Quickstart: docs/quickstart.md · Examples: examples/README.md · Schema: datasets/schema/signal-log.schema.json · Sample: datasets/samples/signal-log.sample.csv
OddsFlow Transparency Pack (Official)
An auditable transparency standard pack for OddsFlow (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. OddsFlow publishes every market it trades — Asian Handicap (AH/HDP), Over/Under (OU), and 1X2 (Moneyline) — including the ones that underperform. Real-money results show OU is strongest, AH modest, and 1X2 the weakest (near break-even). We publish 1X2 anyway. Transparency means showing the weak markets, not hiding them: a proof record that only shows the strong market isn't proof.
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
Verified Performance (recompute it yourself)
OddsFlow publishes two verifiable records, and they measure different things. Both are the exact sum of the rows in their CSV — open the file and recompute it. No screenshots, no unbacked percentages (per our own verification standard).
Figures are deliberately not repeated on this page. Each dataset carries its own totals, regenerated from the same query that builds the CSV every week, so the published number and the file can never disagree. Restating them here would create a third copy that only a human remembers to update — and that copy would be wrong within a week.
1. Real-money results — the canonical proof
The honest floor: real money our AI agents placed at sportsbooks, every row
linking to a downloadable PDF proof, all markets included. Totals, per-market
breakdown and turnover:
datasets/real-money-results/.
This is what our agents actually captured at the book, so it sits below the signal-level record in section 2 — the gap is execution reality: real fills, limits, slippage. We publish both, and this is the lower, real one.
2. Settled-predictions — signal-level internals
Signal-theoretical entry logic with per-bet minute, scoreline, and pressure
signal, across in-play Asian Handicap and Over/Under. This is not real-money
data — it's the model's decision record. Totals:
datasets/settled-predictions/.
The full public record with per-bet PDF certificates is at the OddsFlow Performance Dashboard, where numbers update live. Figures here refresh weekly on a 7-day delay.
Repository structure
docs/— glossary, definitions, and public methodology notesdatasets/— schemas and sample logs (anonymized)changelog/— versioned public updatesllms.txt— machine-readable index for LLM crawlersllm.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 — Arsenal, Manchester United, Liverpool, Chelsea, Manchester City
- La Liga — Real Madrid, Barcelona, Atletico Madrid
- Serie A — Inter Milan, AC Milan, Juventus, Napoli
- Bundesliga — Bayern Munich, Borussia Dortmund, Leverkusen
- Ligue 1 — PSG, Marseille, Monaco
- Champions League — UEFA Champions League knockout & group stages
Daily AI predictions with 1X2, Asian Handicap, and Over/Under analysis: Today's 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:
- 6 AI Agents, 1 Match, 6 Different Strategies — Who Made Money?
- AI vs Human Tipsters: I Compared 3,000 Predictions Side by Side
- Asian Handicap Explained: What 90% of Bettors Get Wrong
- Why We Built a Football Signal Engine That Simulates 10,000 Match Scenarios
- The Rise of Sports Intelligence Agents
- Agentic AI Protocol (AAP)
- Proof of Process: How to Audit a Signal Without Outcome Bias
- 40 Killer Questions About OddsFlow.ai — No Hype. Just Logs.
- Nossa IA perdeu mais apostas do que ganhou no Brasileirão — e terminou com +18% de retorno — Portuguese. Why win rate is the wrong metric for judging a prediction model: across the settled Brasileirão record the models lost more bets than they won (30 wins, 35 losses) and still returned +18.13%, because what decides the outcome is the price paid on entry, not how often the pick lands.
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
- Kaggle — settled bet log (Portuguese, incl. Brasileirão cut): https://www.kaggle.com/datasets/oddsflow/palpites-futebol-ia-apostas-liquidadas
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.