Problee

Paginated list of active markets

problee_list_markets

Read-onlyIdempotent

Use this when someone names an event or a topic and wants its prediction-market question or odds: pass the words as search. List prediction markets on Kellian. Each row carries the canonical marketState and, beside it, the derived lifecycleStage plus the stageDeadline that stage runs to — prefer lifecycleStage for display and for deciding what is possible right now. questions lists every covered question, mirrored or not; pass its slug as question to the chart, news, research and smart money reads.

Examples: List live CRYPTO markets on Base

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "problee_list_markets"
  }
}

Input Schema

Name	Required	Description	Default
`sort`	No	Sort order. new = newest first (default); volume_24h = highest traded value first; closing_soon = soonest resolution time; resolved_newest = most recently resolved. The keyset `cursor` only applies to `new`.	new
`view`	No	full (default): the whole rows. compact: the questions first, then each market's question, chance, stage and trading end.
`cursor`	No	Keyset cursor from a prior response nextCursor.
`search`	No	Free-text search over the market question.
`chainId`	No
`creator`	No	Filter to markets whose on-chain creator wallet matches this address.
`category`	No
`pageSize`	No
`marketState`	No	Exact canonical market-state filter.
`pricingModel`	No	Filter by pricing engine: 'ORDERBOOK' = central limit order book markets; 'automated' = automated-market-maker markets.
`sourceTokenId`	No	Source outcome token ID, in decimal as the source market's orders name it: lists the market that follows it, each row carrying `sourceToken.side`, the order side that is that outcome.
`sourceConditionId`	No	Source market condition ID: lists the markets whose `resolutionSource` is `{type: 'polymarket', conditionId}` with this ID.

Output Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedNov 6, 2026

addedInput schema / properties / view

Added value: +{
+  "description": "full (default): the whole rows. compact: the questions first, then each market's question, chance, stage and trading end.",
+  "enum": [
+    "full",
+    "compact"
+  ],
+  "type": "string"
+}

