{ "openapi": "3.0.1", "info": { "title": "Polymarket Scraper — Live Odds, Prices & Volume", "description": "Get Polymarket prediction market prices, bid, ask, spread and implied probability. Track odds over time, screen by 24h volume and liquidity, search markets by topic, or pull resolved outcomes for backtesting. No API key. Pay per market returned.", "version": "0.1", "x-build-id": "WOXg5yMs92cNLc19p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eltociear~polymarket-markets-odds/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eltociear-polymarket-markets-odds", "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/eltociear~polymarket-markets-odds/runs": { "post": { "operationId": "runs-sync-eltociear-polymarket-markets-odds", "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/eltociear~polymarket-markets-odds/run-sync": { "post": { "operationId": "run-sync-eltociear-polymarket-markets-odds", "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": "Search", "type": "string", "description": "Free-text search over live Polymarket events, e.g. 'bitcoin', 'fed rate', 'election'. Leave empty to take the whole open board instead." }, "slugs": { "title": "Exact market slugs", "type": "array", "description": "Look up specific markets by slug (the last part of a polymarket.com URL). Overrides Search when set — use this to track a fixed watchlist on a schedule.", "items": { "type": "string" } }, "maxMarkets": { "title": "Maximum markets", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on rows returned. You pay per market returned, so this is also your spending cap.", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "volume24hr", "volume", "liquidity", "endDate", "priceChange24h" ], "type": "string", "description": "Applies when taking the whole board (no Search, no slugs).", "default": "volume24hr" }, "ascending": { "title": "Reverse the sort", "type": "boolean", "description": "Off gives the largest/busiest first. On is useful with 'Resolution date' to find markets resolving soonest.", "default": false }, "minVolume24hUsd": { "title": "Minimum 24h volume (USD)", "minimum": 0, "type": "integer", "description": "Drop illiquid markets. Most of the board trades under $1,000 a day, so a high value here can legitimately return nothing.", "default": 0 }, "minLiquidityUsd": { "title": "Minimum liquidity (USD)", "minimum": 0, "type": "integer", "description": "Order-book depth floor. Useful when you only care about markets you could actually trade size in.", "default": 0 }, "minSpread": { "title": "Minimum bid/ask spread", "minimum": 0, "maximum": 1, "type": "number", "description": "Keep only markets whose spread is at least this wide (0.01 = 1 cent). Markets with no live order book are excluded rather than treated as zero-spread.", "default": 0 }, "includeClosed": { "title": "Include closed markets", "type": "boolean", "description": "Off returns only markets still trading. On also returns settled ones, for backtesting against known outcomes.", "default": false }, "tagId": { "title": "Polymarket tag id", "type": "string", "description": "Restrict the board to one Polymarket tag/category by its numeric id. Leave empty for all." } } }, "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 } } }, "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 } } } } } } } } } }