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

Order action object in wire format (from build-order or build-market-order response)

type

string

Action type ("order")

orders

array

Array of order objects in wire format

a

integer

Asset index (0 for BTC, 1 for ETH, etc.)

b

boolean

Buy side (true for buy, false for sell)

p

string

Price as a stringified number

s

string

Size/quantity as a stringified number

r

boolean

Reduce-only flag

t

object

Order type specification

limit

object

Limit order type

tif

string

Time in force ("Ioc", "Gtc", "Alo")

grouping

string or object

Order grouping strategy ("na", "normalTpsl", "positionTpsl"). When a priority fee is requested, the build response returns grouping as an object of the form { "p": 12345 }. Send the action exactly as returned by the build step. HIP-4 signed actions use grouping "na".

nonce

integer

REQUIRED

Nonce from build-order response (timestamp in milliseconds)

signature

object

REQUIRED

ECDSA signature of the hash

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)

vaultAddress

string

Optional vault address

expiresAfter

integer

Optional expiration timestamp (ms)

slippage

number

Optional slippage tolerance

priorityFee

integer or string

Optional priority fee rate. The value is interpreted as p / 100000000 of filled notional, so 10000 equals 1 basis point and the maximum is 80000 (8 basis points). Applies only to IOC orders; every order in the action must be IOC or a market-style IOC order. Charged from the undelegated staking HYPE balance (use Build Priority Funding Deposit to fund it). Not supported for HIP-4 orders. When the build response already includes grouping as an object { p }, any priorityFee sent must equal action.grouping.p.

Returns

success

boolean

Whether the order was successfully submitted

user

string

User address (0x-prefixed hex string)

exchangeResponse

object

Response from Hyperliquid exchange with order details

orders

array

Optional. Summary of each submitted order, including asset information, side, price, size, status, oid, and fill details when present.

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