order payload (gRPC) | Hyperliquid API Docs

Decode Hyperliquid `order` payloads for trading orders, returned through Dwellir's read-only L1 gRPC API.

Read-only action reference

Dwellir's Hyperliquid gRPC API returns this decoded action payload through StreamBlocks and GetBlock. It does not submit or execute this action. Submit supported user write actions through Hyperliquid's native POST /exchange endpoint.

The decoded order action payload records one or more limit, market, or trigger orders submitted to Hyperliquid. It is the most frequently observed trading action in Hyperliquid block data.

Sample Data

JSON

{
  "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:

JSON

// 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:

Python

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 - Order cancellations by ID
cancelByCloid - Order cancellations by client ID
batchModify - Batched order modifications
modify - Single-order modifications

order payload - Trading Orders