HyperliquidHyperliquid REST APITrading

Modify Order

Modify existing order parameters without canceling.

Rate Limit: 1 weight

Authentication: Required

POST
/v1/exchange/modify

Authorization

HyperliquidSignature
Authorization<token>

Hyperliquid uses a custom signing scheme for authentication.

Required for: All /exchange endpoints

Format: Signature generated using private key + nonce + action data

Headers:

  • Authorization: Signature
  • Content-Type: application/json

Important Notes:

  • Use official SDKs to avoid signing errors
  • Nonce must be current timestamp in milliseconds
  • Address fields must be lowercase
  • Order of fields in msgpack serialization matters

Common Pitfalls:

  • Not understanding the two signing schemes
  • Trailing zeros on numbers
  • Case sensitivity on addresses
  • Incorrect field ordering

In: header

Request Body

application/json

action*objectrequired
type*enum<string>required
Available options: modify
oid*integerrequired

Order ID to modify

order*objectrequired

New order parameters

nonce*integerrequired
signature*objectrequired
r*stringrequired
s*stringrequired
v*integerrequired

Response Body

application/json

application/json

application/json

curl -X POST "https://api.hypereth.io/v1/exchange/modify" \  -H "Content-Type: application/json" \  -d '{    "action": {      "type": "modify",      "oid": 0,      "order": {}    },    "nonce": 0,    "signature": {      "r": "string",      "s": "string",      "v": 0    }  }'
{
  "status": "ok",
  "response": {
    "type": "modify",
    "data": {
      "oid": 0,
      "status": "string"
    }
  }
}
{
  "error": "Insufficient margin for order placement",
  "code": 1001,
  "details": {}
}
{
  "error": "Insufficient margin for order placement",
  "code": 1001,
  "details": {}
}