removedOutput schema / $defs / DiscoverMarketsResponse

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "hasMore": {
-      "type": "boolean"
-    },
-    "markets": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "actions": {
-            "additionalProperties": false,
-            "properties": {
-              "canChallenge": {
-                "type": "boolean"
-              },
-              "canClaim": {
-                "type": "boolean"
-              },
-              "canCreatorResolve": {
-                "type": "boolean"
-              },
-              "canVote": {
-                "type": "boolean"
-              },
-              "creatorAddress": {
-                "$ref": "#/$defs/EvmAddress"
-              },
-              "reason": {
-                "$ref": "#/$defs/ErrorReason"
-              }
-            },
-            "required": [
-              "canCreatorResolve",
-              "canChallenge",
-              "canVote",
-              "canClaim"
-            ],
-            "type": "object"
-          },
-          "address": {
-            "anyOf": [
-              {
-                "$ref": "#/$defs/EvmAddress"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "category": {
-            "enum": [
-              "CRYPTO",
-              "SPORTS",
-              "POLITICS",
-              "ELECTIONS",
-              "FINANCE",
-              "TECH",
-              "WORLD",
-              "ECONOMY",
-              "CULTURE",
-              "WEATHER",
-              "SCIENCE_HEALTH",
-              "AI",
-              "GAMING",
-              "BUSINESS",
-              "FASHION",
-              "MOVIES_TV",
-              "MUSIC",
-              "SHOPPING",
-              "BEAUTY",
-              "TRAVEL",
-              "CLIMATE",
-              "DAILY_LIFE",
-              "LOCAL",
-              "SOCIAL",
-              "FUN",
-              "OTHER"
-            ],
-            "type": "string",
-            "x-extensible-enum": true
-          },
-          "chainId": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "challengeBy": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "closeTime": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "collateralToken": {
-            "anyOf": [
-              {
-                "$ref": "#/$defs/EvmAddress"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "councilReviewEndsAt": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "createdAt": {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-            "type": "string"
-          },
-          "createdBy": {
-            "anyOf": [
-              {
-                "$ref": "#/$defs/EvmAddress"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "creatorAgentId": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "creatorResolveBy": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "creatorTier": {
-            "anyOf": [
-              {
-                "$ref": "#/$defs/ReputationTier"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "finality": {
-            "enum": [
-              "pending",
-              "finalized"
-            ],
-            "type": "string"
-          },
-          "geo": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "countryCode": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "derivation": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "explicit",
-                          "entity_hq"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "lat": {
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "lon": {
-                    "type": [
-                      "number",
-                      "null"
-                    ]
-                  },
-                  "place": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "scope": {
-                    "enum": [
-                      "city",
-                      "region",
-                      "country",
-                      "global"
-                    ],
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "scope",
-                  "countryCode",
-                  "place",
-                  "lat",
-                  "lon",
-                  "derivation"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "humanVote": {
-            "additionalProperties": false,
-            "properties": {
-              "deadlineImmutable": {
-                "const": true,
-                "type": "boolean"
-              },
-              "endsAt": {
-                "anyOf": [
-                  {
-                    "format": "date-time",
-                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "sessionId": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "windowStartsAt": {
-                "const": "session_open",
-                "type": "string"
-              }
-            },
-            "required": [
-              "sessionId",
-              "windowStartsAt",
-              "deadlineImmutable",
-              "endsAt"
-            ],
-            "type": "object"
-          },
-          "id": {
-            "type": "string"
-          },
-          "isTernary": {
-            "type": "boolean"
-          },
-          "jurorTier": {
-            "anyOf": [
-              {
-                "$ref": "#/$defs/ReputationTier"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "language": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "lifecycleStage": {
-            "$ref": "#/$defs/MarketLifecycleStage"
-          },
-          "marketReference": {
-            "pattern": "^mkt_[\\da-f]{8}-[\\da-f]{4}-[\\da-f]{4}-[\\da-f]{4}-[\\da-f]{12}$",
-            "type": "string"
-          },
-          "marketState": {
-            "enum": [
-              "open",
-              "closed",
-              "creator_proposal",
-              "challenge",
-              "human_voting",
-              "council_review",
-              "resolved",
-              "void"
-            ],
-            "type": "string"
-          },
-          "marketType": {
-            "type": "string"
-          },
-          "nextActionDeadline": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "openTime": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "outcome": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "outcomes": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "label": {
-                  "type": "string"
-                },
-                "pricePercent": {
-                  "anyOf": [
-                    {
-                      "maximum": 100,
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "label",
-                "pricePercent"
-              ],
-              "type": "object"
-            },
-            "maxItems": 3,
-            "minItems": 2,
-            "type": "array"
-          },
-          "prices": {
-            "additionalProperties": false,
-            "properties": {
-              "outcome1": {
-                "anyOf": [
-                  {
-                    "maximum": 1,
-                    "minimum": 0,
-                    "type": "number"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "outcome2": {
-                "anyOf": [
-                  {
-                    "maximum": 1,
-                    "minimum": 0,
-                    "type": "number"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "outcome3": {
-                "anyOf": [
-                  {
-                    "maximum": 1,
-                    "minimum": 0,
-                    "type": "number"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "pricingModel": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "question": {
-            "type": "string"
-          },
-          "resolutionCriteria": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "resolutionSource": {
-            "anyOf": [
-              {
-                "additionalProperties": {},
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "resolutionTime": {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-            "type": "string"
-          },
-          "settlement": {
-            "enum": [
-              "onchain",
-              "committed"
-            ],
-            "type": "string"
-          },
-          "sourceToken": {
-            "additionalProperties": false,
-            "properties": {
-              "side": {
-                "maximum": 1,
-                "minimum": 0,
-                "type": "integer"
-              },
-              "tokenId": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "tokenId",
-              "side"
-            ],
-            "type": "object"
-          },
-          "stageDeadline": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "supportsVoid": {
-            "type": "boolean"
-          },
-          "tradingEndsAt": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "volume": {
-            "$ref": "#/$defs/WeiString"
-          },
-          "volume24h": {
-            "$ref": "#/$defs/WeiString"
-          },
-          "volumePm": {
-            "additionalProperties": false,
-            "properties": {
-              "last24hPm": {
-                "pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,6})?$",
-                "type": "string"
-              },
-              "lifetimePm": {
-                "pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,6})?$",
-                "type": "string"
-              }
-            },
-            "required": [
-              "lifetimePm",
-              "last24hPm"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "id",
-          "address",
-          "chainId",
-          "question",
-          "category",
-          "marketState",
-          "tradingEndsAt",
-          "lifecycleStage",
-          "stageDeadline",
-          "isTernary",
-          "outcome",
-          "marketType",
-          "finality",
-          "pricingModel",
-          "openTime",
-          "closeTime",
-          "resolutionTime",
-          "creatorResolveBy",
-          "challengeBy",
-          "humanVote",
-          "councilReviewEndsAt",
-          "nextActionDeadline",
-          "actions",
-          "createdAt",
-          "collateralToken",
-          "language",
-          "volume"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "nextCursor": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "questions": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "category": {
-            "type": "string"
-          },
-          "endsAt": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "marketAddress": {
-            "anyOf": [
-              {
-                "$ref": "#/$defs/EvmAddress"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "options": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "label": {
-                  "type": "string"
-                },
-                "price": {
-                  "anyOf": [
-                    {
-                      "maximum": 1,
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "label",
-                "price"
-              ],
-              "type": "object"
-            },
-            "maxItems": 4,
-            "type": "array"
-          },
-          "slug": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          },
-          "url": {
-            "format": "uri",
-            "type": "string"
-          },
-          "volume24hUsd": {
-            "anyOf": [
-              {
-                "minimum": 0,
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "slug",
-          "title",
-          "url",
-          "category",
-          "endsAt",
-          "options",
-          "volume24hUsd",
-          "marketAddress"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    }
-  },
-  "required": [
-    "markets",
-    "hasMore",
-    "nextCursor"
-  ],
-  "type": "object"
-}

removedOutput schema / properties / result / $ref

Removed value: -"#/$defs/DiscoverMarketsResponse"

addedOutput schema / properties / result / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "hasMore": {
+        "type": "boolean"
+      },
+      "markets": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "address": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/EvmAddress"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "chance": {
+              "anyOf": [
+                {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "lifecycleStage": {
+              "$ref": "#/$defs/MarketLifecycleStage"
+            },
+            "question": {
+              "type": "string"
+            },
+            "tradingEndsAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "address",
+            "question",
+            "chance",
+            "lifecycleStage",
+            "tradingEndsAt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "nextCursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "questions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "endsAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "options": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "label": {
+                    "type": "string"
+                  },
+                  "price": {
+                    "anyOf": [
+                      {
+                        "maximum": 1,
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "label",
+                  "price"
+                ],
+                "type": "object"
+              },
+              "maxItems": 4,
+              "type": "array"
+            },
+            "slug": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "volume24hUsd": {
+              "anyOf": [
+                {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "slug",
+            "title",
+            "endsAt",
+            "options",
+            "volume24hUsd"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "view": {
+        "const": "compact",
+        "type": "string"
+      }
+    },
+    "required": [
+      "view",
+      "markets",
+      "hasMore",
+      "nextCursor"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "hasMore": {
+        "type": "boolean"
+      },
+      "markets": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "actions": {
+              "additionalProperties": false,
+              "properties": {
+                "canChallenge": {
+                  "type": "boolean"
+                },
+                "canClaim": {
+                  "type": "boolean"
+                },
+                "canCreatorResolve": {
+                  "type": "boolean"
+                },
+                "canVote": {
+                  "type": "boolean"
+                },
+                "creatorAddress": {
+                  "$ref": "#/$defs/EvmAddress"
+                },
+                "reason": {
+                  "$ref": "#/$defs/ErrorReason"
+                }
+              },
+              "required": [
+                "canCreatorResolve",
+                "canChallenge",
+                "canVote",
+                "canClaim"
+              ],
+              "type": "object"
+            },
+            "address": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/EvmAddress"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "category": {
+              "enum": [
+                "CRYPTO",
+                "SPORTS",
+                "POLITICS",
+                "ELECTIONS",
+                "FINANCE",
+                "TECH",
+                "WORLD",
+                "ECONOMY",
+                "CULTURE",
+                "WEATHER",
+                "SCIENCE_HEALTH",
+                "AI",
+                "GAMING",
+                "BUSINESS",
+                "FASHION",
+                "MOVIES_TV",
+                "MUSIC",
+                "SHOPPING",
+                "BEAUTY",
+                "TRAVEL",
+                "CLIMATE",
+                "DAILY_LIFE",
+                "LOCAL",
+                "SOCIAL",
+                "FUN",
+                "OTHER"
+              ],
+              "type": "string",
+              "x-extensible-enum": true
+            },
+            "chainId": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "challengeBy": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "closeTime": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "collateralToken": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/EvmAddress"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "councilReviewEndsAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "createdAt": {
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+              "type": "string"
+            },
+            "createdBy": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/EvmAddress"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "creatorAgentId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "creatorResolveBy": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "creatorTier": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/ReputationTier"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "finality": {
+              "enum": [
+                "pending",
+                "finalized"
+              ],
+              "type": "string"
+            },
+            "geo": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "countryCode": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "derivation": {
+                      "anyOf": [
+                        {
+                          "enum": [
+                            "explicit",
+                            "entity_hq"
+                          ],
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "lat": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "lon": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "place": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "scope": {
+                      "enum": [
+                        "city",
+                        "region",
+                        "country",
+                        "global"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "scope",
+                    "countryCode",
+                    "place",
+                    "lat",
+                    "lon",
+                    "derivation"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "humanVote": {
+              "additionalProperties": false,
+              "properties": {
+                "deadlineImmutable": {
+                  "const": true,
+                  "type": "boolean"
+                },
+                "endsAt": {
+                  "anyOf": [
+                    {
+                      "format": "date-time",
+                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "sessionId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "windowStartsAt": {
+                  "const": "session_open",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "sessionId",
+                "windowStartsAt",
+                "deadlineImmutable",
+                "endsAt"
+              ],
+              "type": "object"
+            },
+            "id": {
+              "type": "string"
+            },
+            "isTernary": {
+              "type": "boolean"
+            },
+            "jurorTier": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/ReputationTier"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "language": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "lifecycleStage": {
+              "$ref": "#/$defs/MarketLifecycleStage"
+            },
+            "marketReference": {
+              "pattern": "^mkt_[\\da-f]{8}-[\\da-f]{4}-[\\da-f]{4}-[\\da-f]{4}-[\\da-f]{12}$",
+              "type": "string"
+            },
+            "marketState": {
+              "enum": [
+                "open",
+                "closed",
+                "creator_proposal",
+                "challenge",
+                "human_voting",
+                "council_review",
+                "resolved",
+                "void"
+              ],
+              "type": "string"
+            },
+            "marketType": {
+              "type": "string"
+            },
+            "nextActionDeadline": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "openTime": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "outcome": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "outcomes": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "label": {
+                    "type": "string"
+                  },
+                  "pricePercent": {
+                    "anyOf": [
+                      {
+                        "maximum": 100,
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "label",
+                  "pricePercent"
+                ],
+                "type": "object"
+              },
+              "maxItems": 3,
+              "minItems": 2,
+              "type": "array"
+            },
+            "prices": {
+              "additionalProperties": false,
+              "properties": {
+                "outcome1": {
+                  "anyOf": [
+                    {
+                      "maximum": 1,
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "outcome2": {
+                  "anyOf": [
+                    {
+                      "maximum": 1,
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "outcome3": {
+                  "anyOf": [
+                    {
+                      "maximum": 1,
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "pricingModel": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "question": {
+              "type": "string"
+            },
+            "resolutionCriteria": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "resolutionSource": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "resolutionTime": {
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+              "type": "string"
+            },
+            "settlement": {
+              "enum": [
+                "onchain",
+                "committed"
+              ],
+              "type": "string"
+            },
+            "sourceToken": {
+              "additionalProperties": false,
+              "properties": {
+                "side": {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "tokenId": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "tokenId",
+                "side"
+              ],
+              "type": "object"
+            },
+            "stageDeadline": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "supportsVoid": {
+              "type": "boolean"
+            },
+            "tradingEndsAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "volume": {
+              "$ref": "#/$defs/WeiString"
+            },
+            "volume24h": {
+              "$ref": "#/$defs/WeiString"
+            },
+            "volumePm": {
+              "additionalProperties": false,
+              "properties": {
+                "last24hPm": {
+                  "pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,6})?$",
+                  "type": "string"
+                },
+                "lifetimePm": {
+                  "pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,6})?$",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "lifetimePm",
+                "last24hPm"
+              ],
+              "type": "object"
+            }
+          },
+          "required": [
+            "id",
+            "address",
+            "chainId",
+            "question",
+            "category",
+            "marketState",
+            "tradingEndsAt",
+            "lifecycleStage",
+            "stageDeadline",
+            "isTernary",
+            "outcome",
+            "marketType",
+            "finality",
+            "pricingModel",
+            "openTime",
+            "closeTime",
+            "resolutionTime",
+            "creatorResolveBy",
+            "challengeBy",
+            "humanVote",
+            "councilReviewEndsAt",
+            "nextActionDeadline",
+            "actions",
+            "createdAt",
+            "collateralToken",
+            "language",
+            "volume"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "nextCursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "questions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "category": {
+              "type": "string"
+            },
+            "endsAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "marketAddress": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/EvmAddress"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "options": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "label": {
+                    "type": "string"
+                  },
+                  "price": {
+                    "anyOf": [
+                      {
+                        "maximum": 1,
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "label",
+                  "price"
+                ],
+                "type": "object"
+              },
+              "maxItems": 4,
+              "type": "array"
+            },
+            "slug": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "format": "uri",
+              "type": "string"
+            },
+            "volume24hUsd": {
+              "anyOf": [
+                {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "slug",
+            "title",
+            "url",
+            "category",
+            "endsAt",
+            "options",
+            "volume24hUsd",
+            "marketAddress"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "markets",
+      "hasMore",
+      "nextCursor"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedNov 5, 2026

addedOutput schema / $defs / DiscoverMarketsResponse / properties / questions

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "category": {
+        "type": "string"
+      },
+      "endsAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "marketAddress": {
+        "anyOf": [
+          {
+            "$ref": "#/$defs/EvmAddress"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "price": {
+              "anyOf": [
+                {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "label",
+            "price"
+          ],
+          "type": "object"
+        },
+        "maxItems": 4,
+        "type": "array"
+      },
+      "slug": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "url": {
+        "format": "uri",
+        "type": "string"
+      },
+      "volume24hUsd": {
+        "anyOf": [
+          {
+            "minimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "slug",
+      "title",
+      "url",
+      "category",
+      "endsAt",
+      "options",
+      "volume24hUsd",
+      "marketAddress"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed1 schema field changedOct 27, 2026

changedOutput schema / $defs / ErrorReason / enum

Previous value: -[
-  "AUTH_REQUIRED",
-  "WALLET_AUTH_REQUIRED",
-  "WALLET_AUTH_INVALID",
-  "INSUFFICIENT_TIER",
-  "FORBIDDEN",
-  "FEATURE_DISABLED",
-  "SERVICE_UNAVAILABLE_IN_REGION",
-  "NOT_ORB_VERIFIED",
-  "NOT_AUTHORIZED",
-  "NOT_MARKET_CREATOR",
-  "CALLER_NOT_CREATOR",
-  "AGENT_WALLET_CANNOT_VOTE",
-  "WALLET_REQUIRED",
-  "EMAIL_NOT_VERIFIED",
-  "EMAIL_ALREADY_REGISTERED",
-  "WALLET_ADDRESS_MISMATCH",
-  "WALLET_PARAM_NOT_ALLOWED",
-  "OWNER_ID_MISMATCH",
-  "OWNERSHIP_MISMATCH",
-  "OWNERSHIP_PROOF_REQUIRED",
-  "WALLET_MISMATCH",
-  "KEY_LIMIT_REACHED",
-  "SCOPE_WIDENING_DENIED",
-  "INVALID_REQUEST",
-  "INVALID_PAYLOAD",
-  "INVALID_QUERY",
-  "INVALID_HEADER",
-  "MISSING_FIELDS",
-  "INVALID_ID",
-  "INVALID_SCOPES",
-  "INVALID_SPENDING_LIMIT",
-  "INVALID_EXPIRES_AT",
-  "INVALID_WEBHOOK_URL",
-  "WEBHOOK_LIMIT_REACHED",
-  "KEY_ALREADY_REVOKED",
-  "MARKET_ID_REQUIRED",
-  "INVALID_OUTCOME",
-  "INVALID_CHAIN",
-  "INVALID_COLLATERAL",
-  "MISSING_COLLATERAL",
-  "INVALID_QUESTION",
-  "QUESTION_TOO_LONG",
-  "INVALID_SNAPSHOT",
-  "BATCH_TOO_LARGE",
-  "MAX_DEPTH_EXCEEDED",
-  "AMOUNT_ABOVE_MAXIMUM",
-  "AMOUNT_BELOW_MINIMUM",
-  "AMOUNT_BELOW_MINIMUM_FILL",
-  "AMOUNT_NOT_MULTIPLE",
-  "PRICE_OFF_TICK",
-  "ORDER_EXPIRY_TOO_SOON",
-  "BELOW_MINIMUM",
-  "OUTCOME_UNKNOWN",
-  "NOT_TWO_OUTCOMES",
-  "EXPIRY_TOO_SOON",
-  "MARKET_UNAVAILABLE",
-  "TRADING_ENDED",
-  "NO_LIQUIDITY",
-  "INSUFFICIENT_BALANCE",
-  "PAYLOAD_TOO_LARGE",
-  "PRIVATE_MARKET",
-  "INVALID_MARKET_REQUIRED",
-  "INVALID_MARKET_PAIR",
-  "PREFLIGHT_FAILED",
-  "PROPOSAL_FAILED",
-  "ACCEPT_FAILED",
-  "REJECT_FAILED",
-  "CONTENT_BLOCKED",
-  "SECURITY_RISK_BLOCKED",
-  "NO_PENDING_FEES",
-  "BAD_REQUEST",
-  "CORS_REJECTED",
-  "UNSUPPORTED_CHAIN",
-  "WORLD_ID_VERIFICATION_FAILED",
-  "REVOCATION_REQUIRES_ROOT",
-  "RECOVERY_REQUIRES_ROOT",
-  "IDENTITY_ALREADY_ENROLLED",
-  "RECOVERY_NOT_CONFIGURED",
-  "RECOVERY_KEY_INVALID",
-  "WORLD_ID_REVERIFICATION_REQUIRED",
-  "ROOT_RECOVERY_COOLDOWN",
-  "NOT_FOUND",
-  "MARKET_NOT_FOUND",
-  "MARKET_PRIOR_RELEASE",
-  "AGENT_NOT_FOUND",
-  "CHAIN_NOT_FOUND",
-  "PARENT_NOT_FOUND",
-  "FACTORY_NOT_DEPLOYED",
-  "KEY_NOT_FOUND",
-  "API_KEY_NOT_FOUND",
-  "WEBHOOK_NOT_FOUND",
-  "BUILDER_ID_NOT_FOUND",
-  "NO_API_KEYS",
-  "SEASON_NOT_FOUND",
-  "COHORT_NOT_FOUND",
-  "MARKET_CLOSED",
-  "MARKET_NOT_OPEN_YET",
-  "NOT_RESOLVABLE_YET",
-  "EXPIRED_TOKEN",
-  "ENDPOINT_RETIRED",
-  "CONFLICT",
-  "HEARTBEAT_SESSION_CONFLICT",
-  "HEARTBEAT_SESSION_REVISION_EXHAUSTED",
-  "SEASON_STATE_CONFLICT",
-  "MARKET_NOT_LIVE",
-  "MARKET_NOT_RESOLVED",
-  "CONTENT_SEALED",
-  "TIMING_SEALED",
-  "STALE_UPDATE",
-  "ALREADY_RESOLVED",
-  "CREATOR_WINDOW_ELAPSED",
-  "RELAY_REVERTED",
-  "HUMAN_VOTE_ACTIVE",
-  "CHALLENGE_WINDOW_CLOSED",
-  "COUNCIL_REVIEW_ACTIVE",
-  "MARKET_NOT_PENDING_RESOLUTION",
-  "ALREADY_SWEPT",
-  "SWEEP_IN_PROGRESS",
-  "DUPLICATE_CONTENT",
-  "AGENT_ALREADY_EXISTS",
-  "NAME_TAKEN",
-  "AMBIGUOUS_MARKET_ADDRESS",
-  "IDEMPOTENCY_KEY_CONFLICT",
-  "NONCE_REUSED",
-  "KEY_GENERATION_CONFLICT",
-  "MARKET_INSOLVENT",
-  "SLIPPAGE_EXCEEDED",
-  "INSUFFICIENT_ALLOWANCE",
-  "OPERATOR_APPROVAL_REQUIRED",
-  "INSUFFICIENT_DEPOSIT",
-  "INSUFFICIENT_PULL",
-  "SALE_PAUSED",
-  "SALE_INVENTORY_SHORT",
-  "QUOTE_MISMATCH",
-  "INSUFFICIENT_PAYMENT_BALANCE",
-  "PURCHASE_NOT_A_BUNDLE",
-  "PURCHASE_CAP_EXCEEDED",
-  "FILL_ALLOWANCE_EXHAUSTED",
-  "SPONSORED_TRADING_PAUSED",
-  "PASSKEY_REQUIRED",
-  "ACCOUNT_RESTRICTED",
-  "NOT_VERIFIED",
-  "STAKE_REQUIRED",
-  "STAKE_INTENT_INVALID",
-  "INSUFFICIENT_PM_FOR_VOTE_STAKE",
-  "STAKE_PULL_FAILED",
-  "VERIFIED_HUMAN_REQUIRED",
-  "CREATION_SLOTS_FULL",
-  "CREATOR_NOT_ADMITTED",
-  "CREATOR_CAPACITY_REACHED",
-  "REPUTATION_TOO_LOW",
-  "CONCURRENT_LIMIT_REACHED",
-  "LIFETIME_LIMIT_REACHED",
-  "CREATION_COOLDOWN_ACTIVE",
-  "SEED_LIMIT_EXCEEDED",
-  "DURATION_OUT_OF_RANGE",
-  "ACTIVE_VERIFIED_IDENTITY_REQUIRED",
-  "CURRENT_IDENTITY_MEMBERSHIP_REQUIRED",
-  "AGENT_OPERATING_WALLET_NOT_LINKED",
-  "IDENTITY_INTEGRITY_UNKNOWN",
-  "PARTICIPATION_RELEASE_NOT_DEPLOYED",
-  "PARTICIPATION_RELEASE_ROUTE_NOT_DEPLOYED",
-  "PARTICIPATION_PROFILE_MISMATCH",
-  "PARTICIPATION_RELEASE_INACTIVE",
-  "PARTICIPATION_DISTRIBUTION_PAUSED",
-  "PARTICIPATION_MONEY_PATH_INCOMPLETE",
-  "PARTICIPATION_LEDGER_ACCOUNTING_INVALID",
-  "PARTICIPATION_ROUTE_DEGRADED",
-  "PARTICIPATION_ROUTE_QUARANTINED",
-  "PARTICIPATION_INVENTORY_LOW",
-  "NO_PARTICIPATION_RELEASE_CREDITS",
-  "NEW_PARTICIPATION_RELEASE_UNITS_EXHAUSTED",
-  "PARTICIPATION_CLAIM_CADENCE_ACTIVE",
-  "PARTICIPATION_IDENTITY_ATTESTATION_REQUIRED",
-  "PARTICIPATION_DISTRIBUTION_ZERO_DELTA",
-  "PARTICIPATION_DISTRIBUTION_ALREADY_PREPARED",
-  "PARTICIPATION_DISTRIBUTION_RECIPIENT_STALE",
-  "PARTICIPATION_DISTRIBUTION_VOUCHER_EXPIRED",
-  "PARTICIPATION_DISTRIBUTION_EVENT_MISMATCH",
-  "PARTICIPATION_DISTRIBUTION_FINALITY_PENDING",
-  "RATE_LIMITED",
-  "INTERNAL_ERROR",
-  "SERVICE_UNAVAILABLE",
-  "ELIGIBILITY_UNDETERMINED",
-  "COLLATERAL_CONFIGURATION_MISMATCH",
-  "QUOTE_STATE_UNAVAILABLE",
-  "PROTOCOL_UNAVAILABLE",
-  "PROTOCOL_PAUSED",
-  "VENUE_HALTED",
-  "EMBED_ATTRIBUTION_UNAVAILABLE",
-  "QUOTE_FAILED",
-  "INVALID_MARKET_STATE",
-  "MATH_OVERFLOW",
-  "UNKNOWN_CONTRACT_ERROR",
-  "DEADLINE_EXPIRED",
-  "ZERO_INPUT",
-  "ZERO_NET_INPUT",
-  "ZERO_DELTA",
-  "INVALID_MARKET",
-  "INVALID_TOKEN",
-  "NATIVE_ROUTE_UNAVAILABLE",
-  "POST_ONLY_WOULD_CROSS",
-  "FOK_UNFILLABLE",
-  "CLORDID_CONFLICT",
-  "QUOTE_SET_INVALID",
-  "QUOTE_GENERATION_STALE",
-  "ORDER_IN_FLIGHT",
-  "MAKER_NOT_EXECUTABLE",
-  "LIQUIDITY_CHANGED",
-  "CANCELLATION_EVENT_NOT_FOUND",
-  "CANCELLATION_EVENT_MISMATCH",
-  "INVALID_NONCE_FLOOR",
-  "NONCE_INVALIDATION_EVENT_NOT_FOUND",
-  "NONCE_INVALIDATION_EVENT_MISMATCH",
-  "INVALID_TX_HASH"
-]New value: +[
+  "AUTH_REQUIRED",
+  "WALLET_AUTH_REQUIRED",
+  "WALLET_AUTH_INVALID",
+  "INSUFFICIENT_TIER",
+  "FORBIDDEN",
+  "FEATURE_DISABLED",
+  "SERVICE_UNAVAILABLE_IN_REGION",
+  "NOT_ORB_VERIFIED",
+  "NOT_AUTHORIZED",
+  "NOT_MARKET_CREATOR",
+  "CALLER_NOT_CREATOR",
+  "AGENT_WALLET_CANNOT_VOTE",
+  "WALLET_REQUIRED",
+  "EMAIL_NOT_VERIFIED",
+  "EMAIL_ALREADY_REGISTERED",
+  "WALLET_ADDRESS_MISMATCH",
+  "WALLET_PARAM_NOT_ALLOWED",
+  "OWNER_ID_MISMATCH",
+  "OWNERSHIP_MISMATCH",
+  "OWNERSHIP_PROOF_REQUIRED",
+  "WALLET_MISMATCH",
+  "KEY_LIMIT_REACHED",
+  "SCOPE_WIDENING_DENIED",
+  "INVALID_REQUEST",
+  "INVALID_PAYLOAD",
+  "INVALID_QUERY",
+  "INVALID_HEADER",
+  "MISSING_FIELDS",
+  "INVALID_ID",
+  "INVALID_SCOPES",
+  "INVALID_SPENDING_LIMIT",
+  "INVALID_EXPIRES_AT",
+  "INVALID_WEBHOOK_URL",
+  "WEBHOOK_LIMIT_REACHED",
+  "KEY_ALREADY_REVOKED",
+  "MARKET_ID_REQUIRED",
+  "INVALID_OUTCOME",
+  "INVALID_CHAIN",
+  "INVALID_COLLATERAL",
+  "MISSING_COLLATERAL",
+  "INVALID_QUESTION",
+  "QUESTION_TOO_LONG",
+  "INVALID_SNAPSHOT",
+  "BATCH_TOO_LARGE",
+  "MAX_DEPTH_EXCEEDED",
+  "AMOUNT_ABOVE_MAXIMUM",
+  "AMOUNT_BELOW_MINIMUM",
+  "AMOUNT_BELOW_MINIMUM_FILL",
+  "AMOUNT_NOT_MULTIPLE",
+  "PRICE_OFF_TICK",
+  "ORDER_EXPIRY_TOO_SOON",
+  "BELOW_MINIMUM",
+  "OUTCOME_UNKNOWN",
+  "NOT_TWO_OUTCOMES",
+  "EXPIRY_TOO_SOON",
+  "MARKET_UNAVAILABLE",
+  "TRADING_ENDED",
+  "NO_LIQUIDITY",
+  "INSUFFICIENT_BALANCE",
+  "PAYLOAD_TOO_LARGE",
+  "PRIVATE_MARKET",
+  "INVALID_MARKET_REQUIRED",
+  "INVALID_MARKET_PAIR",
+  "PREFLIGHT_FAILED",
+  "PROPOSAL_FAILED",
+  "ACCEPT_FAILED",
+  "REJECT_FAILED",
+  "CONTENT_BLOCKED",
+  "SECURITY_RISK_BLOCKED",
+  "NO_PENDING_FEES",
+  "BAD_REQUEST",
+  "CORS_REJECTED",
+  "UNSUPPORTED_CHAIN",
+  "WORLD_ID_VERIFICATION_FAILED",
+  "REVOCATION_REQUIRES_ROOT",
+  "RECOVERY_REQUIRES_ROOT",
+  "IDENTITY_ALREADY_ENROLLED",
+  "RECOVERY_NOT_CONFIGURED",
+  "RECOVERY_KEY_INVALID",
+  "WORLD_ID_REVERIFICATION_REQUIRED",
+  "ROOT_RECOVERY_COOLDOWN",
+  "NOT_FOUND",
+  "MARKET_NOT_FOUND",
+  "MARKET_PRIOR_RELEASE",
+  "AGENT_NOT_FOUND",
+  "CHAIN_NOT_FOUND",
+  "PARENT_NOT_FOUND",
+  "FACTORY_NOT_DEPLOYED",
+  "KEY_NOT_FOUND",
+  "API_KEY_NOT_FOUND",
+  "WEBHOOK_NOT_FOUND",
+  "BUILDER_ID_NOT_FOUND",
+  "NO_API_KEYS",
+  "SEASON_NOT_FOUND",
+  "COHORT_NOT_FOUND",
+  "MARKET_CLOSED",
+  "MARKET_NOT_OPEN_YET",
+  "NOT_RESOLVABLE_YET",
+  "EXPIRED_TOKEN",
+  "ENDPOINT_RETIRED",
+  "CONFLICT",
+  "HEARTBEAT_SESSION_CONFLICT",
+  "HEARTBEAT_SESSION_REVISION_EXHAUSTED",
+  "SEASON_STATE_CONFLICT",
+  "MARKET_NOT_LIVE",
+  "MARKET_NOT_RESOLVED",
+  "CONTENT_SEALED",
+  "TIMING_SEALED",
+  "STALE_UPDATE",
+  "CATALOG_CHANGED",
+  "ALREADY_RESOLVED",
+  "CREATOR_WINDOW_ELAPSED",
+  "RELAY_REVERTED",
+  "HUMAN_VOTE_ACTIVE",
+  "CHALLENGE_WINDOW_CLOSED",
+  "COUNCIL_REVIEW_ACTIVE",
+  "MARKET_NOT_PENDING_RESOLUTION",
+  "ALREADY_SWEPT",
+  "SWEEP_IN_PROGRESS",
+  "DUPLICATE_CONTENT",
+  "AGENT_ALREADY_EXISTS",
+  "NAME_TAKEN",
+  "AMBIGUOUS_MARKET_ADDRESS",
+  "IDEMPOTENCY_KEY_CONFLICT",
+  "NONCE_REUSED",
+  "KEY_GENERATION_CONFLICT",
+  "MARKET_INSOLVENT",
+  "SLIPPAGE_EXCEEDED",
+  "INSUFFICIENT_ALLOWANCE",
+  "OPERATOR_APPROVAL_REQUIRED",
+  "INSUFFICIENT_DEPOSIT",
+  "INSUFFICIENT_PULL",
+  "SALE_PAUSED",
+  "SALE_INVENTORY_SHORT",
+  "QUOTE_MISMATCH",
+  "INSUFFICIENT_PAYMENT_BALANCE",
+  "PURCHASE_NOT_A_BUNDLE",
+  "PURCHASE_CAP_EXCEEDED",
+  "FILL_ALLOWANCE_EXHAUSTED",
+  "SPONSORED_TRADING_PAUSED",
+  "PASSKEY_REQUIRED",
+  "ACCOUNT_RESTRICTED",
+  "NOT_VERIFIED",
+  "STAKE_REQUIRED",
+  "STAKE_INTENT_INVALID",
+  "INSUFFICIENT_PM_FOR_VOTE_STAKE",
+  "STAKE_PULL_FAILED",
+  "VERIFIED_HUMAN_REQUIRED",
+  "CREATION_SLOTS_FULL",
+  "CREATOR_NOT_ADMITTED",
+  "CREATOR_CAPACITY_REACHED",
+  "REPUTATION_TOO_LOW",
+  "CONCURRENT_LIMIT_REACHED",
+  "LIFETIME_LIMIT_REACHED",
+  "CREATION_COOLDOWN_ACTIVE",
+  "SEED_LIMIT_EXCEEDED",
+  "DURATION_OUT_OF_RANGE",
+  "ACTIVE_VERIFIED_IDENTITY_REQUIRED",
+  "CURRENT_IDENTITY_MEMBERSHIP_REQUIRED",
+  "AGENT_OPERATING_WALLET_NOT_LINKED",
+  "IDENTITY_INTEGRITY_UNKNOWN",
+  "PARTICIPATION_RELEASE_NOT_DEPLOYED",
+  "PARTICIPATION_RELEASE_ROUTE_NOT_DEPLOYED",
+  "PARTICIPATION_PROFILE_MISMATCH",
+  "PARTICIPATION_RELEASE_INACTIVE",
+  "PARTICIPATION_DISTRIBUTION_PAUSED",
+  "PARTICIPATION_MONEY_PATH_INCOMPLETE",
+  "PARTICIPATION_LEDGER_ACCOUNTING_INVALID",
+  "PARTICIPATION_ROUTE_DEGRADED",
+  "PARTICIPATION_ROUTE_QUARANTINED",
+  "PARTICIPATION_INVENTORY_LOW",
+  "NO_PARTICIPATION_RELEASE_CREDITS",
+  "NEW_PARTICIPATION_RELEASE_UNITS_EXHAUSTED",
+  "PARTICIPATION_CLAIM_CADENCE_ACTIVE",
+  "PARTICIPATION_IDENTITY_ATTESTATION_REQUIRED",
+  "PARTICIPATION_DISTRIBUTION_ZERO_DELTA",
+  "PARTICIPATION_DISTRIBUTION_ALREADY_PREPARED",
+  "PARTICIPATION_DISTRIBUTION_RECIPIENT_STALE",
+  "PARTICIPATION_DISTRIBUTION_VOUCHER_EXPIRED",
+  "PARTICIPATION_DISTRIBUTION_EVENT_MISMATCH",
+  "PARTICIPATION_DISTRIBUTION_FINALITY_PENDING",
+  "RATE_LIMITED",
+  "INTERNAL_ERROR",
+  "SERVICE_UNAVAILABLE",
+  "ELIGIBILITY_UNDETERMINED",
+  "COLLATERAL_CONFIGURATION_MISMATCH",
+  "QUOTE_STATE_UNAVAILABLE",
+  "PROTOCOL_UNAVAILABLE",
+  "PROTOCOL_PAUSED",
+  "VENUE_HALTED",
+  "EMBED_ATTRIBUTION_UNAVAILABLE",
+  "QUOTE_FAILED",
+  "INVALID_MARKET_STATE",
+  "MATH_OVERFLOW",
+  "UNKNOWN_CONTRACT_ERROR",
+  "DEADLINE_EXPIRED",
+  "ZERO_INPUT",
+  "ZERO_NET_INPUT",
+  "ZERO_DELTA",
+  "INVALID_MARKET",
+  "INVALID_TOKEN",
+  "NATIVE_ROUTE_UNAVAILABLE",
+  "POST_ONLY_WOULD_CROSS",
+  "FOK_UNFILLABLE",
+  "CLORDID_CONFLICT",
+  "QUOTE_SET_INVALID",
+  "QUOTE_GENERATION_STALE",
+  "ORDER_IN_FLIGHT",
+  "MAKER_NOT_EXECUTABLE",
+  "LIQUIDITY_CHANGED",
+  "CANCELLATION_EVENT_NOT_FOUND",
+  "CANCELLATION_EVENT_MISMATCH",
+  "INVALID_NONCE_FLOOR",
+  "NONCE_INVALIDATION_EVENT_NOT_FOUND",
+  "NONCE_INVALIDATION_EVENT_MISMATCH",
+  "INVALID_TX_HASH"
+]

Changed3 schema fields changedOct 6, 2026

addedInput schema / properties / sourceConditionId

Added value: +{
+  "description": "Source market condition ID: lists the markets whose `resolutionSource` is `{type: 'polymarket', conditionId}` with this ID.",
+  "pattern": "^0x[0-9a-fA-F]{64}$",
+  "type": "string"
+}

addedInput schema / properties / sourceTokenId

Added value: +{
+  "description": "Source outcome token ID, in decimal as the source market's orders name it: lists the market that follows it, each row carrying `sourceToken.side`, the order side that is that outcome.",
+  "pattern": "^[0-9]{1,78}$",
+  "type": "string"
+}

addedOutput schema / $defs / DiscoverMarketsResponse / properties / markets / items / properties / sourceToken

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "side": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "tokenId": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "tokenId",
+    "side"
+  ],
+  "type": "object"
+}

Changed4 schema fields changedOct 2, 2026

addedOutput schema / $defs / DiscoverMarketsResponse / properties / markets / items / properties / marketReference

Added value: +{
+  "pattern": "^mkt_[\\da-f]{8}-[\\da-f]{4}-[\\da-f]{4}-[\\da-f]{4}-[\\da-f]{12}$",
+  "type": "string"
+}

addedOutput schema / $defs / DiscoverMarketsResponse / properties / markets / items / properties / outcomes

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "label": {
+        "type": "string"
+      },
+      "pricePercent": {
+        "anyOf": [
+          {
+            "maximum": 100,
+            "minimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "label",
+      "pricePercent"
+    ],
+    "type": "object"
+  },
+  "maxItems": 3,
+  "minItems": 2,
+  "type": "array"
+}

addedOutput schema / $defs / DiscoverMarketsResponse / properties / markets / items / properties / volumePm

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "last24hPm": {
+      "pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,6})?$",
+      "type": "string"
+    },
+    "lifetimePm": {
+      "pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,6})?$",
+      "type": "string"
+    }
+  },
+  "required": [
+    "lifetimePm",
+    "last24hPm"
+  ],
+  "type": "object"
+}

changedOutput schema / $defs / ErrorReason / enum

Previous value: -[
-  "AUTH_REQUIRED",
-  "WALLET_AUTH_REQUIRED",
-  "WALLET_AUTH_INVALID",
-  "INSUFFICIENT_TIER",
-  "FORBIDDEN",
-  "FEATURE_DISABLED",
-  "SERVICE_UNAVAILABLE_IN_REGION",
-  "NOT_ORB_VERIFIED",
-  "NOT_AUTHORIZED",
-  "NOT_MARKET_CREATOR",
-  "CALLER_NOT_CREATOR",
-  "AGENT_WALLET_CANNOT_VOTE",
-  "WALLET_REQUIRED",
-  "EMAIL_NOT_VERIFIED",
-  "EMAIL_ALREADY_REGISTERED",
-  "WALLET_ADDRESS_MISMATCH",
-  "WALLET_PARAM_NOT_ALLOWED",
-  "OWNER_ID_MISMATCH",
-  "OWNERSHIP_MISMATCH",
-  "OWNERSHIP_PROOF_REQUIRED",
-  "WALLET_MISMATCH",
-  "KEY_LIMIT_REACHED",
-  "SCOPE_WIDENING_DENIED",
-  "INVALID_REQUEST",
-  "INVALID_PAYLOAD",
-  "INVALID_QUERY",
-  "INVALID_HEADER",
-  "MISSING_FIELDS",
-  "INVALID_ID",
-  "INVALID_SCOPES",
-  "INVALID_SPENDING_LIMIT",
-  "INVALID_EXPIRES_AT",
-  "INVALID_WEBHOOK_URL",
-  "WEBHOOK_LIMIT_REACHED",
-  "KEY_ALREADY_REVOKED",
-  "MARKET_ID_REQUIRED",
-  "INVALID_OUTCOME",
-  "INVALID_CHAIN",
-  "INVALID_COLLATERAL",
-  "MISSING_COLLATERAL",
-  "INVALID_QUESTION",
-  "QUESTION_TOO_LONG",
-  "INVALID_SNAPSHOT",
-  "BATCH_TOO_LARGE",
-  "MAX_DEPTH_EXCEEDED",
-  "AMOUNT_ABOVE_MAXIMUM",
-  "AMOUNT_BELOW_MINIMUM",
-  "AMOUNT_BELOW_MINIMUM_FILL",
-  "AMOUNT_NOT_MULTIPLE",
-  "PRICE_OFF_TICK",
-  "ORDER_EXPIRY_TOO_SOON",
-  "PAYLOAD_TOO_LARGE",
-  "PRIVATE_MARKET",
-  "INVALID_MARKET_REQUIRED",
-  "INVALID_MARKET_PAIR",
-  "PREFLIGHT_FAILED",
-  "PROPOSAL_FAILED",
-  "ACCEPT_FAILED",
-  "REJECT_FAILED",
-  "CONTENT_BLOCKED",
-  "SECURITY_RISK_BLOCKED",
-  "NO_PENDING_FEES",
-  "BAD_REQUEST",
-  "CORS_REJECTED",
-  "UNSUPPORTED_CHAIN",
-  "WORLD_ID_VERIFICATION_FAILED",
-  "REVOCATION_REQUIRES_ROOT",
-  "RECOVERY_REQUIRES_ROOT",
-  "IDENTITY_ALREADY_ENROLLED",
-  "RECOVERY_NOT_CONFIGURED",
-  "RECOVERY_KEY_INVALID",
-  "WORLD_ID_REVERIFICATION_REQUIRED",
-  "ROOT_RECOVERY_COOLDOWN",
-  "NOT_FOUND",
-  "MARKET_NOT_FOUND",
-  "MARKET_PRIOR_RELEASE",
-  "AGENT_NOT_FOUND",
-  "CHAIN_NOT_FOUND",
-  "PARENT_NOT_FOUND",
-  "FACTORY_NOT_DEPLOYED",
-  "KEY_NOT_FOUND",
-  "API_KEY_NOT_FOUND",
-  "WEBHOOK_NOT_FOUND",
-  "BUILDER_ID_NOT_FOUND",
-  "NO_API_KEYS",
-  "SEASON_NOT_FOUND",
-  "COHORT_NOT_FOUND",
-  "MARKET_CLOSED",
-  "MARKET_NOT_OPEN_YET",
-  "NOT_RESOLVABLE_YET",
-  "EXPIRED_TOKEN",
-  "ENDPOINT_RETIRED",
-  "CONFLICT",
-  "HEARTBEAT_SESSION_CONFLICT",
-  "HEARTBEAT_SESSION_REVISION_EXHAUSTED",
-  "SEASON_STATE_CONFLICT",
-  "MARKET_NOT_LIVE",
-  "MARKET_NOT_RESOLVED",
-  "CONTENT_SEALED",
-  "TIMING_SEALED",
-  "STALE_UPDATE",
-  "ALREADY_RESOLVED",
-  "CREATOR_WINDOW_ELAPSED",
-  "RELAY_REVERTED",
-  "HUMAN_VOTE_ACTIVE",
-  "CHALLENGE_WINDOW_CLOSED",
-  "COUNCIL_REVIEW_ACTIVE",
-  "MARKET_NOT_PENDING_RESOLUTION",
-  "ALREADY_SWEPT",
-  "SWEEP_IN_PROGRESS",
-  "DUPLICATE_CONTENT",
-  "AGENT_ALREADY_EXISTS",
-  "NAME_TAKEN",
-  "AMBIGUOUS_MARKET_ADDRESS",
-  "IDEMPOTENCY_KEY_CONFLICT",
-  "NONCE_REUSED",
-  "KEY_GENERATION_CONFLICT",
-  "MARKET_INSOLVENT",
-  "SLIPPAGE_EXCEEDED",
-  "INSUFFICIENT_ALLOWANCE",
-  "OPERATOR_APPROVAL_REQUIRED",
-  "INSUFFICIENT_DEPOSIT",
-  "INSUFFICIENT_PULL",
-  "SALE_PAUSED",
-  "SALE_INVENTORY_SHORT",
-  "QUOTE_MISMATCH",
-  "INSUFFICIENT_PAYMENT_BALANCE",
-  "PURCHASE_NOT_A_BUNDLE",
-  "PURCHASE_CAP_EXCEEDED",
-  "FILL_ALLOWANCE_EXHAUSTED",
-  "SPONSORED_TRADING_PAUSED",
-  "PASSKEY_REQUIRED",
-  "ACCOUNT_RESTRICTED",
-  "NOT_VERIFIED",
-  "STAKE_REQUIRED",
-  "STAKE_INTENT_INVALID",
-  "INSUFFICIENT_PM_FOR_VOTE_STAKE",
-  "STAKE_PULL_FAILED",
-  "VERIFIED_HUMAN_REQUIRED",
-  "CREATION_SLOTS_FULL",
-  "CREATOR_NOT_ADMITTED",
-  "CREATOR_CAPACITY_REACHED",
-  "REPUTATION_TOO_LOW",
-  "CONCURRENT_LIMIT_REACHED",
-  "LIFETIME_LIMIT_REACHED",
-  "CREATION_COOLDOWN_ACTIVE",
-  "SEED_LIMIT_EXCEEDED",
-  "DURATION_OUT_OF_RANGE",
-  "ACTIVE_VERIFIED_IDENTITY_REQUIRED",
-  "CURRENT_IDENTITY_MEMBERSHIP_REQUIRED",
-  "AGENT_OPERATING_WALLET_NOT_LINKED",
-  "IDENTITY_INTEGRITY_UNKNOWN",
-  "PARTICIPATION_RELEASE_NOT_DEPLOYED",
-  "PARTICIPATION_RELEASE_ROUTE_NOT_DEPLOYED",
-  "PARTICIPATION_PROFILE_MISMATCH",
-  "PARTICIPATION_RELEASE_INACTIVE",
-  "PARTICIPATION_DISTRIBUTION_PAUSED",
-  "PARTICIPATION_MONEY_PATH_INCOMPLETE",
-  "PARTICIPATION_LEDGER_ACCOUNTING_INVALID",
-  "PARTICIPATION_ROUTE_DEGRADED",
-  "PARTICIPATION_ROUTE_QUARANTINED",
-  "PARTICIPATION_INVENTORY_LOW",
-  "NO_PARTICIPATION_RELEASE_CREDITS",
-  "NEW_PARTICIPATION_RELEASE_UNITS_EXHAUSTED",
-  "PARTICIPATION_CLAIM_CADENCE_ACTIVE",
-  "PARTICIPATION_IDENTITY_ATTESTATION_REQUIRED",
-  "PARTICIPATION_DISTRIBUTION_ZERO_DELTA",
-  "PARTICIPATION_DISTRIBUTION_ALREADY_PREPARED",
-  "PARTICIPATION_DISTRIBUTION_RECIPIENT_STALE",
-  "PARTICIPATION_DISTRIBUTION_VOUCHER_EXPIRED",
-  "PARTICIPATION_DISTRIBUTION_EVENT_MISMATCH",
-  "PARTICIPATION_DISTRIBUTION_FINALITY_PENDING",
-  "RATE_LIMITED",
-  "INTERNAL_ERROR",
-  "SERVICE_UNAVAILABLE",
-  "ELIGIBILITY_UNDETERMINED",
-  "COLLATERAL_CONFIGURATION_MISMATCH",
-  "QUOTE_STATE_UNAVAILABLE",
-  "PROTOCOL_UNAVAILABLE",
-  "PROTOCOL_PAUSED",
-  "VENUE_HALTED",
-  "EMBED_ATTRIBUTION_UNAVAILABLE",
-  "QUOTE_FAILED",
-  "INVALID_MARKET_STATE",
-  "MATH_OVERFLOW",
-  "UNKNOWN_CONTRACT_ERROR",
-  "DEADLINE_EXPIRED",
-  "ZERO_INPUT",
-  "ZERO_NET_INPUT",
-  "ZERO_DELTA",
-  "INVALID_MARKET",
-  "INVALID_TOKEN",
-  "NATIVE_ROUTE_UNAVAILABLE",
-  "POST_ONLY_WOULD_CROSS",
-  "FOK_UNFILLABLE",
-  "CLORDID_CONFLICT",
-  "QUOTE_SET_INVALID",
-  "QUOTE_GENERATION_STALE",
-  "ORDER_IN_FLIGHT",
-  "MAKER_NOT_EXECUTABLE",
-  "LIQUIDITY_CHANGED",
-  "CANCELLATION_EVENT_NOT_FOUND",
-  "CANCELLATION_EVENT_MISMATCH",
-  "INVALID_NONCE_FLOOR",
-  "NONCE_INVALIDATION_EVENT_NOT_FOUND",
-  "NONCE_INVALIDATION_EVENT_MISMATCH",
-  "INVALID_TX_HASH"
-]New value: +[
+  "AUTH_REQUIRED",
+  "WALLET_AUTH_REQUIRED",
+  "WALLET_AUTH_INVALID",
+  "INSUFFICIENT_TIER",
+  "FORBIDDEN",
+  "FEATURE_DISABLED",
+  "SERVICE_UNAVAILABLE_IN_REGION",
+  "NOT_ORB_VERIFIED",
+  "NOT_AUTHORIZED",
+  "NOT_MARKET_CREATOR",
+  "CALLER_NOT_CREATOR",
+  "AGENT_WALLET_CANNOT_VOTE",
+  "WALLET_REQUIRED",
+  "EMAIL_NOT_VERIFIED",
+  "EMAIL_ALREADY_REGISTERED",
+  "WALLET_ADDRESS_MISMATCH",
+  "WALLET_PARAM_NOT_ALLOWED",
+  "OWNER_ID_MISMATCH",
+  "OWNERSHIP_MISMATCH",
+  "OWNERSHIP_PROOF_REQUIRED",
+  "WALLET_MISMATCH",
+  "KEY_LIMIT_REACHED",
+  "SCOPE_WIDENING_DENIED",
+  "INVALID_REQUEST",
+  "INVALID_PAYLOAD",
+  "INVALID_QUERY",
+  "INVALID_HEADER",
+  "MISSING_FIELDS",
+  "INVALID_ID",
+  "INVALID_SCOPES",
+  "INVALID_SPENDING_LIMIT",
+  "INVALID_EXPIRES_AT",
+  "INVALID_WEBHOOK_URL",
+  "WEBHOOK_LIMIT_REACHED",
+  "KEY_ALREADY_REVOKED",
+  "MARKET_ID_REQUIRED",
+  "INVALID_OUTCOME",
+  "INVALID_CHAIN",
+  "INVALID_COLLATERAL",
+  "MISSING_COLLATERAL",
+  "INVALID_QUESTION",
+  "QUESTION_TOO_LONG",
+  "INVALID_SNAPSHOT",
+  "BATCH_TOO_LARGE",
+  "MAX_DEPTH_EXCEEDED",
+  "AMOUNT_ABOVE_MAXIMUM",
+  "AMOUNT_BELOW_MINIMUM",
+  "AMOUNT_BELOW_MINIMUM_FILL",
+  "AMOUNT_NOT_MULTIPLE",
+  "PRICE_OFF_TICK",
+  "ORDER_EXPIRY_TOO_SOON",
+  "BELOW_MINIMUM",
+  "OUTCOME_UNKNOWN",
+  "NOT_TWO_OUTCOMES",
+  "EXPIRY_TOO_SOON",
+  "MARKET_UNAVAILABLE",
+  "TRADING_ENDED",
+  "NO_LIQUIDITY",
+  "INSUFFICIENT_BALANCE",
+  "PAYLOAD_TOO_LARGE",
+  "PRIVATE_MARKET",
+  "INVALID_MARKET_REQUIRED",
+  "INVALID_MARKET_PAIR",
+  "PREFLIGHT_FAILED",
+  "PROPOSAL_FAILED",
+  "ACCEPT_FAILED",
+  "REJECT_FAILED",
+  "CONTENT_BLOCKED",
+  "SECURITY_RISK_BLOCKED",
+  "NO_PENDING_FEES",
+  "BAD_REQUEST",
+  "CORS_REJECTED",
+  "UNSUPPORTED_CHAIN",
+  "WORLD_ID_VERIFICATION_FAILED",
+  "REVOCATION_REQUIRES_ROOT",
+  "RECOVERY_REQUIRES_ROOT",
+  "IDENTITY_ALREADY_ENROLLED",
+  "RECOVERY_NOT_CONFIGURED",
+  "RECOVERY_KEY_INVALID",
+  "WORLD_ID_REVERIFICATION_REQUIRED",
+  "ROOT_RECOVERY_COOLDOWN",
+  "NOT_FOUND",
+  "MARKET_NOT_FOUND",
+  "MARKET_PRIOR_RELEASE",
+  "AGENT_NOT_FOUND",
+  "CHAIN_NOT_FOUND",
+  "PARENT_NOT_FOUND",
+  "FACTORY_NOT_DEPLOYED",
+  "KEY_NOT_FOUND",
+  "API_KEY_NOT_FOUND",
+  "WEBHOOK_NOT_FOUND",
+  "BUILDER_ID_NOT_FOUND",
+  "NO_API_KEYS",
+  "SEASON_NOT_FOUND",
+  "COHORT_NOT_FOUND",
+  "MARKET_CLOSED",
+  "MARKET_NOT_OPEN_YET",
+  "NOT_RESOLVABLE_YET",
+  "EXPIRED_TOKEN",
+  "ENDPOINT_RETIRED",
+  "CONFLICT",
+  "HEARTBEAT_SESSION_CONFLICT",
+  "HEARTBEAT_SESSION_REVISION_EXHAUSTED",
+  "SEASON_STATE_CONFLICT",
+  "MARKET_NOT_LIVE",
+  "MARKET_NOT_RESOLVED",
+  "CONTENT_SEALED",
+  "TIMING_SEALED",
+  "STALE_UPDATE",
+  "ALREADY_RESOLVED",
+  "CREATOR_WINDOW_ELAPSED",
+  "RELAY_REVERTED",
+  "HUMAN_VOTE_ACTIVE",
+  "CHALLENGE_WINDOW_CLOSED",
+  "COUNCIL_REVIEW_ACTIVE",
+  "MARKET_NOT_PENDING_RESOLUTION",
+  "ALREADY_SWEPT",
+  "SWEEP_IN_PROGRESS",
+  "DUPLICATE_CONTENT",
+  "AGENT_ALREADY_EXISTS",
+  "NAME_TAKEN",
+  "AMBIGUOUS_MARKET_ADDRESS",
+  "IDEMPOTENCY_KEY_CONFLICT",
+  "NONCE_REUSED",
+  "KEY_GENERATION_CONFLICT",
+  "MARKET_INSOLVENT",
+  "SLIPPAGE_EXCEEDED",
+  "INSUFFICIENT_ALLOWANCE",
+  "OPERATOR_APPROVAL_REQUIRED",
+  "INSUFFICIENT_DEPOSIT",
+  "INSUFFICIENT_PULL",
+  "SALE_PAUSED",
+  "SALE_INVENTORY_SHORT",
+  "QUOTE_MISMATCH",
+  "INSUFFICIENT_PAYMENT_BALANCE",
+  "PURCHASE_NOT_A_BUNDLE",
+  "PURCHASE_CAP_EXCEEDED",
+  "FILL_ALLOWANCE_EXHAUSTED",
+  "SPONSORED_TRADING_PAUSED",
+  "PASSKEY_REQUIRED",
+  "ACCOUNT_RESTRICTED",
+  "NOT_VERIFIED",
+  "STAKE_REQUIRED",
+  "STAKE_INTENT_INVALID",
+  "INSUFFICIENT_PM_FOR_VOTE_STAKE",
+  "STAKE_PULL_FAILED",
+  "VERIFIED_HUMAN_REQUIRED",
+  "CREATION_SLOTS_FULL",
+  "CREATOR_NOT_ADMITTED",
+  "CREATOR_CAPACITY_REACHED",
+  "REPUTATION_TOO_LOW",
+  "CONCURRENT_LIMIT_REACHED",
+  "LIFETIME_LIMIT_REACHED",
+  "CREATION_COOLDOWN_ACTIVE",
+  "SEED_LIMIT_EXCEEDED",
+  "DURATION_OUT_OF_RANGE",
+  "ACTIVE_VERIFIED_IDENTITY_REQUIRED",
+  "CURRENT_IDENTITY_MEMBERSHIP_REQUIRED",
+  "AGENT_OPERATING_WALLET_NOT_LINKED",
+  "IDENTITY_INTEGRITY_UNKNOWN",
+  "PARTICIPATION_RELEASE_NOT_DEPLOYED",
+  "PARTICIPATION_RELEASE_ROUTE_NOT_DEPLOYED",
+  "PARTICIPATION_PROFILE_MISMATCH",
+  "PARTICIPATION_RELEASE_INACTIVE",
+  "PARTICIPATION_DISTRIBUTION_PAUSED",
+  "PARTICIPATION_MONEY_PATH_INCOMPLETE",
+  "PARTICIPATION_LEDGER_ACCOUNTING_INVALID",
+  "PARTICIPATION_ROUTE_DEGRADED",
+  "PARTICIPATION_ROUTE_QUARANTINED",
+  "PARTICIPATION_INVENTORY_LOW",
+  "NO_PARTICIPATION_RELEASE_CREDITS",
+  "NEW_PARTICIPATION_RELEASE_UNITS_EXHAUSTED",
+  "PARTICIPATION_CLAIM_CADENCE_ACTIVE",
+  "PARTICIPATION_IDENTITY_ATTESTATION_REQUIRED",
+  "PARTICIPATION_DISTRIBUTION_ZERO_DELTA",
+  "PARTICIPATION_DISTRIBUTION_ALREADY_PREPARED",
+  "PARTICIPATION_DISTRIBUTION_RECIPIENT_STALE",
+  "PARTICIPATION_DISTRIBUTION_VOUCHER_EXPIRED",
+  "PARTICIPATION_DISTRIBUTION_EVENT_MISMATCH",
+  "PARTICIPATION_DISTRIBUTION_FINALITY_PENDING",
+  "RATE_LIMITED",
+  "INTERNAL_ERROR",
+  "SERVICE_UNAVAILABLE",
+  "ELIGIBILITY_UNDETERMINED",
+  "COLLATERAL_CONFIGURATION_MISMATCH",
+  "QUOTE_STATE_UNAVAILABLE",
+  "PROTOCOL_UNAVAILABLE",
+  "PROTOCOL_PAUSED",
+  "VENUE_HALTED",
+  "EMBED_ATTRIBUTION_UNAVAILABLE",
+  "QUOTE_FAILED",
+  "INVALID_MARKET_STATE",
+  "MATH_OVERFLOW",
+  "UNKNOWN_CONTRACT_ERROR",
+  "DEADLINE_EXPIRED",
+  "ZERO_INPUT",
+  "ZERO_NET_INPUT",
+  "ZERO_DELTA",
+  "INVALID_MARKET",
+  "INVALID_TOKEN",
+  "NATIVE_ROUTE_UNAVAILABLE",
+  "POST_ONLY_WOULD_CROSS",
+  "FOK_UNFILLABLE",
+  "CLORDID_CONFLICT",
+  "QUOTE_SET_INVALID",
+  "QUOTE_GENERATION_STALE",
+  "ORDER_IN_FLIGHT",
+  "MAKER_NOT_EXECUTABLE",
+  "LIQUIDITY_CHANGED",
+  "CANCELLATION_EVENT_NOT_FOUND",
+  "CANCELLATION_EVENT_MISMATCH",
+  "INVALID_NONCE_FLOOR",
+  "NONCE_INVALIDATION_EVENT_NOT_FOUND",
+  "NONCE_INVALIDATION_EVENT_MISMATCH",
+  "INVALID_TX_HASH"
+]

First observedSep 29, 2026

TDQS

A3.6/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, open-world), so the bar is lower. The description adds interpretation guidance — prefer the derived `lifecycleStage` over canonical `marketState` for display and for deciding what is currently possible — which is genuinely useful behavior-adjacent context. It says nothing about pagination limits, rate limits, or how deep a result set can be walked beyond what the schema's `cursor` text already conveys.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Roughly five sentences for a twelve-parameter tool is proportionate, and the routing guidance about question slugs earns its space. The structure is slightly inverted: the usage trigger precedes the one-line statement of what the tool actually does, which delays the core identity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and rich annotations, the description needn't restate return shapes, yet it spends its budget describing row fields (marketState, lifecycleStage, stageDeadline, questions) and omits higher-value operational facts like default paging and the one undocumented filter (`chainId`). It is adequate for an agent to pick the tool and call it with `search`, but not complete for a twelve-parameter query surface.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 75%, so baseline is 3. The description adds real semantics for the primary entry parameter (free-text search terms come from the user's named event/topic), but leaves the other eleven parameters — sort, view, pageSize, chainId, creator, category, marketState, pricingModel, sourceTokenId, sourceConditionId — to the schema, and `chainId` is undocumented in both places.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb and resource ("List prediction markets on Kellian") and frames the entry point ("Use this when someone names an event or a topic and wants its prediction-market question or odds: pass the words as `search`"). It differentiates by workflow role rather than naming the nearest sibling list tools (discover_events, list_related_markets), so the distinction is inferable but not explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clear when-to-use trigger: a user names an event or topic and wants a market question or odds, mapped to the `search` parameter. It also routes downstream work by saying to pass a question slug to the chart, news, research and smart money reads. It stops short of naming an alternative list tool or stating when this tool should not be used.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Problee tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.