> 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/event-specific-widgets.md).

# Event-Specific Widgets

### Event-Specific Widgets (Contextual Conversion Layer)

#### Deep-Dive Overview

Event-Specific Widgets are laser-focused on single, distinct real-world contracts or topics. Instead of relying on general brand affinity, these widgets map directly to the context of the surrounding editorial content.

When an editor writes an article about a political conflict, an interest rate decision, or a tournament finale, this widget parses that precise topic and builds a real-time comparison module displaying the exact live odds across multiple operators. This context matching creates a seamless user journey from reading news to taking an immediate marketplace position.

#### Primary Conversion Mechanics

* Probability-to-Odds Translation: Displays live market probabilities as clear, visual percentages (e.g., "Michigan wins the 2026 NCAA Tournament: 40%") alongside the raw operator contract prices (e.g., Kalshi 17¢ vs Polymarket 22¢).
* Arbitrage/Best-Odds Badging: Automatically flags which provider currently offers the most favorable price for a given outcome, maximizing click-through incentive.
* Deep Linking: Bypasses general sign-up flows and routes the user directly to the specific contract page inside the operator's app or website.

#### Target Audiences & Use Cases

* Niche News & Geopolitical Blogs: Embedding real-time contract odds inside investigative reporting or breaking news updates (e.g., "Iran War" risk markets).
* NCAA, Entertainment, and Current Events Channels: Perfect for capturing hyper-focused fan engagement during ongoing live tournaments.

#### 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/event`

**Request Parameters**

| **Parameter**    | **Type** | **Required** | **Description**                                                      |
| ---------------- | -------- | ------------ | -------------------------------------------------------------------- |
| `slug`           | string   | Yes          | Unique text identifier for the mapped real-world event.              |
| `display_format` | string   | No           | Sets odds format representation (`cents`, `implied_pct`, `decimal`). |

**Detailed JSON Response Schema**

JSON

```json
{
  "widget_class": "event-specific",
  "event_slug": "2026-ncaab-tournament-winner",
  "event_question": "2026 NCAAB Tournament Winner?",
  "last_verified_timestamp": "2026-06-01T16:21:00Z",
  "outcomes": [
    {
      "outcome_name": "Michigan wins the 2026 NCAA Tournament",
      "aggregated_probability_pct": 40,
      "market_depth_volume": "$48.4K",
      "comparison_pool": [
        {
          "operator_id": "kalshi_regulated",
          "operator_name": "Kalshi",
          "contract_price": "17¢",
          "contract_volume": "$10K",
          "is_best_odds": false,
          "deep_link": "https://engine.gemified.com/click?event=ncaab_mich&op=kalshi"
        },
        {
          "operator_id": "polymarket_crypto",
          "operator_name": "Polymarket",
          "contract_price": "22¢",
          "contract_volume": "$38.4K",
          "is_best_odds": true,
          "promo_applied": "POLYCOVERS",
          "deep_link": "https://engine.gemified.com/click?event=ncaab_mich&op=poly"
        }
      ]
    },
    {
      "outcome_name": "Arizona wins the 2026 NCAA Tournament",
      "aggregated_probability_pct": 38,
      "market_depth_volume": "$41.3K",
      "comparison_pool": [
        {
          "operator_id": "kalshi_regulated",
          "operator_name": "Kalshi",
          "contract_price": "15¢",
          "contract_volume": "$40K",
          "is_best_odds": true,
          "deep_link": "https://engine.gemified.com/click?event=ncaab_ariz&op=kalshi"
        },
        {
          "operator_id": "polymarket_crypto",
          "operator_name": "Polymarket",
          "contract_price": "13¢",
          "contract_volume": "$1.3K",
          "is_best_odds": false,
          "deep_link": "https://engine.gemified.com/click?event=ncaab_ariz&op=poly"
        }
      ]
    }
  ]
}
```