Archival Data - Raw Blockchain & Trade Data

Complete raw Hyperliquid data in native formats, providing full blockchain state and trade execution history for replay, compliance, and research.

Available Raw Data Archives#

Archive	Available From	Format	Contents
Replica Commands	January 2025	`replica_cmds`	Complete blockchain state, all transactions, validator signatures
Node Trades	March 22 - May 25, 2025	`node_trades`	Basic trade execution data with both sides
Node Fills	May 25 - July 27, 2025	`node_fills`	Enhanced fills with PnL and fee tracking
Node Fills by Block	July 27, 2025 - Current	`node_fills_by_block`	Block-organized fills with builder info

Replica Commands Format#

The replica_cmds format provides the most comprehensive view of Hyperliquid blockchain activity, identical to data streamed via StreamBlocks gRPC.

Available from: January 2025 - Current

What's Included#

Block Headers: Height, timestamp, proposer address, hardfork version
Signed Action Bundles: All user-submitted transactions with cryptographic signatures
Execution Responses: Order statuses, fill confirmations, error messages
State Changes: Position updates, balance modifications, liquidations
Consensus Data: Validator votes, block proposals, finalization records

Data Structure#

{
  "abci_block": {
    "time": "2025-09-08T06:41:57.997372546",
    "round": 992814678,
    "parent_round": 992814677,
    "proposer": "0x5ac99df645f3414876c816caa18b2d234024b487",
    "hardfork": {
      "version": 57,
      "round": 990500929
    },
    "signed_action_bundles": [
      [
        "0xb4b1f5a9c233f9d90fd24b9961fd12708b36cc3d56f8fda47f32b667ee8d1227",
        {
          "signed_actions": [
            {
              "signature": {
                "r": "0xd931f13565ae66c3bc41a05da4180bb795dbd9ed2d365efaf639fd23b3774ac6",
                "s": "0x4a7a0534bf0a4238dfe404a88d335ab4c9b8222909100d773635e328d2ab864c",
                "v": 27
              },
              "action": {
                "type": "order",
                "orders": [{
                  "a": 170,
                  "b": true,
                  "p": "0.038385",
                  "s": "1514",
                  "r": false,
                  "t": { "limit": { "tif": "Ioc" } },
                  "c": "0x7192c49bcadb32d394e38617ea99cc09"
                }]
              },
              "nonce": 1757313597362
            }
          ],
          "broadcaster": "0x67e451964e0421f6e7d07be784f35c530667c2b3",
          "broadcaster_nonce": 1757313597367
        }
      ]
    ]
  },
  "resps": {
    "Full": [
      [
        "0xb4b1f5a9c233f9d90fd24b9961fd12708b36cc3d56f8fda47f32b667ee8d1227",
        [
          {
            "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
            "res": {
              "status": "ok",
              "response": {
                "type": "order",
                "data": {
                  "statuses": [{
                    "filled": {
                      "totalSz": "1514.0",
                      "avgPx": "0.038385",
                      "oid": 156190414943,
                      "cloid": "0x7192c49bcadb32d394e38617ea99cc09"
                    }
                  }]
                }
              }
            }
          }
        ]
      ]
    ]
  }
}

Field Reference#

Top-Level Fields:

abci_block: Block header and transaction data
- time: ISO-8601 timestamp with nanosecond precision
- round: Current block number (height)
- parent_round: Previous block number
- proposer: Block proposer address (40 hex chars)
- hardfork: Protocol version information
- signed_action_bundles: Array of transaction bundles
resps: Execution responses for all actions
- Full: Array matching structure of signed_action_bundles
- Each response includes user address and result status

Action Types:

order: Place limit/market orders
cancel: Cancel orders by order ID
cancelByCloid: Cancel orders by client order ID
batchModify: Modify multiple orders
evmRawTx: Execute EVM transactions

For complete field documentation, see the StreamBlocks reference.

Use Cases#

Complete Blockchain Replay: Reconstruct full blockchain state from genesis
Transaction Analysis: Analyze all transaction types and execution patterns
State Verification: Verify blockchain state transitions
Order Book Reconstruction: Rebuild historical order book states
Protocol Research: Study consensus behavior and validator activity
Compliance & Auditing: Maintain complete audit trails with cryptographic signatures

Node Trades Format#

Available: March 22, 2025 - May 25, 2025

The node_trades format captures basic trade execution data with information for both sides of each trade.

{
  "coin": "PURR",
  "side": "B",
  "time": "2025-03-22T23:00:00.000984711",
  "px": "0.12928",
  "sz": "1547.0",
  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "trade_dir_override": "Na",
  "side_info": [
    {
      "user": "0xa68c548f3acd23a7fe3e867cc47f302559794419",
      "start_pos": "2462968.0",
      "oid": 81305166697,
      "twap_id": 568722,
      "cloid": null
    },
    {
      "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
      "start_pos": "-15493993.0",
      "oid": 81305141429,
      "twap_id": null,
      "cloid": "0x6640b7cba22f65c630e7fb18b18819b6"
    }
  ]
}

Field Descriptions:

