vike

Recipe 26 of 30

How did this Polymarket market resolve?

/settlements/{condition_id} returns the on-chain resolution of one market, with the winning outcome and token, the payout vector, and the block and time it resolved; [] means the chain resolved nothing.

GET /v1/polymarket/settlements/{condition_id} answers it in one call, from the chain: which outcome won, the payout per outcome, and the block and time of the resolution. It returns an array of one row, or [] when the chain has resolved nothing for that id. The full parameter list is on Settlement of one market.

Quick answer

Pass the market's condition_id.

cURL
# how one market ended, from the chain
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/polymarket/settlements/0x69e0442186b71c5cac4fa6304311e39101ed048983a200fc8e376a9dadd7de13"

Example response

Captured from the live API on 2026-10-24 at 17:21 UTC. The market resolved No in block 93,138,611 at 05:22:30 UTC on 2026-09-03. winning_index points into outcomes and token_ids, and payouts is the on-chain payout vector in the same order.

Example response
[
  {
    "condition_id": "0x69e0442186b71c5cac4fa6304311e39101ed048983a200fc8e376a9dadd7de13",
    "market_known": true,
    "outcomes": ["Yes", "No"],
    "payouts": [0, 1],
    "question": "Will Donna Vekic win the 2026 Women’s US Open?",
    "resolved_block": 93138611,
    "resolved_ts_ms": 1788412950000,
    "slug": "will-donna-vekic-win-the-2026-womens-us-open",
    "token_ids": ["100208760979006815700821365554623989048585541964271047036444923380678560443951", "43437917871736289675135437047499696002273396903387531260510673476203211904981"],
    "winning_index": 1,
    "winning_outcome": "No",
    "winning_token_id": "43437917871736289675135437047499696002273396903387531260510673476203211904981"
  }
]

Variations

A 5-minute market. The 14:25 to 14:30 UTC BTC market of 2026-10-23 resolved Down, 80 seconds after its window closed.

cURL — 5-minute market
# how one 5-minute BTC market ended
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/polymarket/settlements/0x8c1824d3201d570703ff6a9ac47374327f53b873665abc3f68998704b96bec51"

Just the question and the winner.

cURL — winner only
# question and winning outcome, or nothing if the chain resolved nothing
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/polymarket/settlements/0x69e0442186b71c5cac4fa6304311e39101ed048983a200fc8e376a9dadd7de13" \
  | jq '.[0] | {question, winning_outcome}'

The market's own status. /markets/{condition_id} says whether the market is closed, which also covers a market closed without an on-chain resolution.

cURL — market status
# the market's directory row, with active and closed
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/polymarket/markets/0x69e0442186b71c5cac4fa6304311e39101ed048983a200fc8e376a9dadd7de13"

Many markets at once. /settlements/bulk returns the same row for up to 5,000 markets a page.

cURL — many markets
# every 5-minute BTC market settled on 2026-10-23
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/polymarket/settlements/bulk?slug_prefix=btc-updown-5m-&from_ms=1792713600000&to_ms=1792800000000&limit=5000"

Before you rely on it

[] is not open, and the oracle is not named

[] means the chain resolved nothing for this id: the market may still trade, or it was cancelled or voided without a resolution. The id is the 0x condition id; a token id in its place also returns []. A void reads winning_index -1 with an empty winning_outcome. The row shows the result, not how it was reached: it does not say which oracle resolved the market or whether the result was disputed.

Ask your agent

Connected to the Vike MCP server (https://vike.io/mcp) in Claude, ChatGPT or Cursor, ask it in plain words. The polymarket_settlement tool answers, at 1 credit a call.

Ask your agent
How did the Polymarket market 0x69e0442186b71c5cac4fa6304311e39101ed048983a200fc8e376a9dadd7de13 resolve?
Example response
[  {    "condition_id": "0x69e0442186b71c5cac4fa6304311e39101ed048983a200fc8e376a9dadd7de13",    "market_known": true,    "outcomes": ["Yes", "No"],    "payouts": [0, 1],    "question": "Will Donna Vekic win the 2026 Women’s US Open?",    "resolved_block": 93138611,    "resolved_ts_ms": 1788412950000,    "slug": "will-donna-vekic-win-the-2026-womens-us-open",    "token_ids": ["100208760979006815700821365554623989048585541964271047036444923380678560443951", "43437917871736289675135437047499696002273396903387531260510673476203211904981"],    "winning_index": 1,    "winning_outcome": "No",    "winning_token_id": "43437917871736289675135437047499696002273396903387531260510673476203211904981"  }]