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

Refer here for the full endpoint details reference.

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

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