batchModify

post

https://api.hyperliquid.xyzhttps://api.hyperliquid-testnet.xyz

/exchange

Modify multiple orders.

Body

application/json

Modify multiple orders.

nonceintegerRequired

Unique request identifier (current timestamp in ms).

vaultAddressstring · min: 42 · max: 42Optional

Vault address (for vault trading).

Pattern: ^0[xX][0-9a-fA-F]+$

expiresAfterintegerOptional

Expiration time of the action.

Responses

200

Response for order placement and batch modifications.

application/json

422

Failed to deserialize the JSON body into the target type

text/plain

post

/exchange

HTTPcURLJavaScriptPython

POST /exchange HTTP/1.1
Host: api.hyperliquid.xyz
Content-Type: application/json
Accept: */*
Content-Length: 243

{
  "action": {
    "type": "batchModify",
    "modifies": [
      {
        "oid": 1,
        "order": {
          "a": 1,
          "b": true,
          "p": "text",
          "s": "text",
          "r": true,
          "t": {
            "limit": {
              "tif": "Gtc"
            }
          },
          "c": "text"
        }
      }
    ]
  },
  "nonce": 1,
  "signature": {
    "r": "text",
    "s": "text",
    "v": 27
  },
  "vaultAddress": "text",
  "expiresAfter": 1
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [
        {
          "resting": {
            "oid": 1,
            "cloid": "text"
          }
        }
      ]
    }
  }
}