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

# 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.md) 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"
      }
    }
  ]
}
```


---

# 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/live-market-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.
