Metadata-Version: 2.4
Name: odds-api-client
Version: 0.1.1
Summary: Python SDK for an OpenAPI sports betting odds API for coding agents, with simple REST examples, mock mode, arbitrage, positive EV, line movement, and bookmaker comparison.
Author: Odds API
License-Expression: Apache-2.0
Project-URL: Homepage, https://odds-api.net
Project-URL: Repository, https://github.com/odds-api/odds-api
Project-URL: Issues, https://github.com/odds-api/odds-api/issues
Keywords: odds-api,odds,sports-odds,betting-odds,bookmaker-odds,sports-betting,racing,openapi,python-sdk,ai-agents,coding-agents,arbitrage,positive-ev,line-movement,rest-api,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"

# odds-api-client

Python SDK for `odds-api/odds-api`, an OpenAPI-first sports betting odds API for coding agents and developers.

Use this package when you want typed Python access to sports odds, betting odds, bookmaker comparison, arbitrage examples, positive EV examples, line movement, racing odds, and local mock-friendly tests.

## Install

After the first PyPI release is published:

```bash
python3 -m pip install odds-api-client
```

For local development from the GitHub repo:

```bash
git clone https://github.com/odds-api/odds-api.git
cd odds-api
python3 -m pip install -e sdks/python
```

## Quickstart

```python
from odds_api import OddsApiClient

client = OddsApiClient(api_key="your_api_key")
events = client.search_events(sport="rugby-league", league="NRL")
print(events)
```

The SDK also reads `ODDS_API_KEY` and `ODDS_API_BASE_URL` from the environment:

```python
from odds_api import OddsApiClient

client = OddsApiClient()
sports = client.list_sports()
```

## Common methods

- `list_sports()`
- `list_bookmakers()`
- `list_leagues()`
- `search_events()`
- `get_odds_snapshot()`
- `get_odds_history()`
- `find_best_odds()`
- `compare_bookmakers()`
- `find_arbitrage()`
- `find_positive_ev()`
- `get_line_movement()`
- `search_racing_events()`
- `get_racing_odds()`

## Safety

Arbitrage and positive EV examples are betting research workflows, not guaranteed-profit systems. Always account for stale odds, limits, delays, suspensions, voids, jurisdiction, and execution risk.

## Links

- GitHub: https://github.com/odds-api/odds-api
- API: https://api.odds-api.net/v1
- OpenAPI: https://github.com/odds-api/odds-api/blob/main/openapi.yaml
