botsmith

Best Markets to Watch ($0.02/call): The best Polymarket prediction markets to watch right now, ranked by a composite watch-score (24h volume, liquidity, competitiveness, momentum, time-to-resolution). Filter by tag. Returns implied probability, volume, liquidity, spread and a plain-English reason for each. Live data, no account needed.

Resource: x402.botsmith.dev/polymarket/markets

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xcb9b3F94387389e38EF2A7b3C0B851FB8325d7e9

Payment methods: — · Last validation: 2026-10-15 11:48:53.109+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "queryParams": {
        "type": "object",
        "required": [
          "limit",
          "sort"
        ],
        "properties": {
          "tag": {
            "type": "string",
            "description": "Filter by a Polymarket tag slug, e.g. 'politics', 'crypto', 'sports'"
          },
          "sort": {
            "enum": [
              "watch",
              "volume",
              "liquidity"
            ],
            "type": "string",
            "default": "watch",
            "description": "Ranking: 'watch' = composite watch-score (default), or raw volume/liquidity"
          },
          "limit": {
            "type": "integer",
            "default": 10,
            "maximum": 25,
            "minimum": 1,
            "description": "How many markets to return"
          }
        },
        "additionalProperties": false
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object",
        "required": [
          "count",
          "sort",
          "markets"
        ],
        "properties": {
          "sort": {
            "type": "string"
          },
          "count": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991
          },
          "markets": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "question",
                "slug",
                "url",
                "yesPrice",
                "volume24hr",
                "liquidity",
                "spread",
                "priceChange24h",
                "daysToResolution",
                "watchScore",
                "why"
              ],
              "properties": {
                "url": {
                  "type": "string"
                },
                "why": {
                  "type": "string",
                  "description": "Short human-readable reason this market ranks"
                },
                "slug": {
                  "type": "string"
                },
                "spread": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "question": {
                  "type": "string"
                },
                "yesPrice": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Implied probability of the first outcome (0-1)"
                },
                "liquidity": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "volume24hr": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "watchScore": {
                  "type": "number",
                  "description": "0-100 composite: activity, depth, competitiveness, momentum, timing"
                },
                "priceChange24h": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "daysToResolution": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0xcb9b3F94387389e38EF2A7b3C0B851FB8325d7e9",
        "amount": "20000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 60
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0xcb9b3F94387389e38EF2A7b3C0B851FB8325d7e9",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "20000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.