Field	Description
`coin`	Trading pair symbol
`side`	Buy (B) or Sell (A)
`time`	Execution timestamp (ISO 8601)
`px`	Execution price
`sz`	Trade size
`hash`	Transaction hash
`trade_dir_override`	Direction override flag
`side_info`	Array containing details for both sides
`side_info[].user`	Wallet address
`side_info[].start_pos`	Position before trade
`side_info[].oid`	Order ID
`side_info[].twap_id`	TWAP order ID (if applicable)
`side_info[].cloid`	Client order ID

Node Fills Format#

Available: May 25, 2025 - July 27, 2025

The node_fills format includes comprehensive fill information with PnL calculations and fee tracking.

[
  "0xe3b6e3443c8f2080704e7421bad9340f13950acb",
  {
    "coin": "ETH",
    "px": "2511.2",
    "sz": "0.486",
    "side": "B",
    "time": 1748183573109,
    "startPosition": "-946.9372",
    "dir": "Close Short",
    "closedPnl": "-2.5515",
    "hash": "0x71fe8c1aa48f3a43971504242beb2502023600245b77a4f664b49f10a236d9e2",
    "oid": 97128733943,
    "crossed": false,
    "fee": "-0.036613",
    "tid": 995829841758483,
    "cloid": "0x00000000000000002bca2ffb27459396",
    "feeToken": "USDC"
  }
]

Field Descriptions:

Field	Description
First element	User wallet address
`coin`	Trading pair
`px`	Fill price
`sz`	Fill size
`side`	Buy (B) or Ask (A)
`time`	Unix timestamp (milliseconds)
`startPosition`	Position before fill
`dir`	Trade direction (Open Long, Close Short, etc.)
`closedPnl`	Realized PnL from closed positions
`hash`	Transaction hash
`oid`	Order ID
`crossed`	Whether order crossed the spread
`fee`	Trading fee (negative for rebate)
`tid`	Trade ID
`cloid`	Client order ID
`feeToken`	Currency used for fees

Node Fills by Block Format#

Available: July 27, 2025 - Current

The current node_fills_by_block format organizes fills within block context with builder information.

{
  "local_time": "2025-07-27T08:50:10.334741319",
  "block_time": "2025-07-27T08:50:10.273720809",
  "block_number": 676607012,
  "events": [
    [
      "0x7839e2f2c375dd2935193f2736167514efff9916",
      {
        "coin": "BTC",
        "px": "118136.0",
        "sz": "0.00009",
        "side": "B",
        "time": 1753606210273,
        "startPosition": "-1.41864",
        "dir": "Close Short",
        "closedPnl": "-0.003753",
        "hash": "0xe7822040155eaa2e737e042854342401120052bbf063906ce8c8f3babe853a79",
        "oid": 121670079265,
        "crossed": false,
        "fee": "-0.000212",
        "tid": 161270588369408,
        "cloid": "0x09367b9f8541c581f95b02aaf05f1508",
        "feeToken": "USDC",
        "builder": "0x49ae63056b3a0be0b166813ee687309ab653c07c",
        "builderFee": "0.005528"
      }
    ]
  ]
}

Field Descriptions:

Field	Description
`local_time`	Local server timestamp
`block_time`	Blockchain block timestamp
`block_number`	Block height
`events`	Array of fill events in the block
`events[][0]`	User wallet address
`events[][1].coin`	Trading pair
`events[][1].px`	Fill price
`events[][1].sz`	Fill size
`events[][1].side`	Buy (B) or Ask (A)
`events[][1].time`	Unix timestamp (milliseconds)
`events[][1].startPosition`	Position before fill
`events[][1].dir`	Trade direction
`events[][1].closedPnl`	Realized PnL
`events[][1].hash`	Transaction hash
`events[][1].oid`	Order ID
`events[][1].crossed`	Whether order crossed spread
`events[][1].fee`	Trading fee
`events[][1].tid`	Trade ID
`events[][1].cloid`	Client order ID
`events[][1].feeToken`	Fee currency
`events[][1].builder`	Block builder address
`events[][1].builderFee`	Fee paid to builder

Delivery Options#

Method	Status	Description
Bulk Download	Available	S3/GCS bucket access
REST API	Coming Soon	Query-based access with filtering

Data Quality#

Completeness: No gaps in data from stated availability dates
Verification: Data validated against on-chain state
Format Consistency: Native Hyperliquid formats preserved exactly

Need	Recommendation
Pre-aggregated price data	OHLCV Data
Cleaned tick-by-tick trades	Tick Data
Real-time order book	Order Book Server

Access#

Contact the Dwellir team for archival data access:

Email: ben@dwellir.com

Include in your request:

Data type(s) needed (replica_cmds, node_trades, node_fills, node_fills_by_block)
Date range required
Delivery preference (bulk download or streaming)
Use case description

Available Raw Data Archives#

Replica Commands Format#

What's Included#

Data Structure#

Field Reference#

Use Cases#

Node Trades Format#

Node Fills Format#

Node Fills by Block Format#

Delivery Options#

Data Quality#

Related Data Products#

Access#