Skip to main content

hl_getTransactionByHash JSON-RPC Method

Returns a signed HyperCore L1 transaction by its explorer hash.

Updated on
Nov 03, 2026
Access to /hypercore JSON-RPC methods requires a Build plan or higher. View pricing to upgrade. This method accepts a HyperCore explorer hash, not a HyperEVM transaction hash. It indexes signed L1 actions only; system and CoreWriter actions are not included.

Parameters

hash
string
REQUIRED

Explorer transaction hash as a 0x-prefixed 32-byte hexadecimal string. This is not a HyperEVM transaction hash.

details
boolean

When true, includes signer, nonce, per-item execution status, the complete parent action, the raw signed payload, and the native node response. Defaults to false. Use named-object params when setting this value.

Returns

Returns null when the hash identifies a transaction but no explorer entry exists for that position. Only signed HyperCore L1 actions from replica_cmds are indexed; system and CoreWriter actions are not returned.

result
object|null

Explorer-compatible transaction details, or null when no explorer entry exists for the identified position.

type
string

Response type. Always txDetails for a successful lookup.

tx
object

Explorer-compatible transaction entry.

time
integer

Block time in milliseconds since the Unix epoch.

user
string

Lowercase address of the account the transaction acted for.

action
object

The operation represented by this entry in Hyperliquid action format.

block
integer

HyperCore block number.

hash
string

Explorer transaction hash.

error
string|null

Whole-action failure message, or null when the action succeeded.

details
object

Additional execution and signature data. Present only when the details parameter is true.

hash
string

Explorer transaction hash.

blockNumber
integer

HyperCore block number.

blockTime
string

UTC block timestamp with nanosecond precision.

user
string

Account the transaction acted for.

signer
string|null

Address that signed the action; null for multi-signature actions.

signerSource
string

How the signer was determined: l1, user_signed, or multi_sig.

nonce
integer

Nonce from the signed action.

expiresAfter
integer|null

Expiration timestamp from the signed action, if present.

vaultAddress
string|null

Vault address from the signed action, if present.

multiSigUser
string|null

Multi-signature user address, if present.

broadcaster
string

Address that submitted the action to the chain.

actionType
string

Type of the represented action.

outerActionType
string

Type of the containing action.

actionStatus
string

Native whole-action status: ok or err.

action
object

This transaction's individual order, cancel, or other action.

itemResponse
object

Native status for this transaction item, such as resting, filled, or an error.

itemResponseScope
string

item when the response belongs to this transaction alone; action when it covers the whole action.

bundleHash
string

Hash of the signed action bundle.

bundleIndex
integer

Bundle position within the block.

actionIndex
integer

Action position within the bundle.

actionSeq
integer

Action sequence within the block.

itemIndex
integer

Item position within a batched action.

parentAction
object

Complete original action, including every order or cancel in its batch.

signedActionRaw
string

Signed action exactly as submitted, encoded as a JSON string.

response
object

Complete native response to the action.

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free