Hyperliquid TWAP Statuses - Node Data

node_twap_statuses_by_block records lifecycle updates for time-weighted average price (TWAP) orders. Each event includes the TWAP identifier, current aggregate state, and lifecycle status.

AccessCopy Anchor Link

File layoutCopy Anchor Link

node_twap_statuses_by_block/<YYYYMMDD>/<hour>.lz4

Files contain JSON block envelopes with TWAP lifecycle objects in events.

For download planning, see compressed size and file count. Measure TWAP statuses and fills separately for the same date range when you need both.

Sample dataCopy Anchor Link

{
  "local_time": "2026-01-01T00:00:00.100000000",
  "block_time": "2026-01-01T00:00:00.000000000",
  "block_number": 12345,
  "events": [
    {
      "time": "2026-01-01T00:00:00.000000000",
      "twap_id": 101,
      "state": {
        "coin": "kPEPE",
        "user": "<redacted-user>",
        "side": "B",
        "sz": "555555.0",
        "executedSz": "555555.0",
        "executedNtl": "1371.51378",
        "minutes": 5,
        "reduceOnly": false,
        "randomize": false,
        "timestamp": 1704067200000
      },
      "status": "finished"
    }
  ]
}

This is synthetic representative data. The production account identifier uses a visible <redacted-user> marker, and the TWAP identifier is synthetic.

Important fieldsCopy Anchor Link

This is lifecycle state, not a fill-by-fill log. Use fills for individual executions.

Join twap_id to a fill's twapId, not its child-order oid. Aggregate execution fields describe lifecycle boundaries rather than continuous progress.

Use signed block actions and responses for submission attempts and cancellations. A fills-derived sample excludes TWAPs that never execute.

For activity already running at your selection's start, include earlier lifecycle records or a matching state seed. See TWAP research validation.

Observed fieldsCopy Anchor Link

[] marks an array element, [0] a tuple position, <name> an object whose type is that name, and {key} a map keyed by user, asset, or ID. Values after a colon are every distinct value seen for a short enum field. A field missing here can still appear in record types the sample did not contain.

Generated from 49,867 records in node_twap_statuses_by_block/20261021/14.lz4 (2026-10-21).

block_number                     number
block_time                       string
events                           array
events[]                         object
  state                          object
    coin                         string
    executedNtl                  string
    executedSz                   string
    minutes                      number
    randomize                    bool
    reduceOnly                   bool
    side                         string: A, B
    stopPx                       null | string
    sz                           string
    timestamp                    number
    trigger                      null | object
      above                      bool
      px                         string
    user                         string
  status                         object | string: activated, finished, stopped, terminated, waitingForTrigger
    error                        string
  time                           string
  twap_id                        number
local_time                       string

Related pagesCopy Anchor Link

• TWAP order action — Decode the signed payload that starts a TWAP.
• TWAP cancel action — Decode TWAP cancellation payloads.
• Indexed TWAP summaries — Query execution-derived summaries for one user.
• Indexed TWAP slice fills — Query the individual executions produced by TWAP slices.