Operators¶
Use this hub to run, validate, and maintain a local OddsFox Pipeline warehouse. Schedules stay disabled until manual jobs and dbt builds are healthy.
Path¶
- First run — Quickstart (Polymarket or Kalshi WC2026 tabs).
- Other scopes — Choose a scope and Run a scope.
- Day-two — Day-two operations.
- Recover — Validate and recover and Troubleshooting.
Credentials And Inputs¶
| Scope or pipeline | Network / credentials | Operator-local inputs |
|---|---|---|
polymarket:wc2026 |
Public Gamma/CLOB; CLOB auth optional unless a live job requires it | .env only for the ordinary full run |
polymarket:soccer |
Public Gamma/CLOB | .env only; the daily schedule is stopped by default |
kalshi:wc2026 |
Public trade API; no API credentials | .env only |
| Scraper references | No upstream access from Pipeline | Validated oddsfox.reference.v1 bundle |
| Match-minute odds (mature, isolated) | Live APIs or completed raw warehouse | Populated schedule overlay (tracked shell) |
| Match order book (mature, isolated) | Live APIs or completed raw warehouse; PMXT API key | Reviewed target manifest for match 104 |
| Market portrait (mature, isolated) | Completed order-book + trades scan; PMXT API key | Reviewed TARGET_MANIFEST for one approved match |
| Polygon settlement (advanced) | Finalized-capable Polygon JSON-RPC | Reviewed 248-row manifest + resolution attestation (tracked seed is a header-only shell) |
| Soccer pre-match Elo | Owned and operated by oddsfox-scraper |
Pipeline has no Elo command or source access |
Never commit .env, operator seed rows, reviewed attestations, DuckDB files, or
exports. See Operator responsibilities,
Scope and non-goals, and
dbt/seeds/README.md.
Run identity review, Elo, and reference publication from oddsfox-scraper.
Pipeline operators only load a validated oddsfox.reference.v1 bundle with
make reference-bundle-load REFERENCE_BUNDLE_DIR=/absolute/bundle.
Confirm Success¶
After a first Polymarket WC2026 full run you should have oddsfox.duckdb with
polymarket_wc2026_marts.polymarket_wc2026_market_hourly_odds. After a Kalshi
full run, confirm the stage and group-winner marts plus Scraper-bundle fixtures.
Those local checks verify technical shape;
they are not Hypertrial certification of data rights or fitness for trading.
See Operator responsibilities.
Query with Query the warehouse or hand off
to an analyst.
Advanced¶
These are optional. They are not part of the default quickstart. Start at Advanced pipelines for the decision tree and maturity tiers.
| Topic | Page |
|---|---|
| Isolated WC2026 paths (minute, order book, portrait, Polygon) | Advanced pipelines |
| Enable hourly schedules | Enable schedules |
| Shared rebuild setup (minute + Polygon) | Recreate local marts |
| Golden mart Parquet export | Scripts (export_polymarket_wc2026_market_hourly_odds.py) |
| Registry hygiene cleanup | Scripts / Troubleshooting (cleanup-polymarket-wc2026-registry-hygiene) |
| Configuration reference | Configuration |