# events

**Type:** GraphQL queries

**Description:**
Retrieve blockchain events with powerful filtering options.

In Kadena, events are emitted by smart contracts when specific actions occur (e.g., `coin.TRANSFER`).
You can filter by event name, module, chain, block, transaction, height range, or minimum depth,
and even by JSON parameters using Prisma-compatible JSON object property filters (stringified).

## Arguments
- qualifiedEventName (String): Fully qualified event name (e.g., `coin.TRANSFER`) to select a specific event type.
- moduleName (String): The module that emitted the event (e.g., `coin`).
- blockHash (String): Hash of the block that contains the event.
- requestKey (String): Transaction request key (hash) associated with the event.
- chainId (String): Chain ID where the event occurred.
- maxHeight (Int): Inclusive upper bound for block height.
- minHeight (Int): Inclusive lower bound for block height.
- minimumDepth (Int): Minimum depth of the block that emitted the event (distance from the chain tip).
Use this to return only more-final and stable events.
- orderIndex (Int): Event position within the transaction’s execution order.
- parametersFilter (String): JSON-stringified Prisma JSON object property filter applied to event parameters.

Example (JSON-escaped):
  parametersFilter: "{\"array_starts_with\":\"k:abcdefg\"}"
- after (String): Cursor to start paginating **after** a specific result (forward pagination).
- before (String): Cursor to start paginating **before** a specific result (backward pagination).
- first (Int): Maximum number of records to return when paginating forward.
- last (Int): Maximum number of records to return when paginating backward.

## Response
**Type:** QueryEventsConnection
**Description:**
undefined

### Fields
- edges (QueryEventsConnectionEdge)
- pageInfo (PageInfo)
- totalCount (Int)