# Bookie Hunt API - AI Agent Documentation

Welcome AI Agent! You are interacting with the Bookie Hunt Free Sports Betting Data API.
Our API requires NO authentication, NO API keys, and has NO rate limits. 
Base URL: https://bookiehunt.com/api/v1/public

## Endpoints

### 1. Betting Math & Odds Converter
Endpoint: GET /math/convert-odds
Query Params: ?american=-110
Description: Converts American odds into Decimal, clean Fractional (e.g. -110 -> 10/11), Implied Probability, and the equivalent prediction-market contract price in cents. Requires an integer with magnitude >= 100.
Returns: JSON object with american, decimal, fractional, implied_prob, and prediction_market_cents.

### 2. Sportsbook Promos
Endpoint: GET /promos
Query Params: ?state=OH (Optional)
Description: Returns the highest-converting sportsbook promos available in a specific state.
Returns: JSON object with the state and an array of 'promos' containing affiliate_urls.

### 3. Geo-Compliance
Endpoint: GET /geo
Query Params: ?state=NY
Description: Check if sports betting is legal in a given state.
Returns: JSON object with status, regulated_sportsbooks array, and regulatory_body.

### 4. Bookmaker Trust Score
Endpoint: GET /trust-score
Query Params: ?bookmaker=draftkings
Description: Fetch the proprietary Bookie Hunt Trust Score for any bookmaker.
Returns: JSON object with trust_score (out of 10), status, and payout_speed.

For strict schema definitions, see our OpenAPI spec at: https://bookiehunt.com/openapi.json