Skip to content

Polymarket API: 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.

polymarket.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Polymarket.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Market, requiredmarket

The market question or a Polymarket market link, for example "Xi Jinping out before 2027?".

Xi Jinping out before 2027?

Period optionalperiod

How far back to show, for example "last_week". Defaults to last_month.

last_week

One of last_day, last_week, last_month, all_time. Default last_month.

Outcome optionaloutcome

Outcome to track, for example "No". Defaults to the first outcome, usually Yes.

(default)

Output

From a run on Oct 23, 2026, shortened for this page.
{  "points": [    {      "date_time": "2026-10-16T10:00:31Z",      "chance_percent": 2.85    },    {      "date_time": "2026-10-16T11:00:30Z",      "chance_percent": 2.85    },    {      "date_time": "2026-10-16T12:00:39Z",      "chance_percent": 2.85    }  ],  "outcome": "Yes",  "question": "Xi Jinping out before 2027?",  "market_url": "https://polymarket.com/event/xi-jinping-out-before-2027",  "current_chance_percent": 2.65}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
polymarket.com/get_odds_history
Returns
question, outcome, current chance, market link, time series of chances

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method polymarket.com/get_odds_history with the inputs above.

Ask your agent

  • How has the chance of Xi Jinping being out before 2027 changed over the last month on Polymarket?
  • Show me the odds history for the Fed cutting rates in June on polymarket.com, last week
  • Track the No outcome chance for "Will Bitcoin hit 150k in 2025?" over all time
  • What did the Yes odds look like over the last day for the Ukraine ceasefire market at https://polymarket.com/event/ukraine-ceasefire-2025
  • Plot how the chance of Lakers winning the NBA title moved across the past month
  • Finds Polymarket prediction markets about a topic, ranked by total trading volume, with outcome chances and market details.

    polymarket.com/search_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.

    polymarket.com/list_trending_markets
  • Find Kalshi prediction events about a topic, ranked by total contracts traded, with Yes prices, outcome volumes and status. Settled chances show the resolved result; closed outcomes have no live buy or sell prices. Older closed markets may lack 24-hour volume; very broad searches cover up to 1,000 matches.

    kalshi.com/search_markets
  • Gets decades of yearly commodity or stock-index price history from Macrotrends: yearly average, open, high, low, close, annual change and inflation-adjusted value for gold, silver, crude oil, natural gas, copper, Dow Jones, S&P 500 and Nasdaq. The current year may be incomplete.

    macrotrends.net/get_long_term_price_history
  • Gets a coin's daily prices and price change over the last 7, 30, 90 or 365 days, with UTC dates. Today's price may change.

    coingecko.com/get_coin_price_history
  • Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency.

    finance.yahoo.com/get_price_history
  • Gets Binance spot price candles for a coin and quote currency, newest by default or within a UTC date range, up to 1,000 candles.

    binance.com/get_price_history
  • Lists the largest price rises and falls among CoinMarketCap's top 100 coins with over $50,000 in 24-hour volume, for a chosen period.

    coinmarketcap.com/list_gainers_and_losers