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


---

# 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/broad-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.