{"service":"polymarket-markets","title":"Polymarket markets and wallet data","description":"Read one page of public markets from Gamma, or wallet positions and activity from the Data API. Market text/status filters and volume/liquidity ordering apply only within that page, after upstream pagination. Returns compact original fields, source URL and reading time. Does not establish global matches, rankings or complete wallet coverage. Upstream failures return an error without fabricated results.","price":{"amount":"0.005","token":"USDC","network":"Base"},"input":{"type":"object","additionalProperties":false,"properties":{"resource":{"type":"string","enum":["markets","positions","activity"],"description":"Defaults to markets. Positions and activity require user."},"query":{"type":"string","minLength":1,"maxLength":200,"description":"Case-insensitive substring search in question and slug within the received market page. Whitespace-only values are rejected. Markets only."},"status":{"type":"string","enum":["all","active","closed"],"description":"Filter the received market page. Active requires active=true and closed=false; closed requires closed=true. Defaults to all. Markets only."},"order":{"type":"string","enum":["volume","liquidity"],"description":"Descending ordering within the received market page; missing numeric values sort last. Defaults to volume. Markets only."},"user":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Public wallet address required for positions and activity; rejected for markets."},"limit":{"type":"integer","minimum":1,"maximum":20,"description":"Upstream page size before local filtering; defaults to 5. A filtered page may return fewer records or none."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset passed to the upstream endpoint before local filtering; defaults to 0. Endpoint-specific restrictions may cause an upstream error."}},"allOf":[{"if":{"required":["resource"],"properties":{"resource":{"enum":["positions","activity"]}}},"then":{"required":["user"],"not":{"anyOf":[{"required":["query"]},{"required":["status"]},{"required":["order"]}]}},"else":{"not":{"required":["user"]}}}]},"inputExample":{"resource":"markets","limit":1,"offset":0},"outputExample":{"resource":"markets","sourceUrl":"https://gamma-api.polymarket.com/markets?limit=1&offset=0","readAt":"2026-10-12T19:12:18.241Z","pagination":{"limit":1,"offset":0,"returned":1,"sourceReturned":1,"offsetScope":"upstream_page","totalKnown":false},"items":[{"id":"559651","question":"Xi Jinping out before 2027?","slug":"xi-jinping-out-before-2027","conditionId":"0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7","active":true,"closed":false,"archived":false,"endDate":"2027-01-01T04:59:00Z","volume":"14770807.421027988","volumeNum":14770807.421027988,"liquidity":"626904.29825","liquidityNum":626904.29825,"outcomes":"[\"Yes\", \"No\"]","outcomePrices":"[\"0.0285\", \"0.9715\"]","clobTokenIds":"[\"32338220190071351435772801779725302244575775216413325951443816017994629993401\", \"25659310674993675562345759665114759892400026242514633218387667107987341231962\"]"}],"selection":{"scope":"received_page_only","status":"all","order":"volume","direction":"descending","queryFields":["question","slug"],"missingOrderValues":"last"},"scope":"Text and status filters and ordering apply only to this source page. Results do not establish global matches or global ranking; an empty selection does not establish absence of matching markets."},"howToPay":"POST JSON to https://tienda.textokit.store/api/polymarket-markets without payment to receive HTTP 402 with the x402 payment requirements. Repeat the POST with the signed PAYMENT-SIGNATURE header (v2) or X-PAYMENT header (v1) to receive the result."}