> ## 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 snapshot

> Returns the latest lifetime cumulative combo metrics across all of Polymarket (volume, fees, lifecycle operations, leg-count and YES/NO splits), point-in-time gauges (`current.combos_open` and `current.net_yes_shares_outstanding` are approximations — see field docs), and ratios derived at read time (`derived.*`, null on zero denominators).



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/combos/analytics/counts
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/counts:
    get:
      tags:
        - Combos
      summary: Global combo analytics snapshot
      description: >-
        Returns the latest lifetime cumulative combo metrics across all of
        Polymarket (volume, fees, lifecycle operations, leg-count and YES/NO
        splits), point-in-time gauges (`current.combos_open` and
        `current.net_yes_shares_outstanding` are approximations — see field
        docs), and ratios derived at read time (`derived.*`, null on zero
        denominators).
      operationId: get_combo_analytics_counts
      responses:
        '200':
          description: Latest global combo metrics snapshot
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComboGlobalAnalyticsCountsResponse'
components:
  schemas:
    ComboGlobalAnalyticsCountsResponse:
      type: object
      description: |-
        Response body for `GET /polymarket/combos/analytics/counts`: lifetime
        cumulative combo totals plus current gauges and derived ratios.
      required:
        - ts
        - block
        - usd_volume
        - usd_buy_volume
        - usd_sell_volume
        - shares_volume
        - shares_buy_volume
        - shares_sell_volume
        - fees
        - txns
        - buys
        - sells
        - entry_price_usd_weighted_sum
        - builder
        - sides
        - legs
        - lifecycle
        - users
        - combos
        - derived
      properties:
        ts:
          type: integer
          format: int32
          description: Unix-second timestamp of the latest block reflected in the totals.
          minimum: 0
        block:
          type: integer
          format: int64
          description: Latest block reflected in the totals.
          minimum: 0
        usd_volume:
          type: number
          format: double
          description: Lifetime cumulative USD volume across combo fills (buys + sells).
        usd_buy_volume:
          type: number
          format: double
          description: Lifetime cumulative USD buy volume.
        usd_sell_volume:
          type: number
          format: double
          description: Lifetime cumulative USD sell volume.
        shares_volume:
          type: number
          format: double
          description: Lifetime cumulative combo shares volume (buys + sells).
        shares_buy_volume:
          type: number
          format: double
          description: Lifetime cumulative combo shares buy volume.
        shares_sell_volume:
          type: number
          format: double
          description: Lifetime cumulative combo shares sell volume.
        fees:
          type: number
          format: double
          description: Lifetime cumulative fees in USD.
        txns:
          type: integer
          format: int64
          description: Lifetime cumulative combo fill transaction count.
          minimum: 0
        buys:
          type: integer
          format: int64
          description: Lifetime cumulative combo buy fill count.
          minimum: 0
        sells:
          type: integer
          format: int64
          description: Lifetime cumulative combo sell fill count.
          minimum: 0
        entry_price_usd_weighted_sum:
          type: number
          format: double
          description: >-
            Lifetime cumulative sum of entry price x USD size across fills (VWAP
            numerator).
        builder:
          $ref: '#/components/schemas/ComboGlobalAnalyticsBuilder'
          description: Builder-attributed totals.
        sides:
          $ref: '#/components/schemas/ComboGlobalAnalyticsSides'
          description: YES / NO side totals.
        legs:
          $ref: '#/components/schemas/ComboGlobalAnalyticsLegs'
          description: Totals by combo leg count.
        lifecycle:
          $ref: '#/components/schemas/ComboGlobalAnalyticsLifecycle'
          description: Lifecycle operation counts and cash flows.
        users:
          $ref: '#/components/schemas/ComboGlobalAnalyticsUsers'
          description: Trader-acquisition counters.
        combos:
          $ref: '#/components/schemas/ComboGlobalAnalyticsCombos'
          description: Combo market creation / resolution counters.
        current:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ComboGlobalAnalyticsCurrent'
              description: >-
                Point-in-time gauges (approximations; see field docs). `null`
                while no

                gauge snapshot is available yet.
        derived:
          $ref: '#/components/schemas/ComboGlobalAnalyticsDerived'
          description: Ratios derived at read time from the cumulative totals.
    ComboGlobalAnalyticsBuilder:
      type: object
      description: Builder-attributed lifetime combo totals.
      required:
        - builder_fees
        - builder_usd_volume
        - builder_usd_buy_volume
        - builder_usd_sell_volume
        - builder_shares_volume
        - builder_shares_buy_volume
        - builder_shares_sell_volume
        - builder_txns
        - builder_buys
        - builder_sells
      properties:
        builder_fees:
          type: number
          format: double
          description: Lifetime cumulative builder fees in USD.
        builder_usd_volume:
          type: number
          format: double
          description: Lifetime cumulative USD volume on builder-attributed fills.
        builder_usd_buy_volume:
          type: number
          format: double
          description: Lifetime cumulative builder USD buy volume.
        builder_usd_sell_volume:
          type: number
          format: double
          description: Lifetime cumulative builder USD sell volume.
        builder_shares_volume:
          type: number
          format: double
          description: Lifetime cumulative builder combo shares volume.
        builder_shares_buy_volume:
          type: number
          format: double
          description: Lifetime cumulative builder combo shares buy volume.
        builder_shares_sell_volume:
          type: number
          format: double
          description: Lifetime cumulative builder combo shares sell volume.
        builder_txns:
          type: integer
          format: int64
          description: Lifetime cumulative builder combo fill transaction count.
          minimum: 0
        builder_buys:
          type: integer
          format: int64
          description: Lifetime cumulative builder combo buy fill count.
          minimum: 0
        builder_sells:
          type: integer
          format: int64
          description: Lifetime cumulative builder combo sell fill count.
          minimum: 0
    ComboGlobalAnalyticsSides:
      type: object
      description: Lifetime combo totals split by YES / NO side.
      required:
        - yes_usd_volume
        - yes_shares_volume
        - yes_shares_buy_volume
        - yes_shares_sell_volume
        - no_usd_volume
        - no_shares_volume
      properties:
        yes_usd_volume:
          type: number
          format: double
          description: Lifetime cumulative USD volume on the YES side.
        yes_shares_volume:
          type: number
          format: double
          description: Lifetime cumulative YES shares volume (buys + sells).
        yes_shares_buy_volume:
          type: number
          format: double
          description: Lifetime cumulative YES shares buy volume.
        yes_shares_sell_volume:
          type: number
          format: double
          description: Lifetime cumulative YES shares sell volume.
        no_usd_volume:
          type: number
          format: double
          description: Lifetime cumulative USD volume on the NO side.
        no_shares_volume:
          type: number
          format: double
          description: Lifetime cumulative NO shares volume.
    ComboGlobalAnalyticsLegs:
      type: object
      description: Lifetime combo totals by leg count.
      required:
        - legs_2_txns
        - legs_2_usd_volume
        - legs_3_txns
        - legs_3_usd_volume
        - legs_4_txns
        - legs_4_usd_volume
        - legs_5_plus_txns
        - legs_5_plus_usd_volume
      properties:
        legs_2_txns:
          type: integer
          format: int64
          description: Lifetime cumulative fill count on 2-leg combos.
          minimum: 0
        legs_2_usd_volume:
          type: number
          format: double
          description: Lifetime cumulative USD volume on 2-leg combos.
        legs_3_txns:
          type: integer
          format: int64
          description: Lifetime cumulative fill count on 3-leg combos.
          minimum: 0
        legs_3_usd_volume:
          type: number
          format: double
          description: Lifetime cumulative USD volume on 3-leg combos.
        legs_4_txns:
          type: integer
          format: int64
          description: Lifetime cumulative fill count on 4-leg combos.
          minimum: 0
        legs_4_usd_volume:
          type: number
          format: double
          description: Lifetime cumulative USD volume on 4-leg combos.
        legs_5_plus_txns:
          type: integer
          format: int64
          description: Lifetime cumulative fill count on combos with 5+ legs.
          minimum: 0
        legs_5_plus_usd_volume:
          type: number
          format: double
          description: Lifetime cumulative USD volume on combos with 5+ legs.
    ComboGlobalAnalyticsLifecycle:
      type: object
      description: Lifetime combo lifecycle operation counts and cash flows.
      required:
        - creations
        - executions
        - status_updates
        - positions_split
        - positions_merged
        - split_on_condition
        - merged_on_condition
        - extracted
        - injected
        - converted_to_yes_basket
        - merged_from_yes_basket
        - compressed
        - redeemed
        - wrapped
        - unwrapped
        - horizontal_split
        - horizontal_merge
        - position_converted
        - migrated
        - split_collateral_usd
        - merge_collateral_usd
        - redemption_payout_usd
        - compress_collateral_usd
      properties:
        creations:
          type: integer
          format: int64
          description: Lifetime cumulative combo market creations.
          minimum: 0
        executions:
          type: integer
          format: int64
          description: Lifetime cumulative combo executions.
          minimum: 0
        status_updates:
          type: integer
          format: int64
          description: Lifetime cumulative combo status updates.
          minimum: 0
        positions_split:
          type: integer
          format: int64
          description: Lifetime cumulative positions-split lifecycle operations.
          minimum: 0
        positions_merged:
          type: integer
          format: int64
          description: Lifetime cumulative positions-merged lifecycle operations.
          minimum: 0
        split_on_condition:
          type: integer
          format: int64
          description: Lifetime cumulative split-on-condition lifecycle operations.
          minimum: 0
        merged_on_condition:
          type: integer
          format: int64
          description: Lifetime cumulative merge-on-condition lifecycle operations.
          minimum: 0
        extracted:
          type: integer
          format: int64
          description: Lifetime cumulative extract lifecycle operations.
          minimum: 0
        injected:
          type: integer
          format: int64
          description: Lifetime cumulative inject lifecycle operations.
          minimum: 0
        converted_to_yes_basket:
          type: integer
          format: int64
          description: Lifetime cumulative convert-to-YES-basket lifecycle operations.
          minimum: 0
        merged_from_yes_basket:
          type: integer
          format: int64
          description: Lifetime cumulative merge-from-YES-basket lifecycle operations.
          minimum: 0
        compressed:
          type: integer
          format: int64
          description: Lifetime cumulative compress lifecycle operations.
          minimum: 0
        redeemed:
          type: integer
          format: int64
          description: Lifetime cumulative redemption lifecycle operations.
          minimum: 0
        wrapped:
          type: integer
          format: int64
          description: Lifetime cumulative wrap lifecycle operations.
          minimum: 0
        unwrapped:
          type: integer
          format: int64
          description: Lifetime cumulative unwrap lifecycle operations.
          minimum: 0
        horizontal_split:
          type: integer
          format: int64
          description: Lifetime cumulative horizontal-split lifecycle operations.
          minimum: 0
        horizontal_merge:
          type: integer
          format: int64
          description: Lifetime cumulative horizontal-merge lifecycle operations.
          minimum: 0
        position_converted:
          type: integer
          format: int64
          description: Lifetime cumulative position-converted lifecycle operations.
          minimum: 0
        migrated:
          type: integer
          format: int64
          description: Lifetime cumulative migrate lifecycle operations.
          minimum: 0
        split_collateral_usd:
          type: number
          format: double
          description: Lifetime cumulative collateral locked via splits, in USD.
        merge_collateral_usd:
          type: number
          format: double
          description: Lifetime cumulative collateral released via merges, in USD.
        redemption_payout_usd:
          type: number
          format: double
          description: Lifetime cumulative redemption payouts in USD.
        compress_collateral_usd:
          type: number
          format: double
          description: >-
            Lifetime cumulative collateral released via compress operations, in
            USD.
    ComboGlobalAnalyticsUsers:
      type: object
      description: Lifetime combo trader-acquisition counters.
      required:
        - new_combo_traders
        - new_builder_combo_traders
      properties:
        new_combo_traders:
          type: integer
          format: int64
          description: Lifetime cumulative first-time combo traders.
          minimum: 0
        new_builder_combo_traders:
          type: integer
          format: int64
          description: Lifetime cumulative first-time builder-attributed combo traders.
          minimum: 0
    ComboGlobalAnalyticsCombos:
      type: object
      description: Lifetime combo market creation / resolution counters.
      required:
        - combos_created
        - combos_resolved_yes
        - combos_resolved_no
      properties:
        combos_created:
          type: integer
          format: int64
          description: Lifetime cumulative combo markets created.
          minimum: 0
        combos_resolved_yes:
          type: integer
          format: int64
          description: Lifetime cumulative combos resolved YES.
          minimum: 0
        combos_resolved_no:
          type: integer
          format: int64
          description: Lifetime cumulative combos resolved NO.
          minimum: 0
    ComboGlobalAnalyticsCurrent:
      type: object
      description: Point-in-time gauges reflecting the most recent combo activity.
      required:
        - ts
        - block
        - combos_open
        - net_yes_shares_outstanding
      properties:
        ts:
          type: integer
          format: int32
          description: Unix-second timestamp of the gauge snapshot.
          minimum: 0
        block:
          type: integer
          format: int64
          description: Block the gauge snapshot was computed at.
          minimum: 0
        combos_open:
          type: integer
          format: int64
          description: >-
            Approximate combos currently open: `combos_created -
            combos_resolved_yes

            - combos_resolved_no`. Expired-but-unresolved combos are still
            counted

            as open, and the value can go negative when resolutions land for
            combos

            created before indexing coverage begins.
        net_yes_shares_outstanding:
          type: number
          format: double
          description: >-
            Approximate net YES shares outstanding: cumulative YES shares bought
            -

            YES shares sold - redeemed shares. Ignores share movements from

            splits/merges/transforms and any activity before indexing coverage

            begins.
    ComboGlobalAnalyticsDerived:
      type: object
      description: |-
        Ratios derived at read time from the lifetime cumulative snapshot.
        Every field is `null` when its denominator is zero.
      properties:
        avg_parlay_odds:
          type:
            - number
            - 'null'
          format: double
          description: >-
            Average parlay odds proxy: `shares_volume / usd_volume` (shares
            bought

            per dollar, i.e. the inverse of the average combo entry price).
        vwap_entry_price:
          type:
            - number
            - 'null'
          format: double
          description: |-
            USD-volume-weighted average combo entry price:
            `entry_price_usd_weighted_sum / usd_volume`.
        hit_rate:
          type:
            - number
            - 'null'
          format: double
          description: |-
            Share of resolved combos that resolved YES:
            `combos_resolved_yes / (combos_resolved_yes + combos_resolved_no)`.
        payout_ratio:
          type:
            - number
            - 'null'
          format: double
          description: |-
            Redemption payouts relative to USD volume:
            `redemption_payout_usd / usd_volume`.
        builder_share_of_volume:
          type:
            - number
            - 'null'
          format: double
          description: >-
            Builder-attributed share of USD volume: `builder_usd_volume /
            usd_volume`.

````