Skip to content

Polymarket API

Polymarket (polymarket.com) has 3 public methods: search markets, get odds history and list trending markets. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

polymarket.com (opens in a new tab)

Unofficial. Not affiliated with or endorsed by Polymarket.

Methods

3

  • Search markets

    Finds Polymarket prediction markets about a topic, ranked by total trading volume, with outcome chances and market details.

    Returns question, event title, outcome chances, total and 24-hour volume, end date, link

    Readpolymarket.com/search_markets

  • Get odds history

    Shows how a Polymarket outcome's chance changed over time, from a market question or a Polymarket link. For a text question it uses the highest-volume matching market.

    Returns question, outcome, current chance, market link, time series of chances

    Readpolymarket.com/get_odds_history

  • List trending markets

    Lists the open Polymarket markets with the most trading in the last 24 hours. You can pick one category or list all of them; markets outside the named categories are labeled Other.

    Returns question, leading outcome and chance, 24h and total volume, end date, category, link

    Readpolymarket.com/list_trending_markets