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

Market order action object

type

string

Action type ("order")

orders

array

Array of market order objects

asset

string

Asset name (e.g., "BTC", "ETH", "HYPE")

side

string

Order side ("buy" or "sell")

size

string

Order size/quantity

tif

string

Time in force: "market" (will be converted to IOC with computed price)

slippage

number

Optional slippage tolerance as a decimal (e.g. 0.05 = 5%). Default 3%. Range 0.1% to 10%. Applied to the computed IOC limit price.

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; market orders are built as IOC limits, so they are eligible. 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 computed price (mid price + 3% slippage) and IOC tif

type

string

Action type ("order")

orders

array

Array of order objects in wire format with computed price

a

integer

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

b

boolean

Buy side (true for buy, false for sell)

p

string

Computed price with 3% slippage applied (stringified number)

s

string

Size/quantity as a stringified number

r

boolean

Reduce-only flag (false for market orders)

t

object

Order type specification (IOC limit)

limit

object

Limit order type

tif

string

Time in force ("Ioc" - Immediate or Cancel)

grouping

string

Order grouping strategy: "na" (Normal Action)

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)

nextStep

string

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

appliedSlippage

string

Slippage applied to the mid price as a percentage string (e.g., "3.0%")

appliedSlippageRaw

number

Slippage applied as a decimal fraction (e.g., 0.03 for 3%)

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).

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
        "size": "0.001",
11
        "tif": "market"
12
      }
13
    ]
14
  }
15
}'
16

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
        "size": "0.001",
11
        "tif": "market"
12
      }
13
    ]
14
  }
15
}'
16

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

3
const data = {
4
  action: {
5
    type: "order",
6
    orders: [
7
      {
8
        asset: "BTC",
9
        side: "buy",
10
        size: "0.001",
11
        tif: "market"
12
      }
13
    ]
14
  }
15
};
16

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

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

3
const data = {
4
  action: {
5
    type: "order",
6
    orders: [
7
      {
8
        asset: "BTC",
9
        side: "buy",
10
        size: "0.001",
11
        tif: "market"
12
      }
13
    ]
14
  }
15
};
16

17
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
18
  headers: { 'Content-Type': 'application/json' }
19
})
20
.then(response => console.log(response.data))
21
.catch(error => console.error(error));
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": "order",
9
    "orders": [
10
      {
11
        "asset": "BTC",
12
        "side": "buy",
13
        "size": "0.001",
14
        "tif": "market"
15
      }
16
    ]
17
  }
18
})
19

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

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

26
print(response.text)
27

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
        "size": "0.001",
14
        "tif": "market"
15
      }
16
    ]
17
  }
18
})
19

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

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

26
print(response.text)
27

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
        "size": "0.001",
20
        "tif": "market"
21
      }
22
    ]
23
  }
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

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
        "size": "0.001",
20
        "tif": "market"
21
      }
22
    ]
23
  }
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