Polymarket

Polymarket Price Jumps

Detect significant price jumps on a Polymarket market by scanning candlestick data bucketed at a chosen resolution. Returns all candle-to-candle moves exceeding the configured threshold, sorted by magnitude.

POST/v2/semantic/retrieve/parameterized

Query Parameters

token_idstring

Token ID of the specific outcome. Use Polymarket Markets (574) to find it.

Example:

"99787107393065498256888522570939526464960671564345515510320748534859284179297"

resolutionstring

Candle bucket size. Options: 1m, 5m, 15m, 1h, 4h, 1d

Example:

"15m"

min_change_pctstring

Minimum absolute % price change to qualify as a jump

Example:

"10"

lookback_hoursstring

Hours to scan back from now

Example:

"24"

Response Fields

Field	Type	Description
`jump_time`	String (ISO 8601)	Timestamp of the candle where the jump occurred
`condition_id`	String	Hex condition ID of the market
`token_id`	String	Token ID of the outcome
`outcome`	String	Outcome label
`price_before`	String (Decimal)	Price at the start of the candle
`price_after`	String (Decimal)	Price at the end of the candle
`change_pct`	String (Decimal)	Percentage change (negative = price dropped)
`direction`	String	`up` or `down`
`volume`	String (Decimal)	Volume during the candle
`trade_count`	Integer	Number of trades during the candle

Polymarket Price Jumps

curl --request POST \
  --url https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": 596,
  "params": {
    "token_id": "99787107393065498256888522570939526464960671564345515510320748534859284179297",
    "resolution": "15m",
    "min_change_pct": "10",
    "lookback_hours": "24"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
}'

200Example response

{
  "timestamp": "",
  "params": {
    "lookback_hours": "24",
    "min_change_pct": "10",
    "resolution": "15m",
    "token_id": "99787107393065498256888522570939526464960671564345515510320748534859284179297"
  },
  "pagination": {
    "limit": 10,
    "offset": 0,
    "has_more": false
  },
  "data": {
    "results": [
      {
        "change_pct": "-16.67",
        "condition_id": "0xbcacd5a055f5a9ced6f69f122216c073dd6987d08253fc07bbcc168fa5b81d55",
        "direction": "down",
        "jump_time": "2026-04-06T02:00:00Z",
        "outcome": "Yes",
        "price_after": "0.1500",
        "price_before": "0.1800",
        "token_id": "99787107393065498256888522570939526464960671564345515510320748534859284179297",
        "trade_count": 28,
        "volume": "7350.07"
      },
      {
        "change_pct": "14.29",
        "condition_id": "0xbcacd5a055f5a9ced6f69f122216c073dd6987d08253fc07bbcc168fa5b81d55",
        "direction": "up",
        "jump_time": "2026-04-05T19:30:00Z",
        "outcome": "Yes",
        "price_after": "0.1600",
        "price_before": "0.1400",
        "token_id": "99787107393065498256888522570939526464960671564345515510320748534859284179297",
        "trade_count": 3,
        "volume": "264.35"
      }
    ]
  },
  "request_id": ""
}