Aperçu

Le blocs 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)
• Réponses (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

Champ	Type	Description
tour	entier	Block number (use this as the block identifier)
parent_round	entier	Previous block number
Heure	chaîne de caractères	Block timestamp (ISO 8601)
proposer	chaîne de caractères	Validator address who proposed this block
hardfork	objet	Current protocol version and activation block

Transaction Fields

Champ	Type	Description
signature	objet	ECDSA signature with r, s, v components
action	objet	The actual operation being performed (see Action Types)
Nonce	entier	Transaction nonce for replay protection
vaultAddress	chaîne|null	Present when action is performed by a vault
expiresAfter	integer|null	Expiry timestamp for the transaction (null when not set)
isFrontend	boolean|null	Indicates the transaction originated from the Hyperliquid frontend (null when not set)
broadcaster	chaîne de caractères	Address that broadcasted the transaction bundle
broadcaster_nonce	entier	Broadcaster's nonce for the bundle

Complete Action Types (34 Types)

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

Category	Action Types	Objectif
Trading	order, cancel, cancelByCloid, modify, batchModify, scheduleCancel	Place, modify, and cancel orders
TWAP Orders	twapOrder, twapCancel	Time-weighted algorithmic trading
Asset Transfers	usdSend, spotSend, sendAsset, withdraw3, usdClassTransfer	Move funds between accounts and off-platform
Account Management	createSubAccount, subAccountTransfer, updateLeverage, updateIsolatedMargin	Sub-accounts, leverage, and margin settings
Vault Operations	vaultTransfer, NetChildVaultPositionsAction, approveAgent	Vault deposits, withdrawals, and agent permissions
Builder & MEV	approveBuilderFee	MEV builder fee approvals and payments
Referrals	registerReferrer, setReferrer	Referral program registration and attribution
Market Deployment	perpDeploy	Launch new perpetual markets
Token Operations	tokenDelegate	Token delegation for governance/staking
EVM Operations	evmRawTx, evmUserModify	Direct smart contract interactions
DEX Abstraction	agentEnableDexAbstraction, userDexAbstraction	Unified DEX interface and advanced trading
Validator & Governance	ValidatorSignWithdrawalAction, VoteEthFinalizedWithdrawalAction, SetGlobalAction	Bridge security, governance, protocol upgrades
Multi-Signature	multiSig	Transactions requiring multiple approvals
Utility	noop	Protocol synchronization and placeholder transactions

Key Action Details

Action	Description	Key Fields
order	Place new orders on the exchange	a, b, p, s, r, t, c
cancel	Cancel orders by order ID	a, o
twapOrder	Place algorithmic TWAP orders	duration, randomization
usdSend	Send USD between users	destination, amount, fee
withdraw3	Withdraw funds from platform	destination, amount
vaultTransfer	Transfer to/from vaults	vault, amount, direction
evmRawTx	Raw EVM transactions	RLP encoded data
perpDeploy	Deploy new perpetual markets	market 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

Le 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.
• Utilisation 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: Use tour 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 champ

Related Streams

• Orders - Processed order events derived from raw order actions
• Trades - Trade executions resulting from order matching
• Events - Processed blockchain events derived from various actions
• TWAP - TWAP order status updates from twapOrder et twapCancel actions