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

# GET /events (SSE)

> Live event stream with priority pipeline, dedupe, and per-token throttle

## /events — machine-readable

| Field                                  | Value                                     |
| -------------------------------------- | ----------------------------------------- |
| method                                 | GET                                       |
| host                                   | api.filter.fun                            |
| path                                   | /events                                   |
| transport                              | text/event-stream (SSE)                   |
| auth                                   | none                                      |
| per\_ip\_concurrent\_cap               | 4                                         |
| heartbeat\_interval\_sec               | 15                                        |
| idle\_timeout\_sec                     | 300                                       |
| reconnect\_strategy                    | client-side exponential backoff (cap 30s) |
| resume\_header                         | Last-Event-ID                             |
| per\_token\_throttle\_ms               | 250                                       |
| dedupe\_window\_ms                     | 1000                                      |
| low\_suppression\_under\_higher\_lanes | true                                      |

### Event taxonomy

| Event                | Priority |
| -------------------- | -------- |
| HP\_UPDATED          | LOW      |
| HP\_REORG            | MED      |
| RESERVATION\_CREATED | MED      |
| SEASON\_ACTIVATED    | HIGH     |
| TOKEN\_LAUNCHED      | MED      |
| SWAP\_HIGH           | HIGH     |
| SWAP\_MED            | MED      |
| SWAP\_LOW            | LOW      |
| FILTER\_MOMENT       | HIGH     |
| WINNER\_DECLARED     | HIGH     |
| SEASON\_ABORTED      | HIGH     |

### Drop policy under backpressure

| Lane | Drop order                                         |
| ---- | -------------------------------------------------- |
| LOW  | dropped first when MED or HIGH lanes are non-empty |
| MED  | dropped only when HIGH lane saturates              |
| HIGH | never dropped; queue blocks producer instead       |