/hypercore JSON-RPC methods requires a Build plan or higher. View pricing to upgrade. For complete stream type definitions and filtering options, see the datasets documentation.The top-level height field was added to Hyperliquid's raw replica_cmds data on 2026-07-25, starting at block 1085381001. Blocks produced before that change are still returned in full, with abci_block and resps, but the response object has no height key, so the payload itself does not tell you which block you received. Track the block number from your own request when you query that range. This applies only to the replica_cmds stream. Every other stream returns block_number on every block.
Parameters
- streamstringREQUIRED
The stream type to query (trades, orders, events, book, twap, writer_actions, replica_cmds). The replica_cmds stream returns the raw HyperCore block, which has a different response shape than the other streams.
- fromintegerREQUIRED
Starting block number (inclusive)
- tointegerREQUIRED
Ending block number (inclusive)
Returns
- resultobject
Result payload containing the requested blocks
Returned for the
trades,orders,book,twap,events, andwriter_actionsstreams.- blocksarray
Array of block objects within the specified range
- block_numberinteger
Block number on the Hyperliquid chain
- block_timestring
Block timestamp in ISO 8601 format
- local_timestring
Local server timestamp in ISO 8601 format
- eventsarray
List of events in this block; each event is a 2-item tuple of [address, payload]
- addressstring
Event address as a 0x-prefixed hex string
- payloadobject
Event payload data
- coinstring
Instrument symbol (e.g., HYPE, BTC, SUI, XRP, xyz:HOOD, xyz:XYZ100, @198)
- pxstring
Execution price as a stringified number
- szstring
Execution size/quantity as a stringified number
- sidestring
Trade side indicator (e.g., B or A)
- timeinteger
Event timestamp in milliseconds since Unix epoch
- startPositionstring
Position size before the event as a stringified number
- dirstring
Action direction describing the position change (e.g., Open Long, Open Short, Close Long, Close Short, Buy, Sell, Long > Short, Short > Long)
- closedPnlstring
Realized PnL from this event as a stringified number
- hashstring
Transaction hash as a 0x-prefixed hex string
- oidinteger
Order identifier
- crossedboolean
Whether the order crossed the book
- feestring
Fee amount as a stringified number (can be negative depending on rebates)
- feeTokenstring
Token symbol used for fees (e.g., USDC, WOULD)
- tidinteger
Trade identifier
- twapIdinteger
TWAP identifier if the event is associated with a TWAP; otherwise null
- cloidstring
Client order identifier
- builderstring
Builder address as a 0x-prefixed hex string
- builderFeestring
Builder fee amount as a stringified number
Returned for the
replica_cmdsstream, which carries the raw HyperCore block. See the blocks dataset for the full field reference and the complete list of action types.- blocksarray
Array of raw HyperCore block objects within the specified range
- heightinteger
Top-level block number (use this as the block identifier). This field is absent on blocks before
1085381001; see the caution note on this page.
- abci_blockobject
Block metadata for the HyperCore block
- timestring
Block timestamp (ISO 8601)
- roundinteger
ABCI round value (not the block number)
- parent_roundinteger
Parent ABCI round value
- proposerstring
Validator address who proposed this block, as a 0x-prefixed hex string
- hardforkobject
Hardfork metadata containing version and round
- versioninteger
Hardfork version
- roundinteger
Hardfork round value
- signed_action_bundlesarray
List of signed action bundles in this block; each bundle is a 2-item tuple of [bundle_hash, bundle]
- bundle_hashstring
Bundle hash as a 0x-prefixed hex string
- bundleobject
Bundle contents
- signed_actionsarray
List of signed actions in this bundle
- signatureobject
ECDSA signature with r, s, v components
- rstring
Signature r component as a 0x-prefixed hex string
- sstring
Signature s component as a 0x-prefixed hex string
- vinteger
Signature v component
- actionobject
The actual operation being performed. The
typefield identifies the action; see the blocks dataset for the full list of action types.- typestring
Action type identifier (e.g., order, cancel, cancelByCloid, batchModify, scheduleCancel, updateLeverage)
- nonceinteger
Transaction nonce for replay protection
- vaultAddressstring
Vault address as a 0x-prefixed hex string. Present only when the action is performed by a vault; the key is omitted otherwise.
- expiresAfterinteger
Expiry timestamp for the transaction. The key is omitted when no expiry is set.
- isFrontendboolean
Indicates the transaction originated from the Hyperliquid frontend. The key is omitted when not set.
- broadcasterstring
Address that broadcasted the transaction bundle
- broadcaster_nonceinteger
Broadcaster's nonce for the bundle
- respsobject
Responses showing the success or failure of each action in the block
- Fullarray
List of responses; each entry is a 2-item tuple of [tx_hash, results]
- tx_hashstring
Transaction hash as a 0x-prefixed hex string
- resultsarray
Results produced by the transaction
- userstring
Address the result applies to, as a 0x-prefixed hex string
- resobject
Result of the action
- statusstring
Action status: ok when the action executed successfully, err when it failed
- responseobject|string
Response payload for the action. An object when status is ok, and a plain string carrying the error message when status is err.