twapOrder (gRPC) | Hyperliquid API Docs

Submit TWAP orders on Hyperliquid for gradual position building with minimal market impact.

Submit a Time-Weighted Average Price (TWAP) order that executes gradually over a specified time period. TWAP orders split large orders into smaller pieces to minimize market impact.

Sample Data

JSON

{
  "signature": {
    "r": "0xec414de7c86d85e3c73aba1ed8496e15f48acb37ec7f9b52a1c7d76f091ccd45",
    "s": "0x373d79f4d9731a69b4d93ccebf3fa711eae9550be65878c9358f30b20e798e4b",
    "v": 28
  },
  "action": {
    "type": "twapOrder",
    "twap": {
      "a": 10260,
      "b": true,
      "s": "215.72",
      "r": false,
      "m": 1440,
      "t": false
    }
  },
  "nonce": 1768146926099
}

View this transaction on Hypurrscan

Field Reference

Action Fields

Field	Type	Description
`type`	string	Always `"twapOrder"`
`a`	number	Asset index (e.g., 0 = BTC)
`b`	boolean	Side: `true` for buy, `false` for sell
`s`	string	Total size to execute
`r`	boolean	Reduce-only flag
`m`	number	Duration in minutes
`t`	boolean	Randomize execution (avoid predictable patterns)

TWAP Execution

TWAP orders:

Split total size into smaller child orders
Execute over the specified duration
Can be randomized to avoid detection
Minimize market impact for large positions

Use Cases

Institutional Order Detection

Track TWAP order submissions for large position building:

Python

def process_twapOrder_action(action):
    asset = action.get('a')
    side = 'BUY' if action.get('b') else 'SELL'
    size = action.get('s')
    duration = action.get('m')

    print(f"TWAP: {side} {size} of asset {asset} over {duration} minutes")

Market Impact Analysis

Monitor TWAP activity to understand institutional positioning.

Execution Quality Research

Study TWAP execution patterns and slippage.

twapCancel - Cancel TWAP orders
order - Standard orders
batchModify - Batch modifications

twapOrder - Time-Weighted Average Price Orders