Prediction markets
The Polymarket Odds Snapshot is an API that returns structured, analysis-ready odds for Polymarket markets — current prices, bid/ask, spread, 24h and total volume, liquidity and end date — selected by category, volume floor, or an explicit list of market slugs, with optional recent price history per market.
Capabilities
Pass a market_slugs list for a fixed watchlist; a category like crypto, politics or sports for the highest-volume open markets in that vertical; or nothing for the whole exchange ordered by 24h volume with an optional volume floor.
Each market row can carry a recent price time series straight from the public CLOB — snapshot plus trajectory in one call, so you can see not just where the odds are but how they got there.
No wallet, no RPC endpoints, no API keys. Live prediction-market probabilities into a spreadsheet, dashboard, model or AI agent in one line.
One row per market: question, prices per outcome, best bid/ask, spread, last trade, volumes, liquidity, end date, URL, snapshot timestamp. Export as JSON, CSV or Excel.
{
"question": "Will Bitcoin go Up or Down on August 4?",
"market_slug": "bitcoin-up-or-down-on-august-4-2026",
"outcomes": ["Up", "Down"],
"price_by_outcome": {"Up": 0.9995, "Down": 0.0005},
"best_bid": 0.999,
"best_ask": 1.0,
"spread": 0.001,
"last_trade_price": 0.999,
"volume_24h_usd": 1581410.95,
"volume_total_usd": 74636359.98,
"liquidity_usd": 23679.26,
"end_date": "2026-08-05T00:00:00Z",
"snapshot_utc": "2026-08-04T06:10:00+00:00"
}{
"category": "crypto",
"min_volume_24h": 10000,
"max_markets": 100,
"include_history": false
}Or pass market_slugs: ["…"] to snapshot an exact watchlist. History mode adds a price series per market.
Playbook
Prediction-market prices are the best publicly available probability estimates for world events. Snapshot the politics or economy category on a schedule and feed calibrated probabilities into forecasts, risk models, or research.
Schedule a daily snapshot of your watchlist and export CSV into Google Sheets — a living odds board with volume and liquidity context, for pennies a day.
History mode shows how odds moved. Detect momentum, sudden repricing, or divergence between related markets across snapshots.
An LLM asked “what are the odds Bitcoin closes up today?” can call this actor via MCP and answer with the live market price instead of a stale guess.
Integration
Synchronous REST, official clients, schedules with webhooks — or expose it directly to an AI agent through the Apify MCP server. More patterns on the integrations page.
curl -X POST \
"https://api.apify.com/v2/acts/splendorous_astrolabe_xs9~polymarket-odds-snapshot/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"category": "crypto",
"min_volume_24h": 10000,
"max_markets": 100,
"include_history": false
}'from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("splendorous_astrolabe_xs9/polymarket-odds-snapshot").call(
run_input={
"category": "crypto",
"min_volume_24h": 10000,
"max_markets": 100,
"include_history": false
}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item){
"mcpServers": {
"public-signal": {
"url": "https://mcp.apify.com/?actors=splendorous_astrolabe_xs9/polymarket-odds-snapshot",
"headers": {
"Authorization": "Bearer <APIFY_TOKEN>"
}
}
}
}Pricing
Billed through your Apify account's usage credit. The free plan includes $5 of usage every month — no card needed to try it.
| Billable event | Price | Charged |
|---|---|---|
| Run started | $0.02 | flat fee per run |
| Market snapshot | $0.001 | per market returned |
| Price history | $0.005 | per market with history series |
A 100-market snapshot costs about $0.12; a 25-market watchlist with full price history about $0.17.
Questions
Polymarket has public endpoints, but stitching Gamma, CLOB and market metadata into clean rows takes real work. This actor does that stitching and returns flat, analysis-ready records in one call.
Any Polymarket tag slug — crypto, politics, sports, economy, tech, world, and more. Category mode returns the highest-volume open markets in that vertical.
History mode returns the recent price series the public CLOB exposes per market — enough to see the last days of movement and momentum, not a multi-year archive.
Pass your market_slugs list and schedule the run. A 25-market watchlist snapshot is roughly $0.045 per run — about $1.35 a month at daily frequency.
Related
Every large trade on Polymarket above your USD threshold — wallet, side, price, size, market — plus per-wallet flow summaries.
Paste any wallet address, get its reconstructed trading record: realized P&L, win rate, per-market breakdown, hedging share — with honest coverage flags.
A 100-market snapshot costs about $0.12; a 25-market watchlist with full price history about $0.17.