candleSnapshot Info Endpoint Method

candleSnapshot is not currently available through Quicknode's /info endpoint. This method is not part of the open-source Hyperliquid node.

Alternatives by granularity:

• Hourly candles: Query the hyperliquid_market_volume_hourly table in SQL Explorer for pre-aggregated OHLCV data, joinable with liquidation, funding, and user data
• Daily candles: Query hyperliquid_metrics_dex_overview in SQL Explorer for daily high, low, and volume per coin, or aggregate from hyperliquid_market_volume_hourly
• Sub-hourly or 4h candles: Compute from hyperliquid_fills in SQL Explorer using toStartOfInterval(time, INTERVAL X MINUTE), or query through Hyperliquid's public API (subject to Hyperliquid rate limits)

Parameters

type

string

REQUIRED

Loading...

req

object

REQUIRED

Loading...

coin

string

REQUIRED

Loading...

interval

string

REQUIRED

Loading...

startTime

integer

REQUIRED

Loading...

endTime

integer

REQUIRED

Loading...

Returns

array

array

Loading...

t

integer

Loading...

T

integer

Loading...

s

string

Loading...

i

string

Loading...

o

string

Loading...

c

string

Loading...

h

string

Loading...

l

string

Loading...

v

string

Loading...

n

integer

Loading...

Request

1
curl https://api.hyperliquid.xyz/info \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"type":"candleSnapshot","req":{"coin":"BTC","interval":"1h","startTime":1754300000000,"endTime":1754400000000}}'
5

1
curl https://api.hyperliquid.xyz/info \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"type":"candleSnapshot","req":{"coin":"BTC","interval":"1h","startTime":1754300000000,"endTime":1754400000000}}'
5

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "type": "candleSnapshot",
6
  "req": {
7
    "coin": "BTC",
8
    "interval": "1h",
9
    "startTime": 1754300000000,
10
    "endTime": 1754400000000
11
  }
12
});
13

14
var requestOptions = {
15
  method: 'POST',
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: 'follow'
19
};
20

21
fetch("https://api.hyperliquid.xyz/info", requestOptions)
22
  .then(response => response.text())
23
  .then(result => console.log(result))
24
  .catch(error => console.log('error', error));
25

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "type": "candleSnapshot",
6
  "req": {
7
    "coin": "BTC",
8
    "interval": "1h",
9
    "startTime": 1754300000000,
10
    "endTime": 1754400000000
11
  }
12
});
13

14
var requestOptions = {
15
  method: 'POST',
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: 'follow'
19
};
20

21
fetch("https://api.hyperliquid.xyz/info", requestOptions)
22
  .then(response => response.text())
23
  .then(result => console.log(result))
24
  .catch(error => console.log('error', error));
25

1
import requests
2
import json
3

4
url = "https://api.hyperliquid.xyz/info"
5

6
payload = json.dumps({
7
  "type": "candleSnapshot",
8
  "req": {
9
    "coin": "BTC",
10
    "interval": "1h",
11
    "startTime": 1754300000000,
12
    "endTime": 1754400000000
13
  }
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)
22

1
import requests
2
import json
3

4
url = "https://api.hyperliquid.xyz/info"
5

6
payload = json.dumps({
7
  "type": "candleSnapshot",
8
  "req": {
9
    "coin": "BTC",
10
    "interval": "1h",
11
    "startTime": 1754300000000,
12
    "endTime": 1754400000000
13
  }
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)
22

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

5
url = URI("https://api.hyperliquid.xyz/info")
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
  "type": "candleSnapshot",
14
  "req": {
15
    "coin": "BTC",
16
    "interval": "1h",
17
    "startTime": 1754300000000,
18
    "endTime": 1754400000000
19
  }
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

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

5
url = URI("https://api.hyperliquid.xyz/info")
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
  "type": "candleSnapshot",
14
  "req": {
15
    "coin": "BTC",
16
    "interval": "1h",
17
    "startTime": 1754300000000,
18
    "endTime": 1754400000000
19
  }
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free