> ## 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 Volume Milestone

> Get notified when a market's trading volume crosses a USD milestone.

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

Get notified when a market's trading volume crosses a USD milestone. You must specify at least one timeframe to subscribe.

## Filters

| Filter              | Type       | Required | Description                                                                    |
| ------------------- | ---------- | -------- | ------------------------------------------------------------------------------ |
| `timeframes`        | string\[]  | Yes      | Timeframe windows: `1m`, `5m`, `30m`, `1h`, `6h`, `24h`, `7d`, `30d` (max 500) |
| `condition_ids`     | string\[]  | No       | Restrict to specific conditions (max 500)                                      |
| `milestone_amounts` | integer\[] | No       | USD milestone amounts to watch, positive integers up to \$100M (max 500)       |

## Subscribe

```json theme={null}
{
  "op": "subscribe",
  "event": "market_volume_milestone",
  "timeframes": ["1h", "24h"],
  "milestone_amounts": [10000, 50000, 100000]
}
```

## Response

```json theme={null}
{
  "event": "market_volume_milestone",
  "timestamp": 1775913505260,
  "data": {
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "timeframe": "24h",
    "milestone_usd": 50000,
    "current_volume_usd": 51230.80,
    "fees": 512.30,
    "txns": 134
  }
}
```