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


---

# 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/event-specific-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.