index/interfaces/QueryEventsOptions.md

Filters, paging and sorting of GET /v1/events. Paging is OFFSET style (page, limit), not a cursor.

Since

9.0.0

Property	Type	Description
`categories?`	`string`[]	-
`endDate?`	`string`	Inclusive upper bound (ISO 8601)
`eventTypes?`	`string`[]	Sent as a repeated key (`eventTypes=a&eventTypes=b`), the only form the backend's `@IsArray` accepts
`limit?`	`number`	Page size, 1 to 100 (default 50)
`page?`	`number`	1-based page (default 1)
`search?`	`string`	Matched against event type and token name (substring)
`sessionId?`	`string`	-
`sortBy?`	`"userAddress"` \| `"createdAt"` \| `"eventType"`	-
`sortOrder?`	`"asc"` \| `"desc"`	-
`source?`	`"backend"` \| `"sdk"` \| `"frontend"` \| `"mcp"`	-
`startDate?`	`string`	Inclusive lower bound (ISO 8601)
`timePreset?`	`"custom"` \| `"last_hour"` \| `"today"` \| `"yesterday"` \| `"last_7_days"` \| `"last_30_days"`	-
`tokenName?`	`string`	-
`userAddress?`	`string`	-