{ "openapi": "3.0.1", "info": { "title": "Polymarket Markets API: Prices, Volume, New Market Monitor", "description": "Polymarket prediction markets from the public Gamma API: question, outcome prices (probabilities), best bid/ask, 24h volume, liquidity, start and end dates, event slug and URL. Keyword search, sorting, and a new-market monitor mode. No API key.", "version": "0.1", "x-build-id": "H2N2YECUsxyeYNY6a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ailu_studio~polymarket-markets/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ailu_studio-polymarket-markets", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ailu_studio~polymarket-markets/runs": { "post": { "operationId": "runs-sync-ailu_studio-polymarket-markets", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ailu_studio~polymarket-markets/run-sync": { "post": { "operationId": "run-sync-ailu_studio-polymarket-markets", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "Keyword", "type": "string", "description": "Optional keyword such as \"bitcoin\", \"fed\" or \"election\". Markets are searched with Polymarket's search endpoint and then kept only when the question, event title or outcome label contains the keyword (case-insensitive). Leave empty to list markets by the sort order instead.", "default": "" }, "status": { "title": "Market status", "enum": [ "active", "closed", "all" ], "type": "string", "description": "Which markets to return. \"active\" (default) means active and not closed; \"closed\" means resolved or ended markets; \"all\" returns both.", "default": "active" }, "sortBy": { "title": "Sort by", "enum": [ "volume24hr", "volume", "liquidity", "endDate", "startDate" ], "type": "string", "description": "Order of the rows and, without a keyword, the order in which Polymarket pages are read. Use \"startDate\" with outputMode \"new\" to monitor newly created markets. Default volume24hr.", "default": "volume24hr" }, "minLiquidityUsd": { "title": "Minimum liquidity (USD)", "minimum": 0, "type": "integer", "description": "Drop markets whose order-book liquidity in USD is below this value. Default 0 (no filter). Closed markets usually report no liquidity, so keep 0 when status is closed or all.", "default": 0 }, "endsBefore": { "title": "Ends before (ISO date)", "type": "string", "description": "Optional ISO 8601 date or date-time such as \"2026-12-31\" or \"2026-12-31T23:59:00Z\". Only markets whose end date is on or before this moment are returned. Leave empty for no end-date filter.", "default": "" }, "outputMode": { "title": "What to return", "enum": [ "all", "new" ], "type": "string", "description": "\"all\" (default) returns every matching market each run. \"new\" remembers the market ids seen by the watchlist named in stateStoreName and returns only markets that were not in it on the previous run (changeType \"new\"); on the first run every matching market is new.", "default": "all" }, "stateStoreName": { "title": "Watchlist state store name", "type": "string", "description": "Name of the key-value store that remembers which market ids were already seen in outputMode \"new\". Use a different name per watchlist, e.g. \"polymarket-crypto-new\". Default polymarket-markets-state.", "default": "polymarket-markets-state" }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of market rows to return. Default 100. Each 100 markets costs one request to Polymarket; a keyword search reads up to 50 events per request.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }