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

Approve builder fee action object (from build-approval response)

type

string

Action type ("approveBuilderFee")

maxFeeRate

string

Maximum builder fee rate (e.g., "1%" for approval, "0%" for revocation)

nonce

integer

REQUIRED

Nonce from build-approval response

signature

object

REQUIRED

Wallet signature

r

string

Signature r value

s

string

Signature s value

v

integer

Signature v value

Returns

approved

boolean

Whether the builder fee approval was successful

builder

string

Builder address (0x-prefixed hex string)

maxFeeRate

string

Maximum builder fee rate that was approved (e.g., "1%")

user

string

User address (0x-prefixed hex string)

message

string

Status message

exchangeResponse

object

Response from Hyperliquid exchange with approval confirmation

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": "approveBuilderFee",
6
    "maxFeeRate": "1%"
7
  },
8
  "nonce": 1234567890,
9
  "signature": {
10
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
11
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
12
    "v": 28
13
  }
14
}'
15

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": "approveBuilderFee",
6
    "maxFeeRate": "1%"
7
  },
8
  "nonce": 1234567890,
9
  "signature": {
10
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
11
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
12
    "v": 28
13
  }
14
}'
15

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

3
const data = {
4
  action: {
5
    type: "approveBuilderFee",
6
    maxFeeRate: "1%"
7
  },
8
  nonce: 1234567890,
9
  signature: {
10
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
11
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
12
    v: 28
13
  }
14
};
15

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

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

3
const data = {
4
  action: {
5
    type: "approveBuilderFee",
6
    maxFeeRate: "1%"
7
  },
8
  nonce: 1234567890,
9
  signature: {
10
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
11
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
12
    v: 28
13
  }
14
};
15

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

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": "approveBuilderFee",
9
    "maxFeeRate": "1%"
10
  },
11
  "nonce": 1234567890,
12
  "signature": {
13
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
14
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
15
    "v": 28
16
  }
17
})
18

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

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

25
print(response.text)
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": "approveBuilderFee",
9
    "maxFeeRate": "1%"
10
  },
11
  "nonce": 1234567890,
12
  "signature": {
13
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
14
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
15
    "v": 28
16
  }
17
})
18

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

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

25
print(response.text)
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": "approveBuilderFee",
15
    "maxFeeRate": "1%"
16
  },
17
  "nonce": 1234567890,
18
  "signature": {
19
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
20
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
21
    "v": 28
22
  }
23
})
24

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

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": "approveBuilderFee",
15
    "maxFeeRate": "1%"
16
  },
17
  "nonce": 1234567890,
18
  "signature": {
19
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
20
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
21
    "v": 28
22
  }
23
})
24

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free