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

Cancel action object

type

string

Action type ("cancel")

cancels

array

Array of orders to cancel

a

string

Asset name (e.g., "BTC", "ETH") or asset index as integer (0, 1, 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.

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 cancel action object in wire format

type

string

Action type ("cancel")

cancels

array

Array of orders to cancel in wire format

a

integer

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

o

integer

Order ID

summary

string

Human-readable summary of orders being cancelled (e.g., "Canceling 1 BTC order (OID: 123456789)")

assets

array

Array of asset information for the orders being cancelled

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": "cancel",
6
    "cancels": [
7
      {
8
        "a": "BTC",
9
        "o": 123456789
10
      }
11
    ]
12
  }
13
}'
14

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": "BTC",
9
        "o": 123456789
10
      }
11
    ]
12
  }
13
}'
14

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

3
const data = {
4
  action: {
5
    type: "cancel",
6
    cancels: [
7
      {
8
        a: "BTC",
9
        o: 123456789
10
      }
11
    ]
12
  }
13
};
14

15
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
16
  headers: { 'Content-Type': 'application/json' }
17
})
18
.then(response => console.log(response.data))
19
.catch(error => console.error(error));
20

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

3
const data = {
4
  action: {
5
    type: "cancel",
6
    cancels: [
7
      {
8
        a: "BTC",
9
        o: 123456789
10
      }
11
    ]
12
  }
13
};
14

15
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
16
  headers: { 'Content-Type': 'application/json' }
17
})
18
.then(response => console.log(response.data))
19
.catch(error => console.error(error));
20

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": "BTC",
12
        "o": 123456789
13
      }
14
    ]
15
  }
16
})
17

18
headers = {
19
  'Content-Type': 'application/json'
20
}
21

22
response = requests.request("POST", url, headers=headers, data=payload)
23

24
print(response.text)
25

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": "BTC",
12
        "o": 123456789
13
      }
14
    ]
15
  }
16
})
17

18
headers = {
19
  'Content-Type': 'application/json'
20
}
21

22
response = requests.request("POST", url, headers=headers, data=payload)
23

24
print(response.text)
25

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": "BTC",
18
        "o": 123456789
19
      }
20
    ]
21
  }
22
})
23

24
response = https.request(request)
25
puts response.read_body
26

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": "BTC",
18
        "o": 123456789
19
      }
20
    ]
21
  }
22
})
23

24
response = https.request(request)
25
puts response.read_body
26

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free