Skip to main content

starknet_subscribeEvents RPC Method

Creates a WebSocket stream which will fire events for new Starknet events with applied filters.

Updated on
Jun 13, 2025

Parameters

from_address
string

Filter events by from_address which emitted the event

keys
array

The keys to filter over. This is an array where each element corresponds to a key position in the event. For each position, you can specify an array of possible string values to match. An empty array for a position means any value is accepted. Events are returned if they match the specified values for all positions

block_id
string

The block to get notifications from, default is latest, limited to 1024 blocks back

finality_status
string

The finality status of the most recent events to include, either PRE_CONFIRMED or ACCEPTED_ON_L2 (default). With PRE_CONFIRMED, an event may be delivered more than once, one time per finality status update

Returns

SUBSCRIPTION_ID
string

An identifier for this subscription stream used to associate events with this subscription

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free