info

Exchange API calls do not consume Quicknode API credits. Transactions through this endpoint are appended with a builder fee. See hyperliquidapi.com for a full breakdown. To white-label with your own builder code, contact us.

This endpoint is not a drop-in replacement for Hyperliquid's native /exchange endpoint. See the Exchange API Overview for key differences.

Body Parameters

action

object

REQUIRED

Batch modify action object in wire format (from build-modify response)

type

string

Action type ("batchModify")

modifies

array

Array of order modifications

oid

integer

Order ID to modify

order

object

Modified order parameters in wire format

a

integer

Asset index

b

boolean

Buy side

p

string

New price

s

string

New size

r

boolean

Reduce-only flag

t

object

Order type specification

limit

object

Limit order type

tif

string

Time in force

nonce

integer

REQUIRED

Nonce from build-modify response

signature

object

REQUIRED

Wallet signature

r

string

Signature r value

s

string

Signature s value

v

integer

Signature v value

vaultAddress

string

Optional vault address

expiresAfter

integer

Optional expiration timestamp (ms)

Returns

success

boolean

Whether the modification was successfully submitted

user

string

User address (0x-prefixed hex string)

exchangeResponse

object

Response from Hyperliquid exchange with modification details

Request

1
curl -s -X POST https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "action": {
5
    "type": "batchModify",
6
    "modifies": [
7
      {
8
        "oid": 123456789,
9
        "order": {
10
          "a": 0,
11
          "b": true,
12
          "p": "101000",
13
          "s": "0.002",
14
          "r": false,
15
          "t": {"limit": {"tif": "Gtc"}}
16
        }
17
      }
18
    ]
19
  },
20
  "nonce": 1234567890,
21
  "signature": {
22
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
23
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
24
    "v": 28
25
  }
26
}'
27

1
curl -s -X POST https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "action": {
5
    "type": "batchModify",
6
    "modifies": [
7
      {
8
        "oid": 123456789,
9
        "order": {
10
          "a": 0,
11
          "b": true,
12
          "p": "101000",
13
          "s": "0.002",
14
          "r": false,
15
          "t": {"limit": {"tif": "Gtc"}}
16
        }
17
      }
18
    ]
19
  },
20
  "nonce": 1234567890,
21
  "signature": {
22
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
23
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
24
    "v": 28
25
  }
26
}'
27

1
const axios = require('axios');
2

3
const data = {
4
  action: {
5
    type: "batchModify",
6
    modifies: [
7
      {
8
        oid: 123456789,
9
        order: {
10
          a: 0,
11
          b: true,
12
          p: "101000",
13
          s: "0.002",
14
          r: false,
15
          t: { limit: { tif: "Gtc" } }
16
        }
17
      }
18
    ]
19
  },
20
  nonce: 1234567890,
21
  signature: {
22
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
23
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
24
    v: 28
25
  }
26
};
27

28
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
29
  headers: { 'Content-Type': 'application/json' }
30
})
31
.then(response => console.log(response.data))
32
.catch(error => console.error(error));
33

1
const axios = require('axios');
2

3
const data = {
4
  action: {
5
    type: "batchModify",
6
    modifies: [
7
      {
8
        oid: 123456789,
9
        order: {
10
          a: 0,
11
          b: true,
12
          p: "101000",
13
          s: "0.002",
14
          r: false,
15
          t: { limit: { tif: "Gtc" } }
16
        }
17
      }
18
    ]
19
  },
20
  nonce: 1234567890,
21
  signature: {
22
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
23
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
24
    v: 28
25
  }
26
};
27

28
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
29
  headers: { 'Content-Type': 'application/json' }
30
})
31
.then(response => console.log(response.data))
32
.catch(error => console.error(error));
33

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange"
5

6
payload = json.dumps({
7
  "action": {
8
    "type": "batchModify",
9
    "modifies": [
10
      {
11
        "oid": 123456789,
12
        "order": {
13
          "a": 0,
14
          "b": True,
15
          "p": "101000",
16
          "s": "0.002",
17
          "r": False,
18
          "t": {"limit": {"tif": "Gtc"}}
19
        }
20
      }
21
    ]
22
  },
23
  "nonce": 1234567890,
24
  "signature": {
25
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
26
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
27
    "v": 28
28
  }
29
})
30

31
headers = {
32
  'Content-Type': 'application/json'
33
}
34

35
response = requests.request("POST", url, headers=headers, data=payload)
36

37
print(response.text)
38

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange"
5

6
payload = json.dumps({
7
  "action": {
8
    "type": "batchModify",
9
    "modifies": [
10
      {
11
        "oid": 123456789,
12
        "order": {
13
          "a": 0,
14
          "b": True,
15
          "p": "101000",
16
          "s": "0.002",
17
          "r": False,
18
          "t": {"limit": {"tif": "Gtc"}}
19
        }
20
      }
21
    ]
22
  },
23
  "nonce": 1234567890,
24
  "signature": {
25
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
26
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
27
    "v": 28
28
  }
29
})
30

31
headers = {
32
  'Content-Type': 'application/json'
33
}
34

35
response = requests.request("POST", url, headers=headers, data=payload)
36

37
print(response.text)
38

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "action": {
14
    "type": "batchModify",
15
    "modifies": [
16
      {
17
        "oid": 123456789,
18
        "order": {
19
          "a": 0,
20
          "b": true,
21
          "p": "101000",
22
          "s": "0.002",
23
          "r": false,
24
          "t": {"limit": {"tif": "Gtc"}}
25
        }
26
      }
27
    ]
28
  },
29
  "nonce": 1234567890,
30
  "signature": {
31
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
32
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
33
    "v": 28
34
  }
35
})
36

37
response = https.request(request)
38
puts response.read_body
39

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "action": {
14
    "type": "batchModify",
15
    "modifies": [
16
      {
17
        "oid": 123456789,
18
        "order": {
19
          "a": 0,
20
          "b": true,
21
          "p": "101000",
22
          "s": "0.002",
23
          "r": false,
24
          "t": {"limit": {"tif": "Gtc"}}
25
        }
26
      }
27
    ]
28
  },
29
  "nonce": 1234567890,
30
  "signature": {
31
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
32
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
33
    "v": 28
34
  }
35
})
36

37
response = https.request(request)
38
puts response.read_body
39

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free