Pricing

from $1.50 / 1,000 markets

Try for free

Go to Apify Store

Polymarket API - Markets, Odds, Order Book & Trades

Try for free

Live and historical Polymarket prediction market data as clean JSON: prices, implied probability, volume, liquidity, order book, trades and price history. No login or API key needed.

Pricing

from $1.50 / 1,000 markets

Rating

0.0

(0)

Developer

TRUONG VAN HOA

Actor stats

Bookmarked

Total users

Monthly active users

a day ago

Last modified

Categories

Automation

Developer tools

You can access the Polymarket API - Markets, Odds, Order Book & Trades programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "WpL9H3tNtn6YwcaNk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/feedsmith~polymarket-markets-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-feedsmith-polymarket-markets-scraper",
        "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/feedsmith~polymarket-markets-scraper/runs": {
      "post": {
        "operationId": "runs-sync-feedsmith-polymarket-markets-scraper",
        "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/feedsmith~polymarket-markets-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-feedsmith-polymarket-markets-scraper",
        "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": {
          "marketSlugs": {
            "title": "Market slugs",
            "type": "array",
            "description": "Specific markets by slug, e.g. lol-we-jdg-2026-09-18-game3. You can also paste a polymarket.com event/market URL - the last path segment is used.",
            "items": {
              "type": "string"
            }
          },
          "marketIds": {
            "title": "Market IDs",
            "type": "array",
            "description": "Specific markets by numeric Gamma market ID, e.g. 4331478.",
            "items": {
              "type": "string"
            }
          },
          "conditionIds": {
            "title": "Condition IDs",
            "type": "array",
            "description": "Specific markets by on-chain condition ID (0x...), as used by the CLOB and Data API.",
            "items": {
              "type": "string"
            }
          },
          "eventSlugs": {
            "title": "Event slugs",
            "type": "array",
            "description": "Specific events, e.g. xi-jinping-out-before-2027. Returns every outcome market of the event. You can also paste a polymarket.com event URL.",
            "items": {
              "type": "string"
            }
          },
          "tagSlug": {
            "title": "Tag / category",
            "type": "string",
            "description": "Fetch every live market under one Polymarket tag, e.g. politics, crypto, sports, nfl, bitcoin, fed. Used only when no market/event selector above is given. Polymarket's tag list is large and free-form (no fixed category list); see polymarket.com for tag names. Leave all selectors empty to scan the whole exchange."
          },
          "status": {
            "title": "Market status",
            "enum": [
              "open",
              "closed",
              "all"
            ],
            "type": "string",
            "description": "open = tradeable now. closed = trading ended (includes markets awaiting settlement and already-resolved ones). all = everything.",
            "default": "open"
          },
          "search": {
            "title": "Text filter",
            "type": "string",
            "description": "Keep only markets whose question, event title, slug, description or tags contain ALL of these words (case-insensitive). Example: bitcoin 150000"
          },
          "closesWithinDays": {
            "title": "Closes within (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only markets closing within the next N days. Useful with status = open."
          },
          "closedWithinDays": {
            "title": "Closed within last (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only markets that closed in the last N days. Use with status = closed or all to build a backtesting history."
          },
          "minVolume": {
            "title": "Minimum volume (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Skip illiquid markets with lifetime volume below this many dollars.",
            "default": 0
          },
          "minLiquidity": {
            "title": "Minimum liquidity (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Skip markets with current order book liquidity below this many dollars.",
            "default": 0
          },
          "maxItems": {
            "title": "Max markets",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many markets. You are only charged for markets actually saved. Default 100 keeps a first test run around $0.15; raise it for full exports.",
            "default": 100
          },
          "includeOrderbook": {
            "title": "Include order book",
            "type": "boolean",
            "description": "Attach the current order book (bids, asks, best bid/ask, depth) for every outcome. Charged as one enrichment per market.",
            "default": false
          },
          "orderbookDepth": {
            "title": "Order book depth (levels per side)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Number of price levels to return per side of the book.",
            "default": 10
          },
          "includeTrades": {
            "title": "Include recent trades",
            "type": "boolean",
            "description": "Attach the most recent trade fills for each market. Only the public on-chain wallet address is kept per trade - no names, bios or profile images.",
            "default": false
          },
          "maxTradesPerMarket": {
            "title": "Max trades per market",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Upper limit of trade fills attached to each market, newest first.",
            "default": 100
          },
          "tradesLookbackHours": {
            "title": "Trades lookback (hours)",
            "minimum": 1,
            "type": "integer",
            "description": "Only trades from the last N hours. Leave empty for the most recent trades regardless of age."
          },
          "includePriceHistory": {
            "title": "Include price history",
            "type": "boolean",
            "description": "Attach OHLC-free price-over-time history for every outcome.",
            "default": false
          },
          "historyInterval": {
            "title": "Price history interval",
            "enum": [
              "1h",
              "6h",
              "1d",
              "1w",
              "1m",
              "max"
            ],
            "type": "string",
            "description": "Length of the history window.",
            "default": "1h"
          },
          "historyFidelityMinutes": {
            "title": "Price history fidelity (minutes)",
            "minimum": 1,
            "maximum": 43200,
            "type": "integer",
            "description": "Minutes between price points.",
            "default": 60
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Polymarket API - Prediction Market Data, Prices & Trades OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Polymarket API - Markets, Odds, Order Book & Trades from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Polymarket API - Markets, Odds, Order Book & Trades API in Python

Polymarket API - Markets, Odds, Order Book & Trades API in JavaScript

Polymarket API - Markets, Odds, Order Book & Trades API through CLI

Polymarket API - Markets, Odds, Order Book & Trades API

Polymarket Scraper — Odds, Order Book & Trades

blackfalcondata/polymarket-scraper

Scrape polymarket.com prediction markets as structured JSON. Every row carries the question with its outcomes and live prices, the volume and liquidity behind them, plus tags and resolution dates. Filter before the run costs anything. Order book and trades on request.

Black Falcon Data

Prediction Market Odds API — Polymarket + Kalshi

westerly_breaker/prediction-market-odds-api

Search or look up Polymarket and Kalshi prediction markets and get one unified JSON schema back: prices, volume, liquidity, order books, and de-vigged fair probabilities (multiplicative/power method). No API key needed — built for research, arbitrage-scanning, and AI agents.

Daniel Posztos

Polymarket Scraper - Odds, Volume & Order Books

crawloop/polymarket-scraper

Scrape Polymarket prediction markets for odds, 24h volume, liquidity, order books, trades, and wallets. Unofficial Polymarket API alternative - no login. Export JSON for Python, Node.js, and MCP.

Andrej Kiva

Polymarket API — Order Book, Fills & History

dirtycode/polymarket-api

Live and historical Polymarket data in one normalized schema: market odds, full L2 order-book depth (every bid and ask level with size), executed trades with on-chain transaction hashes, and an archived order book over time for backtesting. No login, no cookies, no account.

Dirtycode

Kalshi API — Markets, Order Book & Trades

dirtycode/kalshi-api

Live data from Kalshi, the CFTC-regulated US prediction market: market odds ranked by volume, full L2 order-book depth, and executed trades with volume-weighted average price. No login, no API key, no account required.

Dirtycode

Polymarket Trade Intelligence: Order Book and Prices

scrapemint/polymarket-scraper

Bulk pull Polymarket prediction markets by category, keyword, tag, slug, or condition ID. One row per market with outcomes, YES and NO prices, 24h volume, liquidity, end date, plus optional order book, recent trades, and price history. No third party API key. Pay per row.

Ken M

5.0

(1)

Polymarket Scraper & API — Odds, Probabilities, Volume

lergassy/polymarket-scraper

Every Polymarket market in one table: implied probability, yes and no price, best bid and ask, 24h move, volume, liquidity and close date. Events with all outcomes, price history and full order books. No wallet, no API key.

Matvey

5.0

(2)

Polymarket Leaderboard Scraper

khadinakbar/polymarket-leaderboard-scraper

Scrape Polymarket top-trader leaderboards by volume and profit across 1d, 7d, 30d, and all-time windows. Wallet, PnL, profile URL + optional live portfolio value. MCP/API-ready.

Khadin Akbar

Polymarket Markets & Events Scraper

fetch_cat/polymarket-markets-events-scraper

Export public Polymarket markets, outcome prices, volume, liquidity, tags, and event context. Filter records and download CSV, Excel, or JSON, or use the API.

Hanna Nosova

Polymarket Scraper

rowfeed/polymarket-markets-scraper

Extract Polymarket prediction markets: live yes/no odds, bid/ask, volume, liquidity, end dates and optional order books. Filter by event, tag, search term or status. Clean JSON for traders, researchers and AI agents.