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

Order action object

type

string

Action type ("order")

orders

array

Array of order objects

asset

string

Asset name (e.g., "BTC", "HYPE", "xyz:SILVER")

side

string

Order side ("buy" or "sell")

price

string

Limit price (omit for market orders)

size

string

Order size/quantity

tif

string

Time in force: "ioc", "gtc", "alo", or "market"

vaultAddress

string

Optional vault address

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.

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 in wire format with builder fee injected

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 (true for reduce-only orders)

t

object

Order type specification

limit

object

Limit order type

tif

string

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

grouping

string

Order grouping strategy: "na" (Normal Action), "normalTpsl" (Normal with TP/SL), or "positionTpsl" (Position TP/SL)

isSpot

boolean

Whether this is a spot market order

builderFee

string

Builder fee as percentage string (e.g., "0.04%")

builderFeeRaw

integer

Builder fee in basis points (e.g., 40 = 0.04%)

builder

string

Builder address (0x-prefixed hex string)

priorityFee

integer

Priority fee rate, if specified in the request. The value is interpreted as p / 100000000 of filled notional, so 10000 equals 1 basis point and the maximum is 80000 (8 basis points).

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": "order",
6
    "orders": [
7
      {
8
        "asset": "BTC",
9
        "side": "buy",
10
        "price": "100000",
11
        "size": "0.001",
12
        "tif": "ioc"
13
      }
14
    ]
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": "order",
6
    "orders": [
7
      {
8
        "asset": "BTC",
9
        "side": "buy",
10
        "price": "100000",
11
        "size": "0.001",
12
        "tif": "ioc"
13
      }
14
    ]
15
  }
16
}'
17

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

3
const data = {
4
  action: {
5
    type: "order",
6
    orders: [
7
      {
8
        asset: "BTC",
9
        side: "buy",
10
        price: "100000",
11
        size: "0.001",
12
        tif: "ioc"
13
      }
14
    ]
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: "order",
6
    orders: [
7
      {
8
        asset: "BTC",
9
        side: "buy",
10
        price: "100000",
11
        size: "0.001",
12
        tif: "ioc"
13
      }
14
    ]
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

6
payload = json.dumps({
7
  "action": {
8
    "type": "order",
9
    "orders": [
10
      {
11
        "asset": "BTC",
12
        "side": "buy",
13
        "price": "100000",
14
        "size": "0.001",
15
        "tif": "ioc"
16
      }
17
    ]
18
  }
19
})
20

21
headers = {
22
  'Content-Type': 'application/json'
23
}
24

25
response = requests.request("POST", url, headers=headers, data=payload)
26

27
print(response.text)
28

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
      {
11
        "asset": "BTC",
12
        "side": "buy",
13
        "price": "100000",
14
        "size": "0.001",
15
        "tif": "ioc"
16
      }
17
    ]
18
  }
19
})
20

21
headers = {
22
  'Content-Type': 'application/json'
23
}
24

25
response = requests.request("POST", url, headers=headers, data=payload)
26

27
print(response.text)
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

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
      {
17
        "asset": "BTC",
18
        "side": "buy",
19
        "price": "100000",
20
        "size": "0.001",
21
        "tif": "ioc"
22
      }
23
    ]
24
  }
25
})
26

27
response = https.request(request)
28
puts response.read_body
29

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
      {
17
        "asset": "BTC",
18
        "side": "buy",
19
        "price": "100000",
20
        "size": "0.001",
21
        "tif": "ioc"
22
      }
23
    ]
24
  }
25
})
26

27
response = https.request(request)
28
puts response.read_body
29

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free