Send User-Signed Action REST API Endpoint

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

Loading...

type

string

Loading...

hyperliquidChain

string

Loading...

signatureChainId

string

Loading...

nonce

integer

REQUIRED

Loading...

signature

object

REQUIRED

Loading...

r

string

Loading...

s

string

Loading...

v

integer

Loading...

Returns

success

boolean

Loading...

user

string

Loading...

exchangeResponse

object

Loading...

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": "usdSend",
6
    "destination": "0x0000000000000000000000000000000000000001",
7
    "amount": "1.0",
8
    "hyperliquidChain": "Mainnet",
9
    "signatureChainId": "0xa4b1",
10
    "time": 1234567890000
11
  },
12
  "nonce": 1234567890000,
13
  "signature": {
14
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
15
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
16
    "v": 28
17
  }
18
}'
19

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": "usdSend",
6
    "destination": "0x0000000000000000000000000000000000000001",
7
    "amount": "1.0",
8
    "hyperliquidChain": "Mainnet",
9
    "signatureChainId": "0xa4b1",
10
    "time": 1234567890000
11
  },
12
  "nonce": 1234567890000,
13
  "signature": {
14
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
15
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
16
    "v": 28
17
  }
18
}'
19

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

3
const data = {
4
  action: {
5
    type: "usdSend",
6
    destination: "0x0000000000000000000000000000000000000001",
7
    amount: "1.0",
8
    hyperliquidChain: "Mainnet",
9
    signatureChainId: "0xa4b1",
10
    time: 1234567890000
11
  },
12
  nonce: 1234567890000,
13
  signature: {
14
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
15
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
16
    v: 28
17
  }
18
};
19

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

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

3
const data = {
4
  action: {
5
    type: "usdSend",
6
    destination: "0x0000000000000000000000000000000000000001",
7
    amount: "1.0",
8
    hyperliquidChain: "Mainnet",
9
    signatureChainId: "0xa4b1",
10
    time: 1234567890000
11
  },
12
  nonce: 1234567890000,
13
  signature: {
14
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
15
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
16
    v: 28
17
  }
18
};
19

20
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
21
  headers: { 'Content-Type': 'application/json' }
22
})
23
.then(response => console.log(response.data))
24
.catch(error => console.error(error));
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": "usdSend",
9
    "destination": "0x0000000000000000000000000000000000000001",
10
    "amount": "1.0",
11
    "hyperliquidChain": "Mainnet",
12
    "signatureChainId": "0xa4b1",
13
    "time": 1234567890000
14
  },
15
  "nonce": 1234567890000,
16
  "signature": {
17
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
18
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
19
    "v": 28
20
  }
21
})
22

23
headers = { 'Content-Type': 'application/json' }
24
response = requests.request("POST", url, headers=headers, data=payload)
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": "usdSend",
9
    "destination": "0x0000000000000000000000000000000000000001",
10
    "amount": "1.0",
11
    "hyperliquidChain": "Mainnet",
12
    "signatureChainId": "0xa4b1",
13
    "time": 1234567890000
14
  },
15
  "nonce": 1234567890000,
16
  "signature": {
17
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
18
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
19
    "v": 28
20
  }
21
})
22

23
headers = { 'Content-Type': 'application/json' }
24
response = requests.request("POST", url, headers=headers, data=payload)
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
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": "usdSend",
13
    "destination": "0x0000000000000000000000000000000000000001",
14
    "amount": "1.0",
15
    "hyperliquidChain": "Mainnet",
16
    "signatureChainId": "0xa4b1",
17
    "time": 1234567890000
18
  },
19
  "nonce": 1234567890000,
20
  "signature": {
21
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
22
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
23
    "v": 28
24
  }
25
})
26
response = https.request(request)
27
puts response.read_body
28

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": "usdSend",
13
    "destination": "0x0000000000000000000000000000000000000001",
14
    "amount": "1.0",
15
    "hyperliquidChain": "Mainnet",
16
    "signatureChainId": "0xa4b1",
17
    "time": 1234567890000
18
  },
19
  "nonce": 1234567890000,
20
  "signature": {
21
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
22
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
23
    "v": 28
24
  }
25
})
26
response = https.request(request)
27
puts response.read_body
28

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free