Skip to main content

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.

API Key Required

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 ➤


Events of one contract​

Filter by Log.SmartContract and the event name. This returns Swap events from a Uniswap v4 pool manager contract.

Run this query in the IDE

{
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.

Run this query in the IDE

{
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.

Run this query in the IDE

{
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.

Run this query in the IDE

{
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.

Run this query in the IDE

{
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.

Build with Bitquery

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.