# 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. Unofficial. Not affiliated with or endorsed by Polymarket. - Page: https://fous.com/methods/polymarket.com/get-odds-history - Method: `polymarket.com/get_odds_history`, version 1 - Website: polymarket.com - Returns: question, outcome, current chance, market link, time series of chances - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `market` | string | yes | `"Xi Jinping out before 2027?"` | The market question or a Polymarket market link, for example "Xi Jinping out before 2027?". | | `period` | string | no | `"last_week"` | How far back to show, for example "last_week". Defaults to last_month. One of "last_day", "last_week", "last_month", "all_time". Default "last_month". | | `outcome` | string | no | | Outcome to track, for example "No". Defaults to the first outcome, usually Yes. Default "". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "market": "Xi Jinping out before 2027?", "period": "last_week" } ``` Its output: ```json { "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 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"polymarket.com/get_odds_history","input":{"market":"Xi Jinping out before 2027?","period":"last_week"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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 ## Input schema ```json { "type": "object", "required": [ "market" ], "properties": { "market": { "type": "string", "description": "The market question or a Polymarket market link, for example \"Xi Jinping out before 2027?\"." }, "period": { "enum": [ "last_day", "last_week", "last_month", "all_time" ], "type": "string", "default": "last_month", "description": "How far back to show, for example \"last_week\". Defaults to last_month." }, "outcome": { "type": "string", "default": "", "description": "Outcome to track, for example \"No\". Defaults to the first outcome, usually Yes." } } } ``` ## Output schema ```json { "type": "object", "required": [ "question", "outcome", "current_chance_percent", "market_url", "points" ], "properties": { "points": { "type": "array", "items": { "type": "object", "required": [ "date_time", "chance_percent" ], "properties": { "date_time": { "type": "string", "format": "date-time", "description": "Sample time in ISO 8601 UTC." }, "chance_percent": { "type": "number", "description": "Chance at this time, as a percentage." } }, "additionalProperties": false }, "description": "Historical chances in time order, at hourly or daily spacing depending on the period." }, "outcome": { "type": "string", "description": "The tracked outcome." }, "question": { "type": "string", "description": "The matched market question." }, "market_url": { "type": "string", "description": "Link to the Polymarket event containing this market." }, "current_chance_percent": { "type": "number", "description": "Current chance, as a percentage from 0 to 100." } }, "additionalProperties": false } ``` ## See more - [Polymarket API: Search markets](https://fous.com/methods/polymarket.com/search-markets.md): Finds Polymarket prediction markets about a topic, ranked by total trading volume, with outcome chances and market details. - [Polymarket API: List trending markets](https://fous.com/methods/polymarket.com/list-trending-markets.md): 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. - [Kalshi API: Search markets](https://fous.com/methods/kalshi.com/search-markets.md): 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. - [Macrotrends API: Get long-term price history](https://fous.com/methods/macrotrends.net/get-long-term-price-history.md): 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. - [CoinGecko API: Get coin price history](https://fous.com/methods/coingecko.com/get-coin-price-history.md): 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. - [Yahoo API: Get price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency. - [Binance API: Get price history](https://fous.com/methods/binance.com/get-price-history.md): 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. - [CoinMarketCap API: List gainers and losers](https://fous.com/methods/coinmarketcap.com/list-gainers-and-losers.md): 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. - [All Polymarket methods](https://fous.com/methods/polymarket.com.md)