# Welcome to Gemified Gemified closes the loop between tracking and engagement by transforming live prediction market data into embeddable, actionable widgets. We help publishers monetize traffic by surfacing "Top 10" brands, trending markets, and real-time odds for specific topics like economic shifts or sports events. Key Benefits: * Localized Experience: Brand recommendations based on user geography. * High-Frequency Data: Support for emerging 5–15 minute crypto events. * Optimized EPC: Leveraging interest-based targeting to drive superior Earnings Per Click (EPC). # Quickstart Get your first prediction market widget live in under 5 minutes. To start fetching live data, follow these three steps: 1. Log in to the [Gemified Advertiser Dashboard](https://publisher.gemified.io/) to retrieve your Advertiser ID and API Key.\ *(Gemified should provide you with credentials).* 2. Choose Your Endpoint: Decide if you need a "Broad" market overview or "Event-Specific" data. 3. Make a Request: Use your API Key in the request header to fetch the latest odds and promo codes. # Onboarding How to set up your account and access the Gemified API. To join our network of publishers and access our unique integration stack, follow the onboarding flow: #### Step 1: Account Setup Visit [publisher.gemified.io](https://publisher.gemified.io) and fill out the "Welcome to Gemified" form with your company details, legal entity, and communication source (e.g., Telegram handle). #### Step 2: Retrieve API Credentials 1. Navigate to the Publisher Details section in your dashboard. 2. Click on the API tab. 3. Click Generate API Key. 4. Copy your Advertiser ID and your new API Key. *Keep these secure as they grant access to your account data.* #### Step 3: Integration Use these credentials as headers (`x-advertiser-id` and `x-api-key`) in your GET requests to populate your widgets with real-time operator data and sign-up promos. # Widget Types & Capabilities Understand the different ways to display prediction market data. We offer three primary data structures to fit your content's context: * Broad Widgets: Automatically surface "Top 10" brands or trending markets based on high engagement and volume data. Ideal for homepage sidebars. * Event-Specific Widgets: Filter the prediction market to show real-time odds for a specific topic, such as "2028 Democratic Nominee" or "2026 NCAAB Tournament Winner". * Sportsbook / Comparison: Compare live odds across specific games to highlight 'Best Odds' and unique operator market positions. You can find more information on each widget type and their use in their respective pages. # 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) 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"] } } ] } ``` # 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) 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" } ] } ] } ``` # Sportsbook Widgets ### Sportsbook Widgets (Odds Comparison Engine) #### Deep-Dive Overview The Sportsbook Widget bridges traditional athletic betting data structure with bleeding-edge prediction market liquidity. It processes standard athletic structures—such as point spreads, point totals (Over/Under), and classic Moneylines (ML)—and matches them cleanly across legacy books and decentralized prediction layers side-by-side. This widget solves the data-fragmentation problem for sports bettors. Rather than checking multiple standalone apps, users can view a single live ledger that immediately reveals which operator holds the optimal line configuration and highest payout potential for an active matchup. #### Primary Conversion Mechanics * Multi-Book Consolidation: Pulls real-time odds data simultaneously across decentralized environments (e.g., Polymarket) and traditional major bookmakers (e.g., FanDuel). * Spread and Total Line Shifting: Updates changes instantly to reflect exact point movements (e.g., tracking a +5.5 line vs a -5.5 line across different platforms). * Historical Trends Overlay: Displays team performance indicators directly under the selector (e.g., "Against the Spread" \[ATS] ratios and Over/Under \[O/U] splits) to drive high-intent, data-backed clicks. #### Target Audiences & Use Cases * Sports Media & Tipster Apps: Replaces outdated static odds tables with actionable, revenue-generating, real-time widgets. * Live Score Trackers: Embeds directly into active match summary layouts where user attention is concentrated at its highest peak. #### API Reference & Payload Specification {% hint style="info" %} Refer [here](/widgets-api-reference/fetch-event-specific-data) for the full endpoint details reference. {% endhint %} **Endpoint** `GET /v1/widgets/sportsbook` **Request Parameters** | **Parameter** | **Type** | **Required** | **Description** | | -------------- | -------- | ------------ | ------------------------------------------------------------------- | | `league` | string | Yes | Targeted sports organization filter (`NCAAB`, `NBA`, `NFL`, `EPL`). | | `team_context` | string | No | Search query parameter to isolate a specific school or team. | **Detailed JSON Response Schema** JSON ```json { "widget_class": "sportsbook", "league": "NCAAB", "match_meta": { "event_id": "usf-vs-lou-2026", "scheduled_time": "2026-03-19T17:30:00Z", "status": "UPCOMING", "matchup": "South Florida Bulls vs Louisville Cardinals" }, "team_analytics": { "usf_record": "25-8", "lou_record": "23-10", "usf_ats_ou": { "ats": "18-14-0", "ou": "14-18-0" } }, "odds_matrix": { "operators": [ { "name": "Polymarket", "capabilities": ["PRO_LIQUIDITY"], "lines": { "away_spread": { "line": "+5.5", "odds": "-110" }, "home_spread": { "line": "-5.5", "odds": "-110" }, "total_over": { "line": "165.5", "odds": "-115" }, "total_under": { "line": "165.5", "odds": "-115" }, "away_moneyline": "+180", "home_moneyline": "-250" } } ] } } ``` # Live-Market Widgets ### Live-Market Widgets (Micro-Horizon Engagement Engine) #### Deep-Dive Overview Live-Market Widgets cater to a fast-paced class of prediction consumer: the high-frequency micro-speculator. These widgets specialize exclusively in low-latency, rapid-expiration contracts that cycle sequentially every 5 to 15 minutes. This infrastructure handles real-time assets, primarily centered around high-frequency cryptocurrency volatility (e.g., tracking automated boundary binary options: *"Will Bitcoin be above or below $71,402.35 in the next 5 minutes?"*). The engineering infrastructure behind this component requires a constant websocket streaming layer to continuously recalculate changing target strikes, minute price spreads, and immediate multiplication payouts. #### Primary Conversion Mechanics * Hyper-Immediate Call-to-Actions: Capitalizes on short-term market momentum and user FOMO by showing live count-down structures. * Leveraged Payout Mutators: Displays fluctuating directional multipliers (e.g., "Payout Up: x2.6" vs "Payout Down: x3.2") that update continuously as raw spot price values shift. * Micro-Coupon Optimization: Injects sudden flash coupons (e.g., "$10 Flash Coupon") directly inside the container to lower transaction friction and prompt immediate sign-ups. #### Target Audiences & Use Cases * Crypto Day-Trading Analytics Platforms: Integrates directly alongside live candlestick charts and token pricing tools. * Alpha-Group Communities & Discord/Telegram Hubs: Provides highly active, gamified engagement loops for speculative trading audiences. #### API Reference & Payload Specification {% hint style="info" %} Refer [here](/widgets-api-reference/fetch-all-active-events) for the full endpoint details reference. {% endhint %} **Endpoint** `GET /v1/widgets/live-market` **Request Parameters** | **Parameter** | **Type** | **Required** | **Description** | | ----------------- | -------- | ------------ | ------------------------------------------------------------------------------- | | `asset` | string | No | Filter by active underlying asset code (`BTC`, `ETH`, `SOL`). Default is `BTC`. | | `horizon_minutes` | integer | No | Interval range constraint (`5`, `15`). Default is `5`. | **Detailed JSON Response Schema** JSON ```json { "widget_class": "live-market", "refresh_interval_seconds": 2, "underlying_asset": "BTC", "active_micro_question": "WILL BITCOIN BE ABOVE OR BELOW $71,402.35?", "expiration_horizon": "5 minutes", "providers_pool": [ { "operator_name": "Polymarket", "is_best_odds": true, "live_metrics": { "spot_difference": "$501.56", "target_price": "$71,903.91", "multipliers": { "payout_up": "x2.6", "payout_down": "x3.2" } }, "incentives": { "coupon_value": "$10 Coupon", "cta_url": "https://engine.gemified.com/click?type=micro&op=poly" } }, { "operator_name": "Kalshi", "is_best_odds": false, "live_metrics": { "spot_difference": "$472.07", "target_price": "$71,874.42", "multipliers": { "payout_up": "x2.1", "payout_down": "x2.9" } }, "incentives": { "coupon_value": "$10 Coupon", "cta_url": "https://engine.gemified.com/click?type=micro&op=kalshi" } } ] } ``` # Breaking News & Macro Feeds ### Programmatic Contextual Matching for Breaking News & Macro Feeds #### **The Concept** Large-scale publishers manage thousands of dynamically updating news pages across finance, politics, current events, and tech. Manually selecting and inserting affiliate links for individual stories is completely unscalable. Traditional static display banners suffer from extreme banner blindness, but prediction markets represent a highly contextual, data-driven alternative that engages users directly within the editorial flow. **How It Is Implemented Exactly Using Gemified** * The Integration: The publisher's engineering team embeds Gemified’s lightweight, asynchronous JavaScript snippet directly into their master Content Management System (CMS) article template. This ensures the script is deployed across all current and future news pages with zero manual oversight required from writers. * The Underlying Architecture: When a reader opens a news article, the frontend code executes and parses the page's metadata, semantic tags, or URL slugs. It feeds this context to the Gemified API via the `GET /v1/widgets/event` endpoint. * The Delivery: Our matching engine processes the topic payload in real-time and dynamically injects an Event-Specific Widget inside the body of the article. If an editor publishes a breaking story on federal interest rate cuts, macroeconomics, or geopolitical shifts, the widget displays live public probabilities (e.g., "Michigan wins the 2026 NCAA Tournament: 40%") alongside real-time operator deep links. The user can transition seamlessly from consumption to market execution with a single click. # Decentralized vs. Traditional Odds in Sports ### Enhancing Sports Portals with Decentralized vs. Traditional Odds Arbitrage #### **The Concept** For top-tier iGaming affiliate networks that drive high-volume sports traffic, user retention and conversion depend on providing unique, data-backed value that traditional legacy betting sites miss. Modern sports bettors demand transparency and are constantly hunting for the maximum possible payout lines across fragmented global markets. **How It Is Implemented Exactly Using Gemified** * The Integration: The publisher integrates Gemified’s Sportsbook Widget directly into high-traffic infrastructure assets like live scoreboards, match preview columns, and expert betting tipster feeds. * The Underlying Architecture: The component utilizes a continuous backend connection to the `GET /v1/widgets/sportsbook` endpoint, filtered by the specific organization league (e.g., `league=NCAAB`). This endpoint simultaneously aggregates data feeds from legacy web sportsbooks (such as FanDuel) and modern decentralized prediction layers (such as Polymarket). * The Delivery: The widget renders a live, interactive data matrix comparing point spreads, totals, and moneyline splits side-by-side. Gemified's internal logic automatically evaluates the pricing differentials across platforms and overlays a "Best Odds" badge on the optimal line position. By displaying team historical trend data (such as "Against the Spread" ratios) right inside the container, it prompts data-driven users to click through the affiliate-tracked link immediately. # PredictionMarkets Geo Targeting ### Automated IP-Geo Routing for Multi-Jurisdictional Traffic Hubs #### **The Concept** Global media networks attract massive baseline traffic but struggle to efficiently monetize it because of fragmented gambling, betting, and prediction regulations across the US, UK, EU, and Latin America. Sending a user to an operator platform where they cannot legally open an account destroys user trust and wastes valuable marketing spend. Publishers need a hands-off system that handles regulatory compliance automatically at scale. **How It Is Implemented Exactly Using Gemified** * The Integration: The publisher deploys a Gemified Broad Widget into permanent global real estate blocks on their network domains, such as the site-wide sidebar, sticky footer banners, or primary homepage discovery dashboards. * The Underlying Architecture: The moment a user accesses the page, Gemified’s global infrastructure captures the incoming request and analyzes the user’s IP address to run an immediate geographic and compliance lookup before anything is drawn on the screen. * The Delivery: The client browser calls `GET /v1/widgets/broad`, and our engine dynamically renders an optimized operator list tailored explicitly to that user's local jurisdiction. A visitor routing from a location with access to decentralized platforms will see high-liquidity crypto operators like Polymarket. If a visitor hits the exact same URL from a strictly regulated US state, the widget dynamically swaps the layout to surface fully compliant domestic alternatives like Kalshi, complete with working, localized promotional codes and sign-up incentives. # Fetch Event Specific Data ## GET /advertiser/v1/widgets/specific/{event\_slug} > Get Specific Prediction Market Data ```json {"openapi":"3.0.0","info":{"title":"Gemified Advertiser API","version":"1.0.0"},"servers":[{"url":"https://api.gemified.io"}],"paths":{"/advertiser/v1/widgets/specific/{event_slug}":{"get":{"tags":["Fetch Event Specific Data"],"summary":"Get Specific Prediction Market Data","parameters":[{"name":"event_slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-advertiser-id","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response with detailed event outcomes","content":{"application/json":{}}}}}}}} ``` # Fetch Broad Events Data ## GET /advertiser/v1/widgets/broad > Get Broad Market Overview ```json {"openapi":"3.0.0","info":{"title":"Gemified Advertiser API","version":"1.0.0"},"servers":[{"url":"https://api.gemified.io"}],"paths":{"/advertiser/v1/widgets/broad":{"get":{"tags":["Fetch Broad Events Data"],"summary":"Get Broad Market Overview","parameters":[{"name":"x-advertiser-id","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response with global market stats","content":{"application/json":{}}}}}}}} ``` # Fetch All Active Events ## GET /advertiser/v1/widgets/events > List All Available Events ```json {"openapi":"3.0.0","info":{"title":"Gemified Advertiser API","version":"1.0.0"},"servers":[{"url":"https://api.gemified.io"}],"paths":{"/advertiser/v1/widgets/events":{"get":{"tags":["Fetch All Active Events"],"summary":"List All Available Events","parameters":[{"name":"x-advertiser-id","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response with list of event slugs","content":{"application/json":{}}}}}}}} ```