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

Processed leverage or margin action from the Build Leverage or Margin Action response

type

string

Action type ("updateLeverage", "updateIsolatedMargin", or "topUpIsolatedOnlyMargin")

nonce

integer

REQUIRED

Nonce from the Build Leverage or Margin Action response (timestamp in milliseconds)

signature

object

REQUIRED

ECDSA signature of the hash from Build Leverage or Margin Action

r

string

Signature r value (0x-prefixed hex string)

s

string

Signature s value (0x-prefixed hex string)

v

integer

Signature v value (27 or 28)

Returns

success

boolean

Whether the action was successfully submitted

user

string

User address (0x-prefixed hex string)

exchangeResponse

object

Response from Hyperliquid exchange

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": "updateLeverage",
6
    "asset": 0,
7
    "isCross": true,
8
    "leverage": 10
9
  },
10
  "nonce": 1234567890,
11
  "signature": {
12
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
13
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
14
    "v": 28
15
  }
16
}'
17

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": "updateLeverage",
6
    "asset": 0,
7
    "isCross": true,
8
    "leverage": 10
9
  },
10
  "nonce": 1234567890,
11
  "signature": {
12
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
13
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
14
    "v": 28
15
  }
16
}'
17

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

3
const data = {
4
  action: {
5
    type: "updateLeverage",
6
    asset: 0,
7
    isCross: true,
8
    leverage: 10
9
  },
10
  nonce: 1234567890,
11
  signature: {
12
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
13
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
14
    v: 28
15
  }
16
};
17

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

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

3
const data = {
4
  action: {
5
    type: "updateLeverage",
6
    asset: 0,
7
    isCross: true,
8
    leverage: 10
9
  },
10
  nonce: 1234567890,
11
  signature: {
12
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
13
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
14
    v: 28
15
  }
16
};
17

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

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange"
5
payload = json.dumps({
6
  "action": {
7
    "type": "updateLeverage",
8
    "asset": 0,
9
    "isCross": True,
10
    "leverage": 10
11
  },
12
  "nonce": 1234567890,
13
  "signature": {
14
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
15
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
16
    "v": 28
17
  }
18
})
19
headers = { 'Content-Type': 'application/json' }
20
response = requests.request("POST", url, headers=headers, data=payload)
21
print(response.text)
22

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange"
5
payload = json.dumps({
6
  "action": {
7
    "type": "updateLeverage",
8
    "asset": 0,
9
    "isCross": True,
10
    "leverage": 10
11
  },
12
  "nonce": 1234567890,
13
  "signature": {
14
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
15
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
16
    "v": 28
17
  }
18
})
19
headers = { 'Content-Type': 'application/json' }
20
response = requests.request("POST", url, headers=headers, data=payload)
21
print(response.text)
22

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

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange")
6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8
request = Net::HTTP::Post.new(url)
9
request["Content-Type"] = "application/json"
10
request.body = JSON.dump({
11
  action: {
12
    type: "updateLeverage",
13
    asset: 0,
14
    isCross: true,
15
    leverage: 10
16
  },
17
  nonce: 1234567890,
18
  signature: {
19
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
20
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
21
    v: 28
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
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8
request = Net::HTTP::Post.new(url)
9
request["Content-Type"] = "application/json"
10
request.body = JSON.dump({
11
  action: {
12
    type: "updateLeverage",
13
    asset: 0,
14
    isCross: true,
15
    leverage: 10
16
  },
17
  nonce: 1234567890,
18
  signature: {
19
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
20
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
21
    v: 28
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