---
updatedAt: 2025-03-17T22:11:18.000Z
agentTools:
  projectIndex: https://docs.infstones.com/llms.txt
---

# suix_queryEvents

Extended API

Return list of events for a specified query criteria.

# Parameters

| Key               | Required | Type        | Detail                                                                                                                                                             |
| :---------------- | :------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| query             | ✅        | EventFilter | the event query criteria.                                                                                                                                          |
| cursor            | ❌        | ObjectID    | An optional paging cursor. If provided, the query will start from the next item after the specified cursor. Default to start from the first item if not specified. |
| limit             | ❌        | uint        | Maximum item returned per page, default to \[QUERY\_MAX\_RESULT\_LIMIT]\[QUERY\_MAX\_RESULT\_LIMIT] if not specified.                                              |
| descending\_order | ❌        | boolean     | query result ordering, default to false (ascending order), oldest record first.                                                                                    |

```
"params": [
  {
    "MoveModule": {
      "package": "0xbb1531504c9c3235d3cd637ed9573cbe18461255b4175a1cb1e1b07b8aa8e11b",
      "module": "showcase"
    }
  },
  {
    "txDigest": "AtLEaJSGuZxmfveN5Eis15LQ9jhc2ry6UkesBkgDu6br",
    "eventSeq": "0"
  },
  3,
  false
]
```

# Result

EventPage: `<Page_for_Event_and_EventID>`  Return the events for specified query criteria.

# Example

**Request**

```curl
curl <your-endpoint> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "suix_queryEvents",
    "params": [
        {
            "MoveModule": {
                "package": "0xbb1531504c9c3235d3cd637ed9573cbe18461255b4175a1cb1e1b07b8aa8e11b",
                "module": "showcase"
            }
        },
        {
            "txDigest": "AtLEaJSGuZxmfveN5Eis15LQ9jhc2ry6UkesBkgDu6br",
            "eventSeq": "0"
        },
        3,
        false
    ]
}
'
```

**Response**

```
{
    "jsonrpc": "2.0",
    "result": {
        "data": [
            {
                "id": {
                    "txDigest": "AtLEaJSGuZxmfveN5Eis15LQ9jhc2ry6UkesBkgDu6br",
                    "eventSeq": "1"
                },
                "packageId": "0xbb1531504c9c3235d3cd637ed9573cbe18461255b4175a1cb1e1b07b8aa8e11b",
                "transactionModule": "showcase",
                "sender": "0xb9588fae7598f28d25da4d8087172b469bbe65a54185615a41910a23e3b8368a",
                "type": "0x2::display::VersionUpdated<0xbb1531504c9c3235d3cd637ed9573cbe18461255b4175a1cb1e1b07b8aa8e11b::showcase::Showcase>",
                "parsedJson": {
                    "fields": {
                        "contents": [
                            {
                                "key": "name",
                                "value": "{name}"
                            },
                            {
                                "key": "link",
                                "value": "https://suia.io/suia/{id}"
                            },
                            {
                                "key": "image_url",
                                "value": "{image_url}"
                            },
                            {
                                "key": "description",
                                "value": "{description}"
                            },
                            {
                                "key": "project_url",
                                "value": "https://suia.io/"
                            },
                            {
                                "key": "creator",
                                "value": "{creator}"
                            }
                        ]
                    },
                    "id": "0xa306db0c6d3f5cbb8169143c22da5b61caf3576f1b3f3e77537aef8d4ca4b515",
                    "version": 1
                },
                "bcs": "2pfuATw9xfkAXu6FQeUVNup55cmCciuFzkej7PYi7KizSHKM1fZdH6eJFHwDqLjxcE5dob2jqaReyDNFgSnDPZc54pVSg9kchJw2sj3V45Dr1b7kchFzcu1kSU3XfGjQbgJo336i7mUr2FX6ont1M78kasgb4YM5W4SBg7aCtN7MPfdosFbgLvxL6yUyEMxkxojfBzKsUfSragrB4BY1EkaPWHkcKd9aTHyAs1r4DmgZ2",
                "timestampMs": "1683514662087"
            }
        ],
        "nextCursor": {
            "txDigest": "AtLEaJSGuZxmfveN5Eis15LQ9jhc2ry6UkesBkgDu6br",
            "eventSeq": "1"
        },
        "hasNextPage": false
    },
    "id": 1
}
```

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "sui",
    "version": "1.1"
  },
  "servers": [
    {
      "url": "https://api.infstones.com/sui/mainnet"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/{project_id}": {
      "post": {
        "summary": "suix_queryTransactionBlocks",
        "description": "Extended API",
        "operationId": "sui-suix-querytransactionblocks",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "schema": {
              "type": "string",
              "default": "8f170bbbc110407597b2ded8474747db"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "RAW_BODY": {
                    "type": "string",
                    "default": "{   \"jsonrpc\": \"2.0\",   \"id\": 1,   \"method\": \"suix_queryTransactionBlocks\",   \"params\": [     {       \"filter\": {         \"InputObject\": \"0xbb1531504c9c3235d3cd637ed9573cbe18461255b4175a1cb1e1b07b8aa8e11b\"       },       \"options\": null     }   ] }"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```