Metadata-Version: 2.4
Name: betbetter
Version: 1.0.0
Summary: Zero-dependency Python client for the free Bet Better sports model API — win probabilities, fair odds and plain-English verdicts across 12 sports. No API key required.
Author-email: Bet Better <edward@betbetter.world>
License: MIT
Project-URL: Homepage, https://betbetter.world
Project-URL: Documentation, https://betbetter.world/api/
Project-URL: Repository, https://github.com/betbetterworld/betbetter-python
Project-URL: Open datasets, https://betbetter.world/studies/
Keywords: sports,betting,odds,sports-analytics,api-client,predictions,probabilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Intended Audience :: Science/Research
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# betbetter

Zero-dependency Python client for the **free [Bet Better](https://betbetter.world) sports model API** — win probabilities, fair odds and plain-English verdicts for every selection the models publish, across 12 sports. **No API key required.**

```bash
pip install betbetter
```

```python
import betbetter

feed = betbetter.get_picks("mlb")
for p in feed["picks"][:3]:
    print(p["game"], "—", p["selection"], f'({p["confidence"]}, fair odds {p["fairOdds"]})')

props = betbetter.get_prop_bets("nfl")      # player props only
record = betbetter.get_results()            # the public settled record — wins AND losses
scorecard = betbetter.get_scorecard()       # per-market hit rate, ROI, closing-line value
```

## What you get

Every selection carries the model's own numbers — no bookmaker prices are republished:

| Field | Meaning |
|---|---|
| `game`, `gameTimeUtc` | Fixture and UTC start time |
| `market`, `selection`, `line` | What the bet is, in plain words |
| `modelProbabilityPct` | The model's win probability (%) |
| `fairOdds` | Decimal odds implied by that probability |
| `confidence` | `HIGH` / `LEAN` / `LONG-SHOT` |
| `verdict` | A dated plain-English read |

Leagues: `betbetter.LEAGUES` — AFL, MLB, NBA, NFL, NHL, NCAAF, NRL, UFC, WNBA, cricket, ATP/WTA tennis, and six soccer competitions.

## More from Bet Better

- **API docs**: https://betbetter.world/api/ (OpenAPI 3.0 spec: [/api/openapi.json](https://betbetter.world/api/openapi.json))
- **MCP server** (for AI agents): [`npx betbetter-mcp`](https://www.npmjs.com/package/betbetter-mcp)
- **Open datasets & working papers** (CC BY 4.0, DOI-backed): https://betbetter.world/studies/
- **The public record** — every pick graded, wins and losses: https://betbetter.world/results

## Licence

Client code: MIT. The data feed is **CC BY 4.0** — free to use, including commercially, with attribution to *Bet Better (https://betbetter.world)*.

Model estimates for research. Not betting advice. 18+. Gamble responsibly.
