{ "openapi": "3.0.1", "info": { "title": "Polymarket Markets Scraper: Prices, Volume, Liquidity & History", "description": "Polymarket prediction-market data from the official public API: every market's outcomes and prices (implied probability), bid/ask, 1h/24h/1w price change, volume, liquidity, dates, event and tags, plus optional price history. Search, tags or event URLs. $1 per 1,000 markets.", "version": "0.1", "x-build-id": "2ndXart7RmCwR8hbj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/actor-forge~polymarket-markets/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-actor-forge-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/actor-forge~polymarket-markets/runs": { "post": { "operationId": "runs-sync-actor-forge-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/actor-forge~polymarket-markets/run-sync": { "post": { "operationId": "run-sync-actor-forge-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": { "searchTerms": { "title": "Search", "type": "array", "description": "Optional keywords, e.g. bitcoin, election, fed rates, world cup. Uses Polymarket's own search; each matching event contributes all its markets.", "items": { "type": "string" } }, "tags": { "title": "Tags", "type": "array", "description": "Optional Polymarket tag slugs, e.g. politics, crypto, sports, economy, fed, elections, tech.", "items": { "type": "string" } }, "eventUrls": { "title": "Event URLs", "type": "array", "description": "Optional polymarket.com/event/... URLs or event slugs. A URL that names a single market returns only that market.", "items": { "type": "string" } }, "status": { "title": "Market status", "enum": [ "active", "closed", "all" ], "type": "string", "description": "Open markets, resolved/closed markets, or both.", "default": "active" }, "order": { "title": "Sort by", "enum": [ "volume24hr", "volume", "liquidity", "endDate", "startDate", "competitive" ], "type": "string", "description": "Order for the market list and tag pages (soonest first for dates, largest first otherwise). With no search, tags or URLs, the run lists markets across all of Polymarket in this order.", "default": "volume24hr" }, "minVolume": { "title": "Minimum total volume ($)", "minimum": 0, "type": "integer", "description": "Optional: skip markets with less total traded volume." }, "minLiquidity": { "title": "Minimum liquidity ($)", "minimum": 0, "type": "integer", "description": "Optional: skip markets with less liquidity on the order book." }, "endDateAfter": { "title": "Ends after", "type": "string", "description": "Optional: only markets that end on or after this date." }, "endDateBefore": { "title": "Ends before", "type": "string", "description": "Optional: only markets that end on or before this date." }, "includeDescription": { "title": "Include resolution rules", "type": "boolean", "description": "Add each market's full description (its resolution rules).", "default": false }, "includePriceHistory": { "title": "Include price history", "type": "boolean", "description": "Add the price history of the first outcome (the Yes side of yes/no markets) as time/price points. One extra request per market.", "default": false }, "priceHistoryInterval": { "title": "Price history range", "enum": [ "1h", "6h", "1d", "1w", "1m", "max" ], "type": "string", "description": "Time range of the price history (hourly or daily points).", "default": "1w" }, "maxItems": { "title": "Maximum markets", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Upper limit on markets for the whole run.", "default": 200 } } }, "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 } } } } } } } } } }