> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Global combo analytics pct change

> Returns % change for each combo metric over the requested lookback window (two cumulative snapshots). Ratio metrics ship as `*_now`/`*_prev` value pairs; `unique_traders` / `distinct_combos_traded` compare window-unique counts of the current vs previous window. `null` fields mean the window predates the available data.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/combos/analytics/changes
openapi: 3.1.0
info:
  title: Polymarket API
  description: >-
    RESTful API for querying Polymarket prediction markets data including
    events, markets, traders, holders, and real-time metrics
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.struct.to/v1
security: []
paths:
  /polymarket/combos/analytics/changes:
    get:
      tags:
        - Combos
      summary: Global combo analytics pct change
      description: >-
        Returns % change for each combo metric over the requested lookback
        window (two cumulative snapshots). Ratio metrics ship as
        `*_now`/`*_prev` value pairs; `unique_traders` /
        `distinct_combos_traded` compare window-unique counts of the current vs
        previous window. `null` fields mean the window predates the available
        data.
      operationId: get_combo_analytics_changes
      parameters:
        - name: timeframe
          in: query
          description: 'Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h)'
          required: false
          schema:
            $ref: '#/components/schemas/AnalyticsChangeTimeframe'
      responses:
        '200':
          description: Per-metric combo pct change
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComboGlobalAnalyticsChanges'
components:
  schemas:
    AnalyticsChangeTimeframe:
      type: string
      description: Lookback window for `/analytics/changes` endpoints.
      enum:
        - 1h
        - 24h
        - 7d
        - 30d
        - 1mo
        - 1y
    ComboGlobalAnalyticsChanges:
      type: object
      description: >-
        Response body for `GET /polymarket/combos/analytics/changes`: per-metric
        %

        change over the requested lookback window. `null` fields mean the window

        predates the available data or the previous value was zero. Ratio
        metrics

        ship as `*_now` / `*_prev` value pairs instead of a % change.
      properties:
        usd_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD volume across combo fills (buys + sells).
        usd_buy_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD buy volume.
        usd_sell_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD sell volume.
        shares_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo shares volume (buys + sells).
        shares_buy_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo shares buy volume.
        shares_sell_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo shares sell volume.
        fees:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of fees in USD.
        builder_fees:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder fees in USD.
        builder_usd_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD volume on builder-attributed fills.
        builder_usd_buy_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder USD buy volume.
        builder_usd_sell_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder USD sell volume.
        builder_shares_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder combo shares volume.
        builder_shares_buy_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder combo shares buy volume.
        builder_shares_sell_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder combo shares sell volume.
        txns:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo fill transaction count.
        buys:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo buy fill count.
        sells:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo sell fill count.
        builder_txns:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder combo fill transaction count.
        builder_buys:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder combo buy fill count.
        builder_sells:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of builder combo sell fill count.
        creations:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo market creations.
        executions:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo executions.
        status_updates:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo status updates.
        positions_split:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of positions-split lifecycle operations.
        positions_merged:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of positions-merged lifecycle operations.
        split_on_condition:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of split-on-condition lifecycle operations.
        merged_on_condition:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of merge-on-condition lifecycle operations.
        extracted:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of extract lifecycle operations.
        injected:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of inject lifecycle operations.
        converted_to_yes_basket:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of convert-to-YES-basket lifecycle operations.
        merged_from_yes_basket:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of merge-from-YES-basket lifecycle operations.
        compressed:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of compress lifecycle operations.
        redeemed:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of redemption lifecycle operations.
        wrapped:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of wrap lifecycle operations.
        unwrapped:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of unwrap lifecycle operations.
        horizontal_split:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of horizontal-split lifecycle operations.
        horizontal_merge:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of horizontal-merge lifecycle operations.
        position_converted:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of position-converted lifecycle operations.
        migrated:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of migrate lifecycle operations.
        yes_usd_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD volume on the YES side.
        yes_shares_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of YES shares volume (buys + sells).
        yes_shares_buy_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of YES shares buy volume.
        yes_shares_sell_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of YES shares sell volume.
        no_usd_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD volume on the NO side.
        no_shares_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of NO shares volume.
        legs_2_txns:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of fill count on 2-leg combos.
        legs_2_usd_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD volume on 2-leg combos.
        legs_3_txns:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of fill count on 3-leg combos.
        legs_3_usd_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD volume on 3-leg combos.
        legs_4_txns:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of fill count on 4-leg combos.
        legs_4_usd_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD volume on 4-leg combos.
        legs_5_plus_txns:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of fill count on combos with 5+ legs.
        legs_5_plus_usd_volume:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of USD volume on combos with 5+ legs.
        split_collateral_usd:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of collateral locked via splits, in USD.
        merge_collateral_usd:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of collateral released via merges, in USD.
        redemption_payout_usd:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of redemption payouts in USD.
        compress_collateral_usd:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of collateral released via compress operations, in USD.
        combos_created:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combo markets created.
        combos_resolved_yes:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combos resolved YES.
        combos_resolved_no:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of combos resolved NO.
        new_combo_traders:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of first-time combo traders.
        new_builder_combo_traders:
          type:
            - number
            - 'null'
          format: double
          description: Pct change of first-time builder-attributed combo traders.
        unique_traders:
          type:
            - number
            - 'null'
          format: double
          description: >-
            Pct change of window-unique combo traders (current window vs
            previous

            window of the same length).
        distinct_combos_traded:
          type:
            - number
            - 'null'
          format: double
          description: >-
            Pct change of window-unique combos traded (current window vs
            previous

            window of the same length).
        avg_parlay_odds_now:
          type:
            - number
            - 'null'
          format: double
          description: >-
            Current lifetime `shares_volume / usd_volume` (average parlay odds
            proxy).
        avg_parlay_odds_prev:
          type:
            - number
            - 'null'
          format: double
          description: Same ratio at the start of the window.
        vwap_entry_price_now:
          type:
            - number
            - 'null'
          format: double
          description: Current lifetime USD-volume-weighted average combo entry price.
        vwap_entry_price_prev:
          type:
            - number
            - 'null'
          format: double
          description: Same ratio at the start of the window.
        hit_rate_now:
          type:
            - number
            - 'null'
          format: double
          description: >-
            Current lifetime `combos_resolved_yes / (combos_resolved_yes +
            combos_resolved_no)`.
        hit_rate_prev:
          type:
            - number
            - 'null'
          format: double
          description: Same ratio at the start of the window.
        payout_ratio_now:
          type:
            - number
            - 'null'
          format: double
          description: Current lifetime `redemption_payout_usd / usd_volume`.
        payout_ratio_prev:
          type:
            - number
            - 'null'
          format: double
          description: Same ratio at the start of the window.
        builder_share_of_volume_now:
          type:
            - number
            - 'null'
          format: double
          description: Current lifetime `builder_usd_volume / usd_volume`.
        builder_share_of_volume_prev:
          type:
            - number
            - 'null'
          format: double
          description: Same ratio at the start of the window.

````