polymarket-market-watcher

OpenTool app

Copy strategy · 1 times Star· 0 Watch· 0

OpenPond Syncsync: merge local template master into production

markdown

# Polymarket Market Watcher

Polymarket Market Watcher is a config-first strategy template for watching one exact Polymarket market outcome and mapping that probability into a Hyperliquid trade decision.

## What it does
- Resolves one exact Polymarket market by slug, id, or condition id.
- Watches the configured `Yes` or `No` outcome probability.
- Triggers a Hyperliquid `buy` or `sell` signal once the threshold is met.
- Supports hourly-style decision backtests by replaying Polymarket price history against Hyperliquid price bars.

## Default example
- Watch `US x Iran ceasefire by March 31?`
- Trade the `No` outcome if it stays above `80%`

## Setup
- Configure the tool through `OPENTOOL_PUBLIC_PM_MARKET_WATCHER_CONFIG`.
- Set `marketSymbol` explicitly for non-standard Hyperliquid instruments like `xyz:CL`.
- Keep execution disabled until the watched market, outcome, and asset are confirmed.

About

polymarket-market-watcher

OpenTool app

Tool

signal-bot

Method

POST

Profile

{
  "assets": [
    {
      "chain": "hyperliquid",
      "venue": "hyperliquid",
      "assetSymbols": [
        "BTC"
      ]
    }
  ],
  "backtest": {
    "mode": "decisions"
  },
  "category": "strategy",
  "schedule": {
    "cron": "0 * * * *",
    "enabled": false,
    "notifyEmail": false
  },
  "description": "Watch one exact Polymarket market outcome and map its threshold to a Hyperliquid trade signal.",
  "templateConfig": {
    "envVar": "OPENTOOL_PUBLIC_PM_MARKET_WATCHER_CONFIG",
    "schema": {
      "type": "object",
      "required": [
        "watchedOutcome",
        "minProbability",
        "asset"
      ],
      "properties": {
        "asset": {
          "type": "string",
          "title": "Asset",
          "x-format": "asset",
          "description": "Default Hyperliquid perp symbol. Use marketSymbol or execution.symbol for exact spot pairs (BASE-QUOTE or BASE/QUOTE) or HIP-3 symbols (dex:BASE)."
        },
        "action": {
          "enum": [
            "buy",
            "sell"
          ],
          "type": "string",
          "title": "Trade action",
          "description": "Hyperliquid action to take when the threshold passes."
        },
        "marketId": {
          "type": "string",
          "title": "Market id",
          "description": "Exact Polymarket market id if you prefer id-based lookup."
        },
        "platform": {
          "enum": [
            "hyperliquid"
          ],
          "type": "string",
          "title": "Platform",
          "readOnly": true,
          "description": "Execution venue for this strategy."
        },
        "schedule": {
          "type": "object",
          "title": "Schedule",
          "properties": {
            "cron": {
              "type": "string",
              "title": "Cron expression"
            },
            "enabled": {
              "type": "boolean",
              "title": "Enabled"
            },
            "notifyEmail": {
              "type": "boolean",
              "title": "Notify email"
            }
          }
        },
        "amountUsd": {
          "type": "number",
          "title": "Amount USD",
          "minimum": 1,
          "description": "Fixed notional size when allocation mode is fixed."
        },
        "execution": {
          "type": "object",
          "title": "Execution",
          "properties": {
            "mode": {
              "enum": [
                "long-only",
                "long-short"
              ],
              "type": "string",
              "title": "Execution mode"
            },
            "size": {
              "type": "number",
              "title": "Override size",
              "minimum": 1e-8
            },
            "symbol": {
              "type": "string",
              "title": "Execution symbol",
              "description": "Optional exact Hyperliquid symbol override. Use BASE-QUOTE or BASE/QUOTE for spot, bare BASE for perps, or dex:BASE for HIP-3."
            },
            "enabled": {
              "type": "boolean",
              "title": "Enable live execution"
            },
            "leverage": {
              "type": "number",
              "title": "Leverage",
              "maximum": 50,
              "minimum": 1
            },
            "environment": {
              "enum": [
                "testnet",
                "mainnet"
              ],
              "type": "string",
              "title": "Environment"
            },
            "slippageBps": {
              "type": "number",
              "title": "Slippage bps",
              "maximum": 500,
              "minimum": 0
            }
          }
        },
        "onNoMatch": {
          "enum": [
            "hold",
            "unknown"
          ],
          "type": "string",
          "title": "Fallback action",
          "description": "What to return when the threshold is not met."
        },
        "marketSlug": {
          "type": "string",
          "title": "Market slug",
          "description": "Exact Polymarket market slug to watch."
        },
        "resolution": {
          "enum": [
            "1",
            "5",
            "15",
            "30",
            "60",
            "240",
            "1D",
            "1W"
          ],
          "type": "string",
          "title": "Bar resolution",
          "description": "Resolution used for Hyperliquid price alignment in backtests and live reads."
        },
        "conditionId": {
          "type": "string",
          "title": "Condition id",
          "description": "Exact Polymarket condition id for the watched market."
        },
        "marketSymbol": {
          "type": "string",
          "title": "Exact market symbol",
          "description": "Optional exact Hyperliquid symbol used for replay and execution. Use BASE-QUOTE or BASE/QUOTE for spot, bare BASE for perps, or dex:BASE for HIP-3."
        },
        "minLiquidity": {
          "type": "number",
          "title": "Minimum liquidity",
          "minimum": 0,
          "description": "Optional liquidity floor for the watched market."
        },
        "configVersion": {
          "type": "number",
          "title": "Config version",
          "readOnly": true,
          "x-hidden": true,
          "description": "Internal schema version for the market watcher defaults."
        },
        "allocationMode": {
          "enum": [
            "fixed",
            "percent_equity"
          ],
          "type": "string",
          "title": "Allocation mode",
          "description": "Fixed USD or percent-of-equity sizing."
        },
        "minProbability": {
          "type": "number",
          "title": "Minimum probability",
          "maximum": 1,
          "minimum": 0,
          "description": "Trigger once the watched outcome reaches at least this probability."
        },
        "watchedOutcome": {
          "enum": [
            "yes",
            "no"
          ],
          "type": "string",
          "title": "Watched outcome",
          "description": "Outcome probability to monitor on the chosen market."
        },
        "percentOfEquity": {
          "type": "number",
          "title": "Percent of equity",
          "maximum": 100,
          "minimum": 0.1,
          "description": "Sizing target when allocation mode is percent-of-equity."
        },
        "maxPercentOfEquity": {
          "type": "number",
          "title": "Max percent of equity",
          "maximum": 100,
          "minimum": 0.1,
          "description": "Absolute sizing cap for percent-of-equity mode."
        },
        "historyFidelitySeconds": {
          "type": "number",
          "title": "Polymarket history fidelity",
          "maximum": 86400,
          "minimum": 60,
          "description": "Sampling interval in seconds for Polymarket price-history replay."
        }
      }
    },
    "version": 2,
    "defaults": {
      "asset": "BTC",
      "action": "buy",
      "platform": "hyperliquid",
      "schedule": {
        "cron": "0 * * * *",
        "enabled": false,
        "notifyEmail": false
      },
      "amountUsd": 200,
      "countBack": 240,
      "execution": {
        "mode": "long-only",
        "enabled": false,
        "environment": "mainnet",
        "slippageBps": 50
      },
      "onNoMatch": "hold",
      "marketSlug": "us-x-iran-ceasefire-by-march-31",
      "resolution": "60",
      "minLiquidity": 100000,
      "configVersion": 2,
      "allocationMode": "fixed",
      "minProbability": 0.8,
      "watchedOutcome": "no",
      "percentOfEquity": 2,
      "maxPercentOfEquity": 10,
      "historyFidelitySeconds": 3600
    }
  },
  "templatePreview": {
    "title": "signal-bot",
    "subtitle": "Exact Polymarket outcome watcher with Hyperliquid execution.",
    "description": "Resolves one exact Polymarket market by slug, id, or condition id.\nWatches a configured Yes or No probability threshold.\nMaps that signal into a standardized Hyperliquid trade decision.\nSupports decision-series backtests using Polymarket price history and Hyperliquid bars."
  }
}

