> ## 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 candles (per-bucket deltas)

> Returns per-bucket combo deltas (volume, fees, lifecycle operations that happened *during* each bucket) plus window-unique `unique_traders` / `distinct_combos_traded`. Use for bar-chart visualisations of combo activity over time.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/combos/analytics/deltas
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/deltas:
    get:
      tags:
        - Combos
      summary: Global combo analytics candles (per-bucket deltas)
      description: >-
        Returns per-bucket combo deltas (volume, fees, lifecycle operations that
        happened *during* each bucket) plus window-unique `unique_traders` /
        `distinct_combos_traded`. Use for bar-chart visualisations of combo
        activity over time.
      operationId: get_combo_analytics_deltas
      parameters:
        - name: resolution
          in: query
          description: 'Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60)'
          required: false
          schema:
            $ref: '#/components/schemas/AnalyticsResolution'
        - name: from
          in: query
          description: Start timestamp (Unix seconds). Omit for all-time.
          required: false
          schema:
            type: integer
            format: int64
        - name: to
          in: query
          description: End timestamp (Unix seconds)
          required: false
          schema:
            type: integer
            format: int64
        - name: count_back
          in: query
          description: 'Max data points (default: 500, max: 2500)'
          required: false
          schema:
            type: integer
            format: int32
        - name: pagination_key
          in: query
          description: Cursor from previous response for next page
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Delta time-bucketed combo analytics
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ComboGlobalAnalyticsDeltaBucketRow'
components:
  schemas:
    AnalyticsResolution:
      type: string
      description: >-
        Bucket size for `/analytics/timeseries` and `/analytics/deltas`
        responses.

        Each value picks the time interval that one row in the output covers:

        `60` = 1 hour, `240` = 4 hours, `D`/`1D` = 1 day, `W`/`1W` = 7 days,

        `M`/`1M` = calendar month.
      enum:
        - '60'
        - '240'
        - D
        - 1D
        - W
        - 1W
        - M
        - 1M
    ComboGlobalAnalyticsDeltaBucketRow:
      type: object
      description: |-
        Bucket row for `GET /polymarket/combos/analytics/deltas`: combo activity
        that happened *during* each bucket, plus the number of distinct traders
        and distinct combos active within the bucket.
      required:
        - t
        - v
        - bv
        - sv
        - sh
        - bsh
        - ssh
        - f
        - bf
        - buv
        - bubv
        - busv
        - bsv
        - bsbv
        - bssv
        - tc
        - bc
        - sc
        - btc
        - bbc
        - bsc
        - cre
        - exe
        - su
        - ps
        - pm
        - soc
        - moc
        - ext
        - inj
        - ctyb
        - mfyb
        - cmp
        - red
        - wr
        - uw
        - hs
        - hm
        - pc
        - mig
        - yv
        - ysh
        - ybsh
        - yssh
        - nv
        - nsh
        - l2t
        - l2v
        - l3t
        - l3v
        - l4t
        - l4v
        - l5t
        - l5v
        - epw
        - scu
        - mcu
        - rpu
        - ccu
        - ccr
        - cry
        - crn
        - nct
        - nbct
        - ut
        - dct
      properties:
        t:
          type: integer
          format: int32
          description: 'Full field: `bucket`. Bucket start time as Unix seconds.'
          minimum: 0
        v:
          type: number
          format: double
          description: >-
            Full field: `usd_volume`. Per-bucket USD volume across combo fills
            (buys + sells).
        bv:
          type: number
          format: double
          description: 'Full field: `usd_buy_volume`. Per-bucket USD buy volume.'
        sv:
          type: number
          format: double
          description: 'Full field: `usd_sell_volume`. Per-bucket USD sell volume.'
        sh:
          type: number
          format: double
          description: >-
            Full field: `shares_volume`. Per-bucket combo shares volume (buys +
            sells).
        bsh:
          type: number
          format: double
          description: 'Full field: `shares_buy_volume`. Per-bucket combo shares buy volume.'
        ssh:
          type: number
          format: double
          description: >-
            Full field: `shares_sell_volume`. Per-bucket combo shares sell
            volume.
        f:
          type: number
          format: double
          description: 'Full field: `fees`. Per-bucket fees in USD.'
        bf:
          type: number
          format: double
          description: 'Full field: `builder_fees`. Per-bucket builder fees in USD.'
        buv:
          type: number
          format: double
          description: >-
            Full field: `builder_usd_volume`. Per-bucket USD volume on
            builder-attributed fills.
        bubv:
          type: number
          format: double
          description: >-
            Full field: `builder_usd_buy_volume`. Per-bucket builder USD buy
            volume.
        busv:
          type: number
          format: double
          description: >-
            Full field: `builder_usd_sell_volume`. Per-bucket builder USD sell
            volume.
        bsv:
          type: number
          format: double
          description: >-
            Full field: `builder_shares_volume`. Per-bucket builder combo shares
            volume.
        bsbv:
          type: number
          format: double
          description: >-
            Full field: `builder_shares_buy_volume`. Per-bucket builder combo
            shares buy volume.
        bssv:
          type: number
          format: double
          description: >-
            Full field: `builder_shares_sell_volume`. Per-bucket builder combo
            shares sell volume.
        tc:
          type: integer
          format: int64
          description: 'Full field: `txns`. Per-bucket combo fill transaction count.'
        bc:
          type: integer
          format: int64
          description: 'Full field: `buys`. Per-bucket combo buy fill count.'
        sc:
          type: integer
          format: int64
          description: 'Full field: `sells`. Per-bucket combo sell fill count.'
        btc:
          type: integer
          format: int64
          description: >-
            Full field: `builder_txns`. Per-bucket builder combo fill
            transaction count.
        bbc:
          type: integer
          format: int64
          description: 'Full field: `builder_buys`. Per-bucket builder combo buy fill count.'
        bsc:
          type: integer
          format: int64
          description: >-
            Full field: `builder_sells`. Per-bucket builder combo sell fill
            count.
        cre:
          type: integer
          format: int64
          description: 'Full field: `creations`. Per-bucket combo market creations.'
        exe:
          type: integer
          format: int64
          description: 'Full field: `executions`. Per-bucket combo executions.'
        su:
          type: integer
          format: int64
          description: 'Full field: `status_updates`. Per-bucket combo status updates.'
        ps:
          type: integer
          format: int64
          description: >-
            Full field: `positions_split`. Per-bucket positions-split lifecycle
            operations.
        pm:
          type: integer
          format: int64
          description: >-
            Full field: `positions_merged`. Per-bucket positions-merged
            lifecycle operations.
        soc:
          type: integer
          format: int64
          description: >-
            Full field: `split_on_condition`. Per-bucket split-on-condition
            lifecycle operations.
        moc:
          type: integer
          format: int64
          description: >-
            Full field: `merged_on_condition`. Per-bucket merge-on-condition
            lifecycle operations.
        ext:
          type: integer
          format: int64
          description: 'Full field: `extracted`. Per-bucket extract lifecycle operations.'
        inj:
          type: integer
          format: int64
          description: 'Full field: `injected`. Per-bucket inject lifecycle operations.'
        ctyb:
          type: integer
          format: int64
          description: >-
            Full field: `converted_to_yes_basket`. Per-bucket
            convert-to-YES-basket lifecycle operations.
        mfyb:
          type: integer
          format: int64
          description: >-
            Full field: `merged_from_yes_basket`. Per-bucket
            merge-from-YES-basket lifecycle operations.
        cmp:
          type: integer
          format: int64
          description: 'Full field: `compressed`. Per-bucket compress lifecycle operations.'
        red:
          type: integer
          format: int64
          description: 'Full field: `redeemed`. Per-bucket redemption lifecycle operations.'
        wr:
          type: integer
          format: int64
          description: 'Full field: `wrapped`. Per-bucket wrap lifecycle operations.'
        uw:
          type: integer
          format: int64
          description: 'Full field: `unwrapped`. Per-bucket unwrap lifecycle operations.'
        hs:
          type: integer
          format: int64
          description: >-
            Full field: `horizontal_split`. Per-bucket horizontal-split
            lifecycle operations.
        hm:
          type: integer
          format: int64
          description: >-
            Full field: `horizontal_merge`. Per-bucket horizontal-merge
            lifecycle operations.
        pc:
          type: integer
          format: int64
          description: >-
            Full field: `position_converted`. Per-bucket position-converted
            lifecycle operations.
        mig:
          type: integer
          format: int64
          description: 'Full field: `migrated`. Per-bucket migrate lifecycle operations.'
        yv:
          type: number
          format: double
          description: 'Full field: `yes_usd_volume`. Per-bucket USD volume on the YES side.'
        ysh:
          type: number
          format: double
          description: >-
            Full field: `yes_shares_volume`. Per-bucket YES shares volume (buys
            + sells).
        ybsh:
          type: number
          format: double
          description: >-
            Full field: `yes_shares_buy_volume`. Per-bucket YES shares buy
            volume.
        yssh:
          type: number
          format: double
          description: >-
            Full field: `yes_shares_sell_volume`. Per-bucket YES shares sell
            volume.
        nv:
          type: number
          format: double
          description: 'Full field: `no_usd_volume`. Per-bucket USD volume on the NO side.'
        nsh:
          type: number
          format: double
          description: 'Full field: `no_shares_volume`. Per-bucket NO shares volume.'
        l2t:
          type: integer
          format: int64
          description: 'Full field: `legs_2_txns`. Per-bucket fill count on 2-leg combos.'
        l2v:
          type: number
          format: double
          description: >-
            Full field: `legs_2_usd_volume`. Per-bucket USD volume on 2-leg
            combos.
        l3t:
          type: integer
          format: int64
          description: 'Full field: `legs_3_txns`. Per-bucket fill count on 3-leg combos.'
        l3v:
          type: number
          format: double
          description: >-
            Full field: `legs_3_usd_volume`. Per-bucket USD volume on 3-leg
            combos.
        l4t:
          type: integer
          format: int64
          description: 'Full field: `legs_4_txns`. Per-bucket fill count on 4-leg combos.'
        l4v:
          type: number
          format: double
          description: >-
            Full field: `legs_4_usd_volume`. Per-bucket USD volume on 4-leg
            combos.
        l5t:
          type: integer
          format: int64
          description: >-
            Full field: `legs_5_plus_txns`. Per-bucket fill count on combos with
            5+ legs.
        l5v:
          type: number
          format: double
          description: >-
            Full field: `legs_5_plus_usd_volume`. Per-bucket USD volume on
            combos with 5+ legs.
        epw:
          type: number
          format: double
          description: >-
            Full field: `entry_price_usd_weighted_sum`. Per-bucket sum of entry
            price x USD size across fills (VWAP numerator).
        scu:
          type: number
          format: double
          description: >-
            Full field: `split_collateral_usd`. Per-bucket collateral locked via
            splits, in USD.
        mcu:
          type: number
          format: double
          description: >-
            Full field: `merge_collateral_usd`. Per-bucket collateral released
            via merges, in USD.
        rpu:
          type: number
          format: double
          description: >-
            Full field: `redemption_payout_usd`. Per-bucket redemption payouts
            in USD.
        ccu:
          type: number
          format: double
          description: >-
            Full field: `compress_collateral_usd`. Per-bucket collateral
            released via compress operations, in USD.
        ccr:
          type: integer
          format: int64
          description: 'Full field: `combos_created`. Per-bucket combo markets created.'
        cry:
          type: integer
          format: int64
          description: 'Full field: `combos_resolved_yes`. Per-bucket combos resolved YES.'
        crn:
          type: integer
          format: int64
          description: 'Full field: `combos_resolved_no`. Per-bucket combos resolved NO.'
        nct:
          type: integer
          format: int64
          description: >-
            Full field: `new_combo_traders`. Per-bucket first-time combo
            traders.
        nbct:
          type: integer
          format: int64
          description: >-
            Full field: `new_builder_combo_traders`. Per-bucket first-time
            builder-attributed combo traders.
        ut:
          type: integer
          format: int64
          description: >-
            Full field: `unique_traders`. Distinct traders that filled a combo
            in this bucket (window-unique,

            not first-time; uniqCombined approximation).
        dct:
          type: integer
          format: int64
          description: >-
            Full field: `distinct_combos_traded`. Distinct combos traded in this
            bucket (window-unique; uniqCombined

            approximation).

````