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

# Broad Widgets

### Broad Widgets (Market Discovery Engine)

#### Deep-Dive Overview

Broad Widgets are designed as high-traffic discovery layers. They do not focus on a single event; instead, they act as an algorithmic aggregator that showcases the top-performing prediction markets, high-volume operators, and trending consumer sentiments globally.

The primary engineering challenge this widget solves is dynamic localized monetization. Because prediction market regulations vary significantly by country and territory, the Broad Widget automatically inspects the user’s incoming IP address, matches it against geo-compliance routing tables, and surfaces only valid, actionable operator platforms to the end-user.

#### Primary Conversion Mechanics

* Dynamic Geolocation Routing: Instantly filters out non-compliant operators. For instance, a US-based user is automatically shown regulated alternatives like Kalshi or FanDuel, while an international user may surface heavy crypto-centric pools like Polymarket.
* Algorithmic "Top 10" Sorting: Surfaces trending markets based on a blended score of 24-hour trading volume, rapid open-interest acceleration, and cross-platform click-through rates.
* Sign-Up Incentivization: Aggregates and injects real-time localized promotional codes (e.g., "$50 Deposit Match") alongside the market data to maximize immediate conversion behavior.

#### Target Audiences & Use Cases

* Financial & Crypto News Portals: Perfect for homepages or general market overview feeds where users look for general macroeconomic trends.
* General Media & Lifestyle Layouts: Captures broad internet traffic by showing what the world is betting on in real-time (e.g., Pop culture, political cycles, global tech trends).

#### API Reference & Payload Specification

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

**Endpoint**

`GET /v1/widgets/broad`

**Request Parameters**

| **Parameter**  | **Type** | **Required** | **Description**                                          |
| -------------- | -------- | ------------ | -------------------------------------------------------- |
| `limit`        | integer  | No           | Number of top brands/markets to return. Default is `10`. |
| `fallback_geo` | string   | No           | ISO 2-letter country code used if IP lookup fails.       |
| `currency`     | string   | No           | Preferred currency display code (e.g., `USD`, `EUR`).    |

**Detailed JSON Response Schema**

JSON

```json
{
  "widget_class": "broad",
  "resolved_geo": "US",
  "timestamp": "2026-06-01T16:20:00Z",
  "trending_summary": {
    "global_24h_volume": "$84.87M",
    "highest_volume_category": "Macroeconomics"
  },
  "operators": [
    {
      "rank": 1,
      "operator_name": "Polymarket",
      "rating": "4.6/5",
      "metrics": {
        "volume_24h": "$84.87M",
        "avg_value_per_event": "$224.89M",
        "total_liquidity": "$308.55M"
      },
      "incentives": {
        "promo_text": "$50 Deposit Match",
        "promo_code": "GEM50",
        "cta_label": "Claim Now"
      },
      "routing": {
        "web_url": "https://engine.gemified.com/click?partner=123&op=poly",
        "app_store_available": ["iOS", "Google Play"]
      }
    },
    {
      "rank": 2,
      "operator_name": "Kalshi",
      "rating": "4.3/5",
      "metrics": {
        "volume_24h": "$42.10M",
        "avg_value_per_event": "$115.30M",
        "total_liquidity": "$140.00M"
      },
      "incentives": {
        "promo_text": "Risk-Free First Bet up to $100",
        "promo_code": "KALSHIGEM",
        "cta_label": "Claim $100"
      },
      "routing": {
        "web_url": "https://engine.gemified.com/click?partner=123&op=kalshi",
        "app_store_available": ["Google Play"]
      }
    }
  ]
}
```