> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dune.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Polymarket

> Curated Polymarket prediction market datasets on Dune

Polymarket is the leading onchain prediction market, operating on Polygon. Dune's curated Polymarket tables provide market metadata, trade-level activity, position lifecycle actions, user positions, and pricing at multiple time granularities — covering the v1/v2 exchange stack and the v3 **Combos** (multi-leg parlays) contract suite.

<Info>
  **Maintained by:** Dune · **Refresh:** \~24 hours · **Chain:** Polygon
</Info>

## Markets

<CardGroup cols={2}>
  <Card title="polymarket_polygon.market_trades" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/market_trades">
    Trade-level activity across all market outcomes (v1 + v2 exchanges)
  </Card>

  <Card title="polymarket_polygon.market_details" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/market_details">
    Enriched market metadata, lifecycle status, and resolution fields
  </Card>

  <Card title="polymarket_polygon.market_actions" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/market_actions">
    Position lifecycle actions: splits, merges, redemptions, neg-risk converts
  </Card>

  <Card title="polymarket_polygon.ohlcv_hourly" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/ohlcv_hourly">
    Hourly OHLCV candles per outcome token, markets and combos
  </Card>

  <Card title="polymarket_polygon.market_prices_hourly" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/market_prices_hourly">
    Hourly outcome token prices
  </Card>

  <Card title="polymarket_polygon.positions" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/positions">
    Daily user position balances by market outcome token
  </Card>
</CardGroup>

## Combos (multi-leg parlays)

Polymarket **Combos** are multi-leg positions (e.g. "Team A wins AND Team B wins") that settle through the v3 contract suite. A combo's YES token pays out only if every leg wins; its price is the joint probability. The tables cover the complete combo trading history (from May 29, 2026, when combos went live).

<CardGroup cols={2}>
  <Card title="polymarket_polygon.combo_trades" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/combo_trades">
    Combo trade fills on the v3 Exchange with joint-probability prices and fees
  </Card>

  <Card title="polymarket_polygon.combo_details" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/combo_details">
    Combo dimension: expanded legs, generated names, and resolution status
  </Card>

  <Card title="polymarket_polygon.combo_actions" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/combo_actions">
    Combo lifecycle: splits, merges, redemptions, and structuring primitives
  </Card>

  <Card title="polymarket_polygon.combo_prices_hourly" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/combo_prices_hourly">
    Hourly combo token prices (joint probabilities)
  </Card>
</CardGroup>

## Users

<CardGroup cols={2}>
  <Card title="polymarket_polygon.users_address_lookup" icon="database" href="/data-catalog/curated/prediction-markets/polymarket/users_address_lookup">
    Proxy wallet ↔ owner address mapping with first-funding metadata
  </Card>
</CardGroup>

## Notes

* `market_trades` includes three matching types: complementary trades (buyer ↔ seller), MINT (new outcome tokens created), and MERGE (YES+NO redeemed for collateral). Filter `WHERE is_taker_side` for single-counted volume that matches Polymarket's published methodology.
* Price tables are forward-filled from observed trade activity. `ohlcv_hourly` is the richest pricing table (full candles, VWAP, volume) and covers both markets and combos.
* Market tables use `condition_id` as the primary market identifier; combo tables use `combo_condition_id`. The two live in different keyspaces — join `market_details` or `combo_details` for human-readable names.
* Trade and price tables are partitioned by `block_month` — always filter on time.