Tool Path

tools/signal-bot.js

Input Schema

{
  "type": "object",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "asOf": {
          "type": "string",
          "format": "date-time"
        },
        "asset": {
          "type": "string",
          "minLength": 1
        },
        "action": {
          "enum": [
            "buy",
            "sell"
          ],
          "type": "string"
        },
        "marketId": {
          "type": "string",
          "minLength": 1
        },
        "schedule": {
          "type": "object",
          "properties": {
            "cron": {
              "type": "string",
              "minLength": 1
            },
            "enabled": {
              "type": "boolean"
            },
            "notifyEmail": {
              "type": "boolean"
            }
          },
          "additionalProperties": false
        },
        "amountUsd": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "countBack": {
          "type": "integer",
          "maximum": 5000,
          "minimum": 50
        },
        "execution": {
          "type": "object",
          "properties": {
            "mode": {
              "enum": [
                "long-only",
                "long-short"
              ],
              "type": "string"
            },
            "size": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "symbol": {
              "type": "string",
              "minLength": 1
            },
            "enabled": {
              "type": "boolean"
            },
            "leverage": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "environment": {
              "enum": [
                "testnet",
                "mainnet"
              ],
              "type": "string"
            },
            "slippageBps": {
              "type": "number",
              "maximum": 500,
              "minimum": 0
            }
          },
          "additionalProperties": false
        },
        "onNoMatch": {
          "enum": [
            "hold",
            "unknown"
          ],
          "type": "string"
        },
        "marketSlug": {
          "type": "string",
          "minLength": 1
        },
        "resolution": {
          "enum": [
            "1",
            "5",
            "15",
            "30",
            "60",
            "240",
            "1D",
            "1W"
          ],
          "type": "string"
        },
        "conditionId": {
          "type": "string",
          "minLength": 1
        },
        "marketSymbol": {
          "type": "string",
          "minLength": 1
        },
        "minLiquidity": {
          "type": "number",
          "minimum": 0
        },
        "allocationMode": {
          "enum": [
            "fixed",
            "percent_equity"
          ],
          "type": "string"
        },
        "minProbability": {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        "watchedOutcome": {
          "enum": [
            "yes",
            "no"
          ],
          "type": "string"
        },
        "percentOfEquity": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "maxPercentOfEquity": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "historyFidelitySeconds": {
          "type": "integer",
          "maximum": 86400,
          "minimum": 60
        }
      },
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "to": {
          "type": "integer",
          "minimum": 0
        },
        "from": {
          "type": "integer",
          "minimum": 0
        },
        "mode": {
          "type": "string",
          "const": "backtest_decisions"
        },
        "source": {
          "type": "string",
          "minLength": 1
        },
        "symbol": {
          "type": "string",
          "minLength": 1
        },
        "lookbackDays": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "timeframeEnd": {
          "type": "string"
        },
        "timeframeStart": {
          "type": "string"
        },
        "initialEquityUsd": {
          "type": "number",
          "exclusiveMinimum": 0
        }
      },
      "additionalProperties": false
    }
  ]
}