Elysium Smart Contract Events API
Query and stream smart contract events on Elysium with Bitquery GraphQL. Elysium (network: elysium, chain ID 99901) is Kinetiq's Layer 2 for the Hyperliquid ecosystem, with HYPE as the gas token. Events holds every log with its contract, signature and decoded arguments. Every query here also runs as a live stream: change query to subscription and drop limit and orderBy.
To query or stream data outside the Bitquery IDE, you need an API access token.
Follow the steps here: How to generate Bitquery API token ➤
- Elysium API overview — network facts, token addresses and every page in one place
- Elysium DEX Trades API & Streams
- Elysium Token Price API
- Elysium Liquidity Pools API
- Elysium Transfers API & Streams
- Elysium Balances & Token Holders API
- Elysium Smart Contract Calls API
- Elysium Transactions, Fees & Blocks API
Events of one contract
Filter by Log.SmartContract and the event name. This returns Swap events from a Uniswap v4 pool manager contract.
{
EVM(network: elysium) {
Events(
where: {Log: {SmartContract: {is: "0x5c54a7293d96b11a29a0256ee8dfdbc3059637da"}, Signature: {Name: {is: "Swap"}}}}
orderBy: {descending: Block_Time}
limit: {count: 10}
) {
Block { Time Number }
Transaction { Hash From }
Log { SmartContract Signature { Name Signature SignatureHash } }
Arguments {
Name
Value {
... on EVM_ABI_Address_Value_Arg { address }
... on EVM_ABI_BigInt_Value_Arg { bigInteger }
... on EVM_ABI_Integer_Value_Arg { integer }
... on EVM_ABI_String_Value_Arg { string }
... on EVM_ABI_Boolean_Value_Arg { bool }
... on EVM_ABI_Bytes_Value_Arg { hex }
}
}
}
}
}
Each argument comes back with its name and a typed value. Drop the Signature filter to get every event of the contract.
Most frequent events
Count events by name over the last 6 hours to see what is active on Elysium.
{
EVM(network: elysium) {
Events(
where: {Block: {Time: {since_relative: {hours_ago: 6}}}}
orderBy: {descendingByField: "events"}
limit: {count: 20}
) {
Log { Signature { Name } }
events: count
}
}
}
Most active contracts
Group by contract to see which ones emit the most events.
{
EVM(network: elysium) {
Events(
where: {Block: {Time: {since_relative: {hours_ago: 6}}}}
orderBy: {descendingByField: "events"}
limit: {count: 20}
) {
Log { SmartContract }
events: count
transactions: uniq(of: Transaction_Hash)
}
}
}
Events in one transaction
Filter by transaction hash to see everything a transaction emitted. Replace the hash with a recent one from your own data.
{
EVM(network: elysium) {
Events(
where: {Transaction: {Hash: {is: "0xe3d79011dea6c311cd1dd47fedc1e6ced30a412def70261249729b48a701dd5a"}}}
limit: {count: 50}
) {
Log { SmartContract Signature { Name Signature } }
Arguments {
Name
Value {
... on EVM_ABI_Address_Value_Arg { address }
... on EVM_ABI_BigInt_Value_Arg { bigInteger }
... on EVM_ABI_Integer_Value_Arg { integer }
... on EVM_ABI_String_Value_Arg { string }
... on EVM_ABI_Boolean_Value_Arg { bool }
... on EVM_ABI_Bytes_Value_Arg { hex }
}
}
}
}
}
Events by signature hash
When two events share a name, filter by SignatureHash (topic 0 without the 0x prefix). This is the ERC-20 Transfer event.
{
EVM(network: elysium) {
Events(
where: {Log: {Signature: {SignatureHash: {is: "ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"}}}}
orderBy: {descending: Block_Time}
limit: {count: 10}
) {
Block { Time }
Transaction { Hash }
Log { SmartContract Signature { Name Signature } }
Arguments {
Name
Value {
... on EVM_ABI_Address_Value_Arg { address }
... on EVM_ABI_BigInt_Value_Arg { bigInteger }
... on EVM_ABI_Integer_Value_Arg { integer }
... on EVM_ABI_String_Value_Arg { string }
... on EVM_ABI_Boolean_Value_Arg { bool }
... on EVM_ABI_Bytes_Value_Arg { hex }
}
}
}
}
}
FAQ
How do I stream events of my contract?
Take the events of one contract query, put your contract address in Log.SmartContract, change query to subscription and drop limit and orderBy.
Are event arguments decoded? Yes, when the event signature is known. Each argument has a name and a typed value.
Where are new liquidity pool events? On the Elysium liquidity pools page.
Ready to run this in production?
Get an API key and run these queries in minutes, or talk to us about plans and enterprise delivery.