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

> Returns OHLCV candles for a combo token. Pass exactly one of `condition_id` or `position_id`; when using `condition_id`, `outcome_index` defaults to 0 (YES).



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/combos/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/candlestick:
    get:
      tags:
        - Combos
      summary: Get combo candlesticks
      description: >-
        Returns OHLCV candles for a combo token. Pass exactly one of
        `condition_id` or `position_id`; when using `condition_id`,
        `outcome_index` defaults to 0 (YES).
      operationId: get_combo_candlestick
      parameters:
        - name: condition_id
          in: query
          description: Combo condition id (0x-prefixed 32-byte hex)
          required: false
          schema:
            type: string
        - name: position_id
          in: query
          description: Combo position id, decimal or 0x-prefixed hex
          required: false
          schema:
            type: string
        - name: outcome_index
          in: query
          description: 'Combo side when `condition_id` is used: 0 = YES, 1 = NO. 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 OHLCV candlestick data
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ComboCandlestickBar'
        '400':
          description: Missing or invalid params
components:
  schemas:
    CandlestickResolution:
      type: string
      enum:
        - 1S
        - 5S
        - 10S
        - 30S
        - '1'
        - '5'
        - '15'
        - '30'
        - '60'
        - '240'
        - D
        - 1D
    ComboCandlestickBar:
      type: object
      required:
        - t
      properties:
        l:
          type:
            - number
            - 'null'
          format: double
          description: Low price.
        h:
          type:
            - number
            - 'null'
          format: double
          description: High price.
        o:
          type:
            - number
            - 'null'
          format: double
          description: Open price.
        c:
          type:
            - number
            - 'null'
          format: double
          description: Close price.
        v:
          type:
            - number
            - 'null'
          format: double
          description: Total combo trade volume in USD.
        t:
          type: integer
          format: int64
          description: Unix timestamp in milliseconds.
          minimum: 0
        tc:
          type:
            - integer
            - 'null'
          format: int32
          description: Combo trade count.
        m:
          type:
            - number
            - 'null'
          format: double
          description: Volume-weighted mean price.

````