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.

Body Parameters

action

object

REQUIRED

Batch modify action object

type

string

Action type ("batchModify")

modifies

array

Array of order modifications

oid

integer

Order ID to modify

order

object

New order parameters in wire format

a

string

Asset name (e.g., "BTC", "ETH") or asset index as integer (0, 1, etc.)

b

boolean

Buy side (true for buy, false for sell)

p

string

New limit price as a stringified number

s

string

New size/quantity as a stringified number

r

boolean

Reduce-only flag

t

object

Order type specification

limit

object

Limit order type

tif

string

Time in force ("Gtc", "Ioc", "Alo")

vaultAddress

string

Optional vault address

expiresAfter

integer

Optional expiration timestamp (ms)

Returns

hash

string

Hash to sign with wallet (0x-prefixed hex string)

nonce

integer

Unique nonce for this action (timestamp in milliseconds)

action

object

Processed batchModify action object in wire format

type

string

Action type ("batchModify")

modifies

array

Array of order modifications in wire format

oid

integer

Order ID to modify

order

object

Modified order parameters in wire format

a

integer

Asset index (0 for BTC, 1 for ETH, etc.)

b

boolean

Buy side (true for buy, false for sell)

p

string

New limit price as a stringified number

s

string

New size/quantity as a stringified number

r

boolean

Reduce-only flag

t

object

Order type specification

limit

object

Limit order type

tif

string

Time in force ("Gtc", "Ioc", "Alo")

summary

string

Human-readable summary of order modifications (e.g., "Modifying 1 BTC order (OID: 123456789)")

assets

array

Array of asset information for the orders being modified

index

integer

Asset index (0 for BTC, 1 for ETH, etc.)

name

string

Asset name (e.g., "BTC", "ETH")

isSpot

boolean

Whether this is a spot market asset

szDecimals

integer

Number of decimal places for size/quantity

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
          "asset": "BTC",
11
          "side": "buy",
12
          "price": "101000",
13
          "size": "0.002",
14
          "tif": "gtc"
15
        }
16
      }
17
    ]
18
  }
19
}'
20

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
          "asset": "BTC",
11
          "side": "buy",
12
          "price": "101000",
13
          "size": "0.002",
14
          "tif": "gtc"
15
        }
16
      }
17
    ]
18
  }
19
}'
20

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

3
const data = {
4
  action: {
5
    type: "batchModify",
6
    modifies: [
7
      {
8
        oid: 123456789,
9
        order: {
10
          asset: "BTC",
11
          side: "buy",
12
          price: "101000",
13
          size: "0.002",
14
          tif: "gtc"
15
        }
16
      }
17
    ]
18
  }
19
};
20

21
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
22
  headers: { 'Content-Type': 'application/json' }
23
})
24
.then(response => console.log(response.data))
25
.catch(error => console.error(error));
26

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

3
const data = {
4
  action: {
5
    type: "batchModify",
6
    modifies: [
7
      {
8
        oid: 123456789,
9
        order: {
10
          asset: "BTC",
11
          side: "buy",
12
          price: "101000",
13
          size: "0.002",
14
          tif: "gtc"
15
        }
16
      }
17
    ]
18
  }
19
};
20

21
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
22
  headers: { 'Content-Type': 'application/json' }
23
})
24
.then(response => console.log(response.data))
25
.catch(error => console.error(error));
26

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
          "asset": "BTC",
14
          "side": "buy",
15
          "price": "101000",
16
          "size": "0.002",
17
          "tif": "gtc"
18
        }
19
      }
20
    ]
21
  }
22
})
23

24
headers = {
25
  'Content-Type': 'application/json'
26
}
27

28
response = requests.request("POST", url, headers=headers, data=payload)
29

30
print(response.text)
31

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
          "asset": "BTC",
14
          "side": "buy",
15
          "price": "101000",
16
          "size": "0.002",
17
          "tif": "gtc"
18
        }
19
      }
20
    ]
21
  }
22
})
23

24
headers = {
25
  'Content-Type': 'application/json'
26
}
27

28
response = requests.request("POST", url, headers=headers, data=payload)
29

30
print(response.text)
31

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
          "asset": "BTC",
20
          "side": "buy",
21
          "price": "101000",
22
          "size": "0.002",
23
          "tif": "gtc"
24
        }
25
      }
26
    ]
27
  }
28
})
29

30
response = https.request(request)
31
puts response.read_body
32

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
          "asset": "BTC",
20
          "side": "buy",
21
          "price": "101000",
22
          "size": "0.002",
23
          "tif": "gtc"
24
        }
25
      }
26
    ]
27
  }
28
})
29

30
response = https.request(request)
31
puts response.read_body
32

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free