order

Submit new limit or market orders on Hyperliquid. This is the most frequently occurring action type, representing the core trading functionality of the exchange.

Sample Data#

{
  "signature": {
    "r": "0x961237313a71a702d4ca5f870a32172f3929aa9328d80505cbc5b9b178d2e338",
    "s": "0x8d0bc7bb0119bf5daac5e93a9552166e4a2f10bd711c26909e206aeb81eac89",
    "v": 28
  },
  "action": {
    "type": "order",
    "orders": [
      {
        "a": 216,
        "b": false,
        "p": "0.26832",
        "s": "2021",
        "r": false,
        "t": {
          "limit": {
            "tif": "Ioc"
          }
        },
        "c": "0x00000000000000000b56a217a8ef1f3c"
      }
    ],
    "grouping": "na"
  },
  "nonce": 1768146912522,
  "expiresAfter": 1768146932522
}

View this transaction on Hypurrscan →

Field Reference#

Action Fields#

Field	Type	Description
`type`	string	Always `"order"`
`orders`	array	Array of order objects to submit
`grouping`	string	Order grouping strategy: `"na"` (none), `"normalTpsl"`, or `"positionTpsl"`

Order Object Fields#

Field	Type	Description
`a`	number	Asset index (e.g., 0=BTC, 1=ETH)
`b`	boolean	`true` for buy, `false` for sell
`p`	string	Limit price
`s`	string	Size in base currency
`r`	boolean	Reduce-only flag
`t`	object	Order type configuration
`c`	string	Client order ID (optional)

Order Type Configuration#

The t field specifies order execution behavior:

// Limit order with time-in-force
{ "limit": { "tif": "Gtc" } }  // Good-til-canceled
{ "limit": { "tif": "Ioc" } }  // Immediate-or-cancel
{ "limit": { "tif": "Alo" } }  // Add-liquidity-only (post-only)

// Market order
{ "trigger": { "isMarket": true, "triggerPx": "0", "tpsl": "tp" } }

Optional Fields#

Field	Type	Description
`vaultAddress`	string	Vault executing the order (if vault trading)
`expiresAfter`	number	Expiration timestamp in milliseconds

Use Cases#

Order Flow Analysis#

Track all order submissions to understand market activity:

def process_order_action(action):
    for order in action.get('orders', []):
        asset = order['a']
        side = 'BUY' if order['b'] else 'SELL'
        price = order['p']
        size = order['s']

        print(f"New order: {side} {size} @ {price} (asset {asset})")

Trading Bot Monitoring#

Monitor competitor or whale trading activity by tracking order submissions from specific addresses.

Market Microstructure Research#

Analyze order placement patterns, timing, and pricing strategies across the Hyperliquid order book.

cancel - Cancel orders by order ID
cancelByCloid - Cancel orders by client order ID
batchModify - Modify multiple orders atomically
modify - Modify a single order