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

# Get combo leg candlesticks

> Returns sampled price candles for one combo leg. Prefer `position_id` from `/polymarket/combos/legs`; alternatively pass `v2_condition_id` with `outcome_index`.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/combos/legs/candlestick
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/legs/candlestick:
    get:
      tags:
        - Combos
      summary: Get combo leg candlesticks
      description: >-
        Returns sampled price candles for one combo leg. Prefer `position_id`
        from `/polymarket/combos/legs`; alternatively pass `v2_condition_id`
        with `outcome_index`.
      operationId: get_combo_leg_candlestick
      parameters:
        - name: position_id
          in: query
          description: Leg position id, decimal or 0x-prefixed hex
          required: false
          schema:
            type: string
        - name: leg_position_id
          in: query
          description: Alias for `position_id`
          required: false
          schema:
            type: string
        - name: v2_condition_id
          in: query
          description: Leg V2 condition id from `/polymarket/combos/legs`
          required: false
          schema:
            type: string
        - name: outcome_index
          in: query
          description: 'Leg outcome index when `v2_condition_id` is used. Default: 0'
          required: false
          schema:
            type: integer
            format: int32
            minimum: 0
        - name: resolution
          in: query
          description: 'Candle interval: 1S, 5S, 10S, 30S, 1, 5, 15, 30, 60, 240, D, 1D'
          required: true
          schema:
            $ref: '#/components/schemas/CandlestickResolution'
        - name: count_back
          in: query
          description: Number of candles (default 500, max 2500)
          required: false
          schema:
            type: integer
            format: int32
        - name: from
          in: query
          description: Start timestamp (Unix seconds)
          required: false
          schema:
            type: integer
            format: int64
        - name: to
          in: query
          description: End timestamp (Unix seconds)
          required: false
          schema:
            type: integer
            format: int64
        - name: pagination_key
          in: query
          description: Cursor-based pagination key from previous response
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Combo leg sampled-price candlestick data
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ComboLegCandlestickBar'
        '400':
          description: Missing or invalid params
components:
  schemas:
    CandlestickResolution:
      type: string
      enum:
        - 1S
        - 5S
        - 10S
        - 30S
        - '1'
        - '5'
        - '15'
        - '30'
        - '60'
        - '240'
        - D
        - 1D
    ComboLegCandlestickBar:
      type: object
      required:
        - t
      properties:
        l:
          type:
            - number
            - 'null'
          format: double
          description: Low sampled leg price.
        h:
          type:
            - number
            - 'null'
          format: double
          description: High sampled leg price.
        o:
          type:
            - number
            - 'null'
          format: double
          description: Open sampled leg price.
        c:
          type:
            - number
            - 'null'
          format: double
          description: Close sampled leg price.
        t:
          type: integer
          format: int64
          description: Unix timestamp in milliseconds.
          minimum: 0
        sc:
          type:
            - integer
            - 'null'
          format: int32
          description: Number of combo trades that sampled this leg price.

````