> ## 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 Created

> Get notified when a new prediction market is detected on-chain.

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

Get notified when a new prediction market is detected on-chain. Optionally filter by event slugs, tags, or exclude short-term markets.

## Filters

| Filter                      | Type      | Required | Description                                                                                                                                               |
| --------------------------- | --------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `event_slugs`               | string\[] | No       | Restrict to specific events (max 500)                                                                                                                     |
| `tags`                      | string\[] | No       | Restrict by tag or category, given as the display label shown on Polymarket (e.g. `"Sports"`, `"FIFA World Cup"`), not a slug. Case-insensitive (max 500) |
| `exclude_shortterm_markets` | boolean   | No       | Exclude short-term markets from results                                                                                                                   |

## Subscribe

```json theme={null}
{
  "op": "subscribe",
  "event": "market_created",
  "tags": ["Sports", "FIFA World Cup"]
}
```

## Response

```json theme={null}
{
  "event": "market_created",
  "timestamp": 1775913505260,
  "data": {
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "market_slug": "will-candidate-x-win",
    "event_slug": "us-presidential-election-2028",
    "event_id": "12345",
    "event_title": "US Presidential Election 2028",
    "series_slug": "us-elections",
    "outcomes": [
      { "index": 0, "name": "Yes", "position_id": "452312848583266388373324160190187140051835877600158453279131187530910662656" },
      { "index": 1, "name": "No", "position_id": "21742633143463906290569050155826241533067272736897614950488156847949938836876" }
    ],
    "question": "Will candidate X win the 2028 election?",
    "title": "Candidate X Wins 2028 Election",
    "description": "Resolves Yes if candidate X wins the 2028 US presidential election.",
    "category": "Politics",
    "tags": ["politics", "elections"],
    "image_url": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-candidate-x-win.png",
    "neg_risk": false
  }
}
```