info

Exchange API calls do not consume Quicknode API credits. If you are on a free trial plan, see hyperliquidapi.com for your URL and fee schedule. To white-label with your own builder code, contact us.

Body Parameters

user

string

REQUIRED

User address (0x...)

oid

string

REQUIRED

Order ID (integer) or Client Order ID / cloid (string) to check status

Returns

status

string

Order status (e.g., "open", "filled", "canceled")

explanation

string

Plain-English explanation of order status (e.g., "Order was canceled by user.")

coin

string

Asset symbol (e.g., "ZEREBRO", "BTC")

name

string

Asset name (same as coin)

isSpot

boolean

Whether this is a spot market order

statusTimestamp

integer

Timestamp of the status update in milliseconds

oid

integer

Order ID

asset

integer

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

order

object

Detailed order information

coin

string

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

side

string

Order side ("B" for buy, "A" for ask/sell)

limitPx

string

Limit price as a stringified number

sz

string

Order size/quantity as a stringified number

oid

integer

Order ID

timestamp

integer

Order creation timestamp in milliseconds

triggerCondition

string

Trigger condition ("N/A" if not a trigger order)

isTrigger

boolean

Whether this is a trigger order

triggerPx

string

Trigger price as a stringified number ("0.0" if not a trigger order)

children

array

Array of child orders (for TP/SL orders)

isPositionTpsl

boolean

Whether this is a position-level TP/SL order

reduceOnly

boolean

Whether this is a reduce-only order

orderType

string

Order type (e.g., "Limit", "Market")

origSz

string

Original order size as a stringified number

tif

string

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

cloid

string

Client order ID as a 0x-prefixed hex string (null if not set)

Request

1
curl -s -X POST https://docs-demo.hype-mainnet.quiknode.pro/hypercore/orderStatus \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
5
  "oid": 332007234709
6
}'
7

1
curl -s -X POST https://docs-demo.hype-mainnet.quiknode.pro/hypercore/orderStatus \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
5
  "oid": 332007234709
6
}'
7

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

3
const data = {
4
  user: "0x31ca8395cf837de08b24da3f660e77761dfb974b",
5
  oid: 332007234709
6
};
7

8
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/orderStatus', data, {
9
  headers: { 'Content-Type': 'application/json' }
10
})
11
.then(response => console.log(response.data))
12
.catch(error => console.error(error));
13

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

3
const data = {
4
  user: "0x31ca8395cf837de08b24da3f660e77761dfb974b",
5
  oid: 332007234709
6
};
7

8
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/orderStatus', data, {
9
  headers: { 'Content-Type': 'application/json' }
10
})
11
.then(response => console.log(response.data))
12
.catch(error => console.error(error));
13

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/hypercore/orderStatus"
5

6
payload = json.dumps({
7
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
8
  "oid": 332007234709
9
})
10

11
headers = {
12
  'Content-Type': 'application/json'
13
}
14

15
response = requests.request("POST", url, headers=headers, data=payload)
16

17
print(response.text)
18

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/hypercore/orderStatus"
5

6
payload = json.dumps({
7
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
8
  "oid": 332007234709
9
})
10

11
headers = {
12
  'Content-Type': 'application/json'
13
}
14

15
response = requests.request("POST", url, headers=headers, data=payload)
16

17
print(response.text)
18

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/hypercore/orderStatus")
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
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
14
  "oid": 332007234709
15
})
16

17
response = https.request(request)
18
puts response.read_body
19

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/hypercore/orderStatus")
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
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
14
  "oid": 332007234709
15
})
16

17
response = https.request(request)
18
puts response.read_body
19

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free