portal_substrate_query_events
Filter and retrieve raw Substrate or Polkadot event rows by pallet and event name, with optional parent call or extrinsic context. Supports time ranges and block numbers.
Instructions
Query raw Substrate or Polkadot event rows with pallet/event-name filters and optional parent call or extrinsic context.
COMMON USER ASKS:
Balances.Transfer events on Polkadot
FIRST CHOICE FOR:
raw Substrate or Polkadot event rows with optional parent call or extrinsic context
WHEN TO USE:
You need raw event records on a Substrate network.
You want pallet-level event activity like Balances.Transfer or Contracts.ContractEmitted.
You want event rows first, even if the network is a Polkadot-family chain.
DON'T USE:
You want calls or aggregate analytics rather than event rows.
EXAMPLES:
Balances.Transfer events on Polkadot: {"network":"polkadot","timeframe":"1h","event_names":["Balances.Transfer"],"limit":20}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max events to return | |
| cursor | No | Continuation cursor from a previous response | |
| network | No | Substrate network name or alias. Optional when continuing with cursor. | |
| to_block | No | Ending block number | |
| timeframe | No | Time range (e.g. '1h', '24h'). Alternative to from_block/to_block. | |
| from_block | No | Starting block number | |
| event_names | No | Optional qualified event names like Balances.Transfer or System.ExtrinsicSuccess | |
| include_call | No | Attach the emitting call inline when the event has call context | |
| to_timestamp | No | Ending timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "now". | |
| include_stack | No | Attach the parent call stack when the event has nested call context | |
| finalized_only | No | Only query finalized blocks | |
| from_timestamp | No | Starting timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "6h ago". | |
| response_format | No | Response format: defaults to 'compact' for chat-friendly output. Compact mode keeps requested extrinsic or call context in a smaller inline shape. | |
| include_extrinsic | No | Attach the parent extrinsic inline for each matching event |