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

# Market Disputed

> Get notified when a proposed market resolution is challenged on-chain.

<Note>
  **Event:** `market_disputed` \
  **Endpoint:** `wss://api.struct.to/ws/alerts` \
  **Cost:** 0.1 credits per event
</Note>

Get notified when a proposed market resolution is challenged on-chain (`DisputePrice` or `AssertionDisputed`). The resolution is now contested and delayed. The payload carries the disputer, the proposer, and the disputed or proposed outcome when available.

## Filters

| Filter                      | Type      | Required | Description                                      |
| --------------------------- | --------- | -------- | ------------------------------------------------ |
| `condition_ids`             | string\[] | No       | Restrict to specific conditions (max 500)        |
| `event_slugs`               | string\[] | No       | Restrict to specific events (max 500)            |
| `exclude_shortterm_markets` | boolean   | No       | Exclude short-term `updown` markets from results |

## Subscribe

```json theme={null}
{
  "op": "subscribe",
  "event": "market_disputed",
  "exclude_shortterm_markets": true
}
```

## Response

```json theme={null}
{
  "event": "market_disputed",
  "timestamp": 1775913505260,
  "data": {
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "dispute_kind": "dispute_price",
    "disputer": "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
    "proposer": "0x9d84cef98b41a5b88dafb55c05e9a7e0f1a4f4d6",
    "proposed_outcome": "Yes",
    "proposed_price": 1.0,
    "question": "Will candidate X win the 2028 election?",
    "market_slug": "will-candidate-x-win",
    "event_slug": "us-presidential-election-2028",
    "image_url": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-candidate-x-win.png",
    "hash": "0x1f2e3d4c5b6a7988deadbeefcafebabe0011223344556677889900aabbccddee",
    "block": 19456789,
    "confirmed_at": 1713012000
  }
}
```

`dispute_kind` is either `dispute_price` or `assertion_disputed`. `proposed_price` is present only for `DisputePrice` disputes. Pair this with [`market_resolved`](/websockets/alerts/market-resolved) to follow a market from contested back to final.