Send Order 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...

orders

array

Loading...

a

integer

Loading...

b

boolean

Loading...

p

string

Loading...

s

string

Loading...

r

boolean

Loading...

t

object

Loading...

limit

object

Loading...

tif

string

Loading...

grouping

string or object

Loading...

nonce

integer

REQUIRED

Loading...

signature

object

REQUIRED

Loading...

r

string

Loading...

s

string

Loading...

v

integer

Loading...

vaultAddress

string

Loading...

expiresAfter

integer

Loading...

slippage

number

Loading...

priorityFee

integer or string

Loading...

Returns

success

boolean

Loading...

user

string

Loading...

exchangeResponse

object

Loading...

orders

array

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": "order",
6
    "orders": [{
7
      "a": 0,
8
      "b": true,
9
      "p": "100000",
10
      "s": "0.001",
11
      "r": false,
12
      "t": {"limit": {"tif": "Ioc"}}
13
    }],
14
    "grouping": "na"
15
  },
16
  "nonce": 1234567890,
17
  "signature": {
18
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
19
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
20
    "v": 28
21
  }
22
}'
23

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": "order",
6
    "orders": [{
7
      "a": 0,
8
      "b": true,
9
      "p": "100000",
10
      "s": "0.001",
11
      "r": false,
12
      "t": {"limit": {"tif": "Ioc"}}
13
    }],
14
    "grouping": "na"
15
  },
16
  "nonce": 1234567890,
17
  "signature": {
18
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
19
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
20
    "v": 28
21
  }
22
}'
23

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

3
const data = {
4
  action: {
5
    type: "order",
6
    orders: [{
7
      a: 0,
8
      b: true,
9
      p: "100000",
10
      s: "0.001",
11
      r: false,
12
      t: { limit: { tif: "Ioc" } }
13
    }],
14
    grouping: "na"
15
  },
16
  nonce: 1234567890,
17
  signature: {
18
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
19
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
20
    v: 28
21
  }
22
};
23

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

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

3
const data = {
4
  action: {
5
    type: "order",
6
    orders: [{
7
      a: 0,
8
      b: true,
9
      p: "100000",
10
      s: "0.001",
11
      r: false,
12
      t: { limit: { tif: "Ioc" } }
13
    }],
14
    grouping: "na"
15
  },
16
  nonce: 1234567890,
17
  signature: {
18
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
19
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
20
    v: 28
21
  }
22
};
23

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

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": "order",
9
    "orders": [{
10
      "a": 0,
11
      "b": True,
12
      "p": "100000",
13
      "s": "0.001",
14
      "r": False,
15
      "t": {"limit": {"tif": "Ioc"}}
16
    }],
17
    "grouping": "na"
18
  },
19
  "nonce": 1234567890,
20
  "signature": {
21
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
22
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
23
    "v": 28
24
  }
25
})
26

27
headers = {
28
  'Content-Type': 'application/json'
29
}
30

31
response = requests.request("POST", url, headers=headers, data=payload)
32

33
print(response.text)
34

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": "order",
9
    "orders": [{
10
      "a": 0,
11
      "b": True,
12
      "p": "100000",
13
      "s": "0.001",
14
      "r": False,
15
      "t": {"limit": {"tif": "Ioc"}}
16
    }],
17
    "grouping": "na"
18
  },
19
  "nonce": 1234567890,
20
  "signature": {
21
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
22
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
23
    "v": 28
24
  }
25
})
26

27
headers = {
28
  'Content-Type': 'application/json'
29
}
30

31
response = requests.request("POST", url, headers=headers, data=payload)
32

33
print(response.text)
34

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": "order",
15
    "orders": [{
16
      "a": 0,
17
      "b": true,
18
      "p": "100000",
19
      "s": "0.001",
20
      "r": false,
21
      "t": {"limit": {"tif": "Ioc"}}
22
    }],
23
    "grouping": "na"
24
  },
25
  "nonce": 1234567890,
26
  "signature": {
27
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
28
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
29
    "v": 28
30
  }
31
})
32

33
response = https.request(request)
34
puts response.read_body
35

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": "order",
15
    "orders": [{
16
      "a": 0,
17
      "b": true,
18
      "p": "100000",
19
      "s": "0.001",
20
      "r": false,
21
      "t": {"limit": {"tif": "Ioc"}}
22
    }],
23
    "grouping": "na"
24
  },
25
  "nonce": 1234567890,
26
  "signature": {
27
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
28
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
29
    "v": 28
30
  }
31
})
32

33
response = https.request(request)
34
puts response.read_body
35

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free