Skip to main content
POST
/
v1
/
exchange
/
modify
Modify Order
curl --request POST \
  --url https://api.hypereth.io/v1/exchange/modify \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": {
    "type": "modify",
    "oid": 123,
    "order": {}
  },
  "nonce": 123,
  "signature": {
    "r": "<string>",
    "s": "<string>",
    "v": 123
  }
}
'
{
  "status": "ok",
  "response": {
    "type": "modify",
    "data": {
      "oid": 123,
      "status": "<string>"
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
action
object
required
​
nonce
integer<int64>
required
​
signature
object
required

Response

Order modified successfully

Order modification response

​
status
enum<string>
Available options:
ok,
err
​
response
object