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

# Position Volume Milestone

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

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

Get notified when a position'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) |
| `position_ids`      | string\[]  | No       | Restrict to specific positions (max 500)                                       |
| `condition_ids`     | string\[]  | No       | Restrict to specific conditions (max 500)                                      |
| `outcomes`          | string\[]  | No       | Filter by outcome name, e.g. `["Yes", "No"]` (max 500)                         |
| `milestone_amounts` | integer\[] | No       | USD milestone amounts to watch (max 500)                                       |

## Subscribe

```json theme={null}
{
  "op": "subscribe",
  "event": "position_volume_milestone",
  "timeframes": ["1h"],
  "condition_ids": ["0x1234567890abcdef"],
  "milestone_amounts": [5000, 10000]
}
```

## Response

```json theme={null}
{
  "event": "position_volume_milestone",
  "timestamp": 1775913505260,
  "data": {
    "position_id": "0xabc123",
    "condition_id": "0x1234567890abcdef",
    "outcome": "Yes",
    "outcome_index": 0,
    "timeframe": "1h",
    "milestone_usd": 10000,
    "current_volume_usd": 10540.30,
    "buy_volume_usd": 7200.50,
    "sell_volume_usd": 3339.80,
    "fees": 105.40,
    "txns": 42,
    "buys": 28,
    "sells": 14
  }
}
```