--- 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 (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 ## 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` ## 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. ## 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 - Verification hub: https://www.oddsflow.ai/verification - Performance logs: https://www.oddsflow.ai/performance - 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. ## 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