Ir diretamente para o conteúdo principal

Blocks Dataset

Atualizado em
Jun 23, 2026

Visão geral

O blocos stream (stored as replica_cmds) contains ALL raw HyperCore transactions submitted to the Hyperliquid blockchain. This is the most comprehensive dataset available, capturing every action on the chain.

Stream Type: BLOCKS
API Availability: gRPC Streaming API only
Volume: Extremely High - Every HyperCore action is recorded
Availability: gRPC nodes only

Data Structure

Each block contains:

  • Block metadata (abci_block)
  • Signed action bundles (transactions with signatures)
  • Responses (resps) showing success/failure of each action
{
"abci_block": {
"round": 1096693511,
"parent_round": 1096693510,
"time": "2025-12-04T08:00:47.509497915",
"proposer": "0x9dd85fb6cf95a9d755af0853b36fb05e972c71e1",
"hardfork": {
"version": 69,
"round": 1091072071
},
"signed_action_bundles": [
[
"0xhash...",
{
"signed_actions": [
{
"signature": {
"r": "0x...",
"s": "0x...",
"v": 28
},
"action": {
"type": "order",
"a": 0,
"b": true,
"p": "92385.0",
"s": "0.00361",
"r": false,
"t": {"limit": {"tif": "Gtc"}},
"c": "0x89119db7aae18b90abe620888af9aadc"
},
"nonce": 1764816505537,
"vaultAddress": null
}
],
"broadcaster": "0x...",
"broadcaster_nonce": 1764816362065
}
]
]
},
"resps": {
"Full": [
[
"0xhash...",
[
{
"user": "0x...",
"res": {
"status": "ok",
"response": {
"type": "default"
}
}
}
]
]
]
}
}

Block Metadata Fields

CampoTipoDescription
redondonúmero inteiroBlock number (use this as the block identifier)
parent_roundnúmero inteiroPrevious block number
tempocadeia de caracteresBlock timestamp (ISO 8601)
proponentecadeia de caracteresValidator address who proposed this block
hardforkobjetoCurrent protocol version and activation block

Transaction Fields

CampoTipoDescription
assinaturaobjetoECDSA signature with r, s, v components
açãoobjetoThe actual operation being performed (see Action Types)
noncenúmero inteiroTransaction nonce for replay protection
vaultAddressstring|nullPresent when action is performed by a vault
expiresAfterinteger|nullExpiry timestamp for the transaction (null when not set)
isFrontendboolean|nullIndicates the transaction originated from the Hyperliquid frontend (null when not set)
broadcastercadeia de caracteresAddress that broadcasted the transaction bundle
broadcaster_noncenúmero inteiroBroadcaster's nonce for the bundle
Complete Action Types (34 Types)

All HyperCore transaction types are organized by category for easier understanding:

CategoryAction TypesObjetivo
Negociaçãoorder, cancel, cancelByCloid, modify, batchModify, scheduleCancelPlace, modify, and cancel orders
TWAP OrderstwapOrder, twapCancelTime-weighted algorithmic trading
Asset TransfersusdSend, spotSend, sendAsset, withdraw3, usdClassTransferMove funds between accounts and off-platform
Account ManagementcreateSubAccount, subAccountTransfer, updateLeverage, updateIsolatedMarginSub-accounts, leverage, and margin settings
Vault OperationsvaultTransfer, NetChildVaultPositionsAction, approveAgentVault deposits, withdrawals, and agent permissions
Builder & MEVapproveBuilderFeeMEV builder fee approvals and payments
ReferralsregisterReferrer, setReferrerReferral program registration and attribution
Market DeploymentperpDeployLaunch new perpetual markets
Token OperationstokenDelegateToken delegation for governance/staking
EVM OperationsevmRawTx, evmUserModifyDirect smart contract interactions
DEX AbstractionagentEnableDexAbstraction, userDexAbstractionUnified DEX interface and advanced trading
Validator & GovernanceValidatorSignWithdrawalAction, VoteEthFinalizedWithdrawalAction, SetGlobalActionBridge security, governance, protocol upgrades
Multi-SignaturemultiSigTransactions requiring multiple approvals
UtilitynoopProtocol synchronization and placeholder transactions

Key Action Details

ActionDescriptionKey Fields
encomendaPlace new orders on the exchangea, b, p, s, r, t, c
cancelCancel orders by order IDa, o
twapOrderPlace algorithmic TWAP ordersduration, randomization
usdSendSend USD between usersdestination, amount, fee
withdraw3Withdraw funds from platformdestination, amount
vaultTransferTransfer to/from vaultsvault, amount, direction
evmRawTxRaw EVM transactionsRLP encoded data
perpDeployDeploy new perpetual marketsmarket parameters

Field Abbreviations:

  • a = asset, b = is buy, p = price, s = size, r = reduce only, t = order type, c = cloid, o = order ID
Response Structure

O resps field contains the result of each action:

{
"Full": [
[
"0xtransaction_hash",
[
{
"user": "0xuser_address",
"res": {
"status": "ok", // or "err"
"response": {
"type": "default" // or specific response data
}
}
}
]
]
]
}

Status values:

  • "ok" - Action executed successfully
  • "err" - Action failed (response contains error message)

API Usage

gRPC Streaming Only

Two gRPC methods stream this dataset:

  • Use the StreamBlocks method to receive every block.
  • Utilização StreamData with stream_type: BLOCKS to receive only the blocks that match a filter (by action type or user). Each delivered block still contains all of its actions and responses.
// Filter blocks by action type or user (gRPC StreamData)
const request = {
subscribe: {
stream_type: 'BLOCKS',
filters: {
"type": { values: ["order", "cancel", "twapOrder"] },
"user": { values: ["0x925a3877cd884b8edf3160192f76c7c251f83856"] }
}
}
};

Note: This dataset is only available on gRPC nodes, not through JSON-RPC or WebSocket APIs.

Blocks filtering matches recursively, so a block is delivered when any action or response in it matches your filter. The full block payload is returned; non-matching actions are not removed. See the Stream Filtering guide for field details.

Important Notes


  1. gRPC Nodes Only: This dataset is only available on gRPC nodes, not on regular full nodes
  2. Block Identifier: Utilizar redondo as the block number, not the file name
  3. Responses Required: Always check resps to see if actions succeeded or failed
  4. Highest Volume: This is the highest volume dataset - each block can contain thousands of actions
  5. Most Comprehensive: This captures EVERYTHING on HyperCore - if it happened on Hyperliquid, it's here
  6. Raw HyperCore Data: This is the raw blockchain data before any processing or aggregation
  7. Signature Verification: All actions include ECDSA signatures for verification
  8. Vault Actions: Actions from vaults include vaultAddress field

  • Orders - Processed order events derived from raw encomenda actions
  • Trades - Trade executions resulting from order matching
  • Events - Processed blockchain events derived from various actions
  • TWAP - TWAP order status updates from twapOrder e twapCancel actions
Partilhar este documento