> For the complete documentation index, see [llms.txt](https://docs.gemified.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gemified.net/for-advertisers/markdown/sportsbook-widgets.md).

# Sportsbook Widgets

### Sportsbook Widgets (Odds Comparison Engine)

#### Deep-Dive Overview

The Sportsbook Widget bridges traditional athletic betting data structure with bleeding-edge prediction market liquidity. It processes standard athletic structures—such as point spreads, point totals (Over/Under), and classic Moneylines (ML)—and matches them cleanly across legacy books and decentralized prediction layers side-by-side.

This widget solves the data-fragmentation problem for sports bettors. Rather than checking multiple standalone apps, users can view a single live ledger that immediately reveals which operator holds the optimal line configuration and highest payout potential for an active matchup.

#### Primary Conversion Mechanics

* Multi-Book Consolidation: Pulls real-time odds data simultaneously across decentralized environments (e.g., Polymarket) and traditional major bookmakers (e.g., FanDuel).
* Spread and Total Line Shifting: Updates changes instantly to reflect exact point movements (e.g., tracking a +5.5 line vs a -5.5 line across different platforms).
* Historical Trends Overlay: Displays team performance indicators directly under the selector (e.g., "Against the Spread" \[ATS] ratios and Over/Under \[O/U] splits) to drive high-intent, data-backed clicks.

#### Target Audiences & Use Cases

* Sports Media & Tipster Apps: Replaces outdated static odds tables with actionable, revenue-generating, real-time widgets.
* Live Score Trackers: Embeds directly into active match summary layouts where user attention is concentrated at its highest peak.

#### API Reference & Payload Specification

{% hint style="info" %}
Refer [here](/widgets-api-reference/fetch-event-specific-data.md) for the full endpoint details reference.
{% endhint %}

**Endpoint**

`GET /v1/widgets/sportsbook`

**Request Parameters**

| **Parameter**  | **Type** | **Required** | **Description**                                                     |
| -------------- | -------- | ------------ | ------------------------------------------------------------------- |
| `league`       | string   | Yes          | Targeted sports organization filter (`NCAAB`, `NBA`, `NFL`, `EPL`). |
| `team_context` | string   | No           | Search query parameter to isolate a specific school or team.        |

**Detailed JSON Response Schema**

JSON

```json
{
  "widget_class": "sportsbook",
  "league": "NCAAB",
  "match_meta": {
    "event_id": "usf-vs-lou-2026",
    "scheduled_time": "2026-03-19T17:30:00Z",
    "status": "UPCOMING",
    "matchup": "South Florida Bulls vs Louisville Cardinals"
  },
  "team_analytics": {
    "usf_record": "25-8",
    "lou_record": "23-10",
    "usf_ats_ou": { "ats": "18-14-0", "ou": "14-18-0" }
  },
  "odds_matrix": {
    "operators": [
      {
        "name": "Polymarket",
        "capabilities": ["PRO_LIQUIDITY"],
        "lines": {
          "away_spread": { "line": "+5.5", "odds": "-110" },
          "home_spread": { "line": "-5.5", "odds": "-110" },
          "total_over": { "line": "165.5", "odds": "-115" },
          "total_under": { "line": "165.5", "odds": "-115" },
          "away_moneyline": "+180",
          "home_moneyline": "-250"
        }
      }
    ]
  }
}
```