order (gRPC) | Hyperliquid API Docs

Submit new limit or market orders on Hyperliquid. The most common action type for trading operations.

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

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 - Cancel orders by order ID
cancelByCloid - Cancel orders by client order ID
batchModify - Modify multiple orders atomically
modify - Modify a single order

order - Submit Trading Orders