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

Leverage or margin action object. The type field determines which operation is performed and which additional fields are required.

type

string

Action type. Supported values: "updateLeverage", "updateIsolatedMargin", "topUpIsolatedOnlyMargin".

asset

string or integer

Market name (e.g. "BTC") or native asset index. Resolved to a numeric asset index in the response.

isCross

boolean

Whether to use cross margin (true) or isolated margin (false). Required for updateLeverage.

leverage

number or string

Leverage value to set. Required for updateLeverage.

isBuy

boolean

Position side the margin change applies to (true for long, false for short). Required for updateIsolatedMargin.

ntli

number

Isolated margin delta to add (positive) or remove (negative). Required for updateIsolatedMargin.

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 action object with the asset resolved to a numeric asset index

actionType

string

The action type as submitted (e.g. "updateLeverage", "updateIsolatedMargin", "topUpIsolatedOnlyMargin")

nextStep

string

Instructions for next step: sign the hash with private key (ECDSA), then POST /exchange with action, nonce, and signature (r, s, v)

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": "BTC",
7
    "isCross": true,
8
    "leverage": 10
9
  }
10
}'
11

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": "BTC",
7
    "isCross": true,
8
    "leverage": 10
9
  }
10
}'
11

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

3
const data = {
4
  action: {
5
    type: "updateLeverage",
6
    asset: "BTC",
7
    isCross: true,
8
    leverage: 10
9
  }
10
};
11

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

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

3
const data = {
4
  action: {
5
    type: "updateLeverage",
6
    asset: "BTC",
7
    isCross: true,
8
    leverage: 10
9
  }
10
};
11

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

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": "updateLeverage",
9
    "asset": "BTC",
10
    "isCross": True,
11
    "leverage": 10
12
  }
13
})
14

15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)
22

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": "updateLeverage",
9
    "asset": "BTC",
10
    "isCross": True,
11
    "leverage": 10
12
  }
13
})
14

15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

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

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": "updateLeverage",
15
    "asset": "BTC",
16
    "isCross": true,
17
    "leverage": 10
18
  }
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

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": "updateLeverage",
15
    "asset": "BTC",
16
    "isCross": true,
17
    "leverage": 10
18
  }
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free