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

# Detect price jumps

> Scan candles for significant price movements. Returns jumps with from/to timestamps in milliseconds, directly usable as trades API time range parameters to identify traders who traded before or during the movement.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/market/price-jumps
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/market/price-jumps:
    get:
      tags:
        - Market
      summary: Detect price jumps
      description: >-
        Scan candles for significant price movements. Returns jumps with from/to
        timestamps in milliseconds, directly usable as trades API time range
        parameters to identify traders who traded before or during the movement.
      operationId: get_price_jumps
      parameters:
        - name: condition_id
          in: query
          description: Market condition ID (one of condition_id or market_slug required)
          required: false
          schema:
            type: string
        - name: market_slug
          in: query
          description: Market slug (resolved to condition_id)
          required: false
          schema:
            type: string
        - name: resolution
          in: query
          description: 'Candle resolution in minutes: 1, 5, 15, 30, 60, 240 (default: 15)'
          required: false
          schema:
            $ref: '#/components/schemas/PriceJumpResolution'
        - name: min_change_pct
          in: query
          description: 'Minimum relative percent change to qualify as a jump (default: 10.0)'
          required: false
          schema:
            type: number
            format: double
        - name: lookback
          in: query
          description: 'Number of candles to scan back from now (default: 1440, max: 2500)'
          required: false
          schema:
            type: integer
            format: int64
        - name: offset
          in: query
          description: >-
            Offset in candles from now — window is [now - (lookback + offset) *
            resolution, now - offset * resolution] (default: 0)
          required: false
          schema:
            type: integer
            format: int64
      responses:
        '200':
          description: Price jumps sorted by timestamp descending
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PriceJump'
components:
  schemas:
    PriceJumpResolution:
      type: string
      enum:
        - '1'
        - '5'
        - '15'
        - '30'
        - '60'
        - '240'
    PriceJump:
      type: object
      required:
        - from
        - to
        - price_before
        - price_after
        - change_pct
        - direction
        - volume
        - trades_count
        - condition_id
      properties:
        from:
          type: integer
          format: int64
          description: Window start timestamp.
          minimum: 0
        to:
          type: integer
          format: int64
          description: Window end timestamp.
          minimum: 0
        price_before:
          type: number
          format: double
          description: Price before.
        price_after:
          type: number
          format: double
          description: Price after.
        change_pct:
          type: number
          format: double
          description: Change percent.
        direction:
          type: string
          description: Direction.
        volume:
          type: number
          format: double
          description: Volume.
        trades_count:
          type: integer
          format: int32
          description: Trades count.
        condition_id:
          type: string
          description: Condition ID.

````