Events API

List and retrieve indexed Soroban events.

List events


GET /v1/events

Parameter	Type	Description
`network`	string	Required. `testnet` or `mainnet`
`page`	int	Page number (default `1`)
`page_size`	int	Page size (default `20`, max `100`)
`search`	string	Search event ID, contract ID, txn hash, payload
`event_type`	string	Filter by event type symbol (e.g. `transfer`)
`decode_status`	string	`decoded` or `raw`


curl "http://localhost:8080/v1/events?network=testnet&page=1&page_size=10&decode_status=raw"

Field	Description
`id`	Soroban event identifier
`contract_id`	Emitting contract
`ledger`	Stellar ledger sequence
`txn_hash`	Host transaction hash
`event_type`	Decoded type symbol
`summary_preview`	Human-readable one-line summary
`decode_status`	`decoded` or `raw`
`ingested_at`	Index timestamp (ISO 8601)


GET /v1/events/{id}?network=testnet

Returns full topics, value JSON, XDR, and decode metadata.