SDK Explorer

Create a new event monitor based on the provided blockchain, contract address, and event signature.

Parameters
CreateEventMonitorRequest
object
Required
blockchain
object
Required
contract_address
string
Required

The on-chain address of this contract.

event_signature
string
Required

The specific event to which you want to subscribeven. Please ensure no spaces are included.

idempotency_key
string

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests. To create a UUIDv4 go to uuidgenerator.net. If the same key is reused, it will be treated as the same request and the original response will be returned.

x_request_id
string

Developer-provided parameter used to identify this request. Useful when communicating with Circle Support.

Responses
Example
1from circle.web3 import smart_contract_platform
2from circle.web3 import utils
3
4client = utils.init_smart_contract_platform_client(api_key=key, entity_secret=entitySecret)
5
6api_instance = smart_contract_platform.EventMonitorsApi(client)
7request = smart_contract_platform.CreateEventMonitorRequest.from_dict({
8    "blockchain": "ETH-SEPOLIA",
9    "contractAddress": "0x4e2f1c3a5d8b7c9e5f6a8b7c9e5f6a8b7c9e5f6a",
10    "eventSignature": "ping()",
11})
12response = api_instance.create_event_monitor(create_event_monitor_request=request)
13print(response.json())
14
ResponseChoose an example
1{
2  "data": {
3    "event_monitor": {
4      "id": "e3c998a5-bdf1-4f3e-812f-24da238c0fff",
5      "blockchain": {},
6      "contract_address": "0x1e124d7384cd34448ea5907bd0052a79355ab5eb",
7      "event_signature": "Transfer(address indexed from, address indexed to, uint256 value)",
8      "event_signature_hash": "0xd3d3dd4b1fd3e53f94deb24e763485b4c925345c5abfa9ad529c67aa55a3b784",
9      "is_enabled": true
10    }
11  }
12}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.