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

Cancel action object in wire format (from build-cancel response)

type

string

Action type ("cancel")

cancels

array

Array of orders to cancel

a

integer

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

o

integer

Order ID

f

boolean

Optional. Set to true to request a Hyperliquid fast cancel. Omit when not using fast cancel; f: false is removed before the action is signed.

nonce

integer

REQUIRED

Nonce from build-cancel 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 cancellation was successfully submitted

user

string

User address (0x-prefixed hex string)

exchangeResponse

object

Response from Hyperliquid exchange with cancellation 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": "cancel",
6
    "cancels": [
7
      {
8
        "a": 0,
9
        "o": 123456789
10
      }
11
    ]
12
  },
13
  "nonce": 1234567890,
14
  "signature": {
15
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
16
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
17
    "v": 28
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": "cancel",
6
    "cancels": [
7
      {
8
        "a": 0,
9
        "o": 123456789
10
      }
11
    ]
12
  },
13
  "nonce": 1234567890,
14
  "signature": {
15
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
16
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
17
    "v": 28
18
  }
19
}'
20

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

3
const data = {
4
  action: {
5
    type: "cancel",
6
    cancels: [
7
      {
8
        a: 0,
9
        o: 123456789
10
      }
11
    ]
12
  },
13
  nonce: 1234567890,
14
  signature: {
15
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
16
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
17
    v: 28
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: "cancel",
6
    cancels: [
7
      {
8
        a: 0,
9
        o: 123456789
10
      }
11
    ]
12
  },
13
  nonce: 1234567890,
14
  signature: {
15
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
16
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
17
    v: 28
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": "cancel",
9
    "cancels": [
10
      {
11
        "a": 0,
12
        "o": 123456789
13
      }
14
    ]
15
  },
16
  "nonce": 1234567890,
17
  "signature": {
18
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
19
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
20
    "v": 28
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": "cancel",
9
    "cancels": [
10
      {
11
        "a": 0,
12
        "o": 123456789
13
      }
14
    ]
15
  },
16
  "nonce": 1234567890,
17
  "signature": {
18
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
19
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
20
    "v": 28
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": "cancel",
15
    "cancels": [
16
      {
17
        "a": 0,
18
        "o": 123456789
19
      }
20
    ]
21
  },
22
  "nonce": 1234567890,
23
  "signature": {
24
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
25
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
26
    "v": 28
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": "cancel",
15
    "cancels": [
16
      {
17
        "a": 0,
18
        "o": 123456789
19
      }
20
    ]
21
  },
22
  "nonce": 1234567890,
23
  "signature": {
24
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
25
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
26
    "v": 28
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