Docs

trace_filter - Hyperliquid RPC Method

Filter traces by address and block range on Hyperliquid. Requires archive node for perpetual futures trading, onchain order books, and institutional-grade derivatives.

Returns traces matching a filter on Hyperliquid.

Archive Node Required

This method requires an archive node. It is not available on full nodes.

When to Use This Method

  • Search for traces matching address criteria - Find all internal transactions involving a specific address on Hyperliquid
  • Find all interactions with a contract - Track every call, delegate call, and create operation targeting a contract for perpetual futures trading, onchain order books, and institutional-grade derivatives
  • Audit contract usage patterns - Analyze how contracts are used over time across block ranges
  • Forensic analysis - Investigate transaction patterns and address-level activity across the chain

Best Practices

  • Very resource-intensive on large block ranges; narrow the range as much as possible
  • Use specific fromAddress or toAddress filters to reduce response size
  • Limit block range to small chunks and paginate results
  • Many provider-managed endpoints disable this method due to computational cost

Response Body

Response

Code Examples