> 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"
        }
      }
    ]
  }
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gemified.net/for-advertisers/markdown/sportsbook-widgets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.