Access to /hypercore JSON-RPC methods requires a Build plan or higher. View pricing to upgrade. For complete stream type definitions and filtering options, see the datasets documentation.

The height field is missing on older replica_cmds blocks

The top-level height field was added to Hyperliquid's raw replica_cmds data on 2026-07-25, starting at block 1085381001. Blocks produced before that change are still returned in full, with abci_block and resps, but the response object has no height key, so the payload itself does not tell you which block you received. Track the block number from your own request when you query that range. This applies only to the replica_cmds stream. Every other stream returns block_number on every block.

Parameters

stream

string

REQUIRED

The stream type to query (trades, orders, events, book, twap, writer_actions, replica_cmds). The replica_cmds stream returns the raw HyperCore block, which has a different response shape than the other streams.

block

integer

REQUIRED

The specific block number to retrieve

Returns

The shape of result depends on the stream you request. The trades, orders, book, twap, events, and writer_actions streams all return the same processed block object. The replica_cmds stream returns the raw HyperCore block instead, which is documented in the blocks dataset.

result

object

The requested block object

Returned for the trades, orders, book, twap, events, and writer_actions streams.

block_number

integer

Block number on the Hyperliquid chain

block_time

string

Block timestamp in ISO 8601 format

local_time

string

Local server timestamp in ISO 8601 format

events

array

List of events in this block; each event is a 2-item tuple of [address, payload]

address

string

Event address as a 0x-prefixed hex string

payload

object

Event payload data

builder

string

Builder address as a 0x-prefixed hex string (only present for some events)

builderFee

string

Builder fee amount as a stringified number (only present for some events)

cloid

string

Client order identifier (only present for some events)

closedPnl

string

Realized PnL from this event as a stringified number

coin

string

Instrument symbol (e.g., BTC, xyz:XYZ100, xyz:HOOD)

crossed

boolean

Whether the order crossed the book

dir

string

Action direction describing the position change (e.g., Open Long, Open Short, Close Long, Close Short, Short > Long, Long > Short)

fee

string

Fee amount as a stringified number (can be negative depending on rebates)

feeToken

string

Token symbol used for fees (e.g., USDC)

hash

string

Transaction hash as a 0x-prefixed hex string

oid

integer

Order identifier

px

string

Execution price as a stringified number

side

string

Trade side indicator (e.g., B or A)

startPosition

string

Position size before the event as a stringified number

sz

string

Execution size/quantity as a stringified number

tid

integer

Trade identifier

time

integer

Event timestamp in milliseconds since Unix epoch

twapId

integer

TWAP identifier if the event is associated with a TWAP; null if not associated with a TWAP

Returned for the replica_cmds stream, which carries the raw HyperCore block. See the blocks dataset for the full field reference and the complete list of action types.

height

integer

Top-level block number (use this as the block identifier). This field is absent on blocks before 1085381001; see the caution note on this page.

abci_block

object

Block metadata for the HyperCore block

time

string

Block timestamp (ISO 8601)

round

integer

ABCI round value (not the block number)

parent_round

integer

Parent ABCI round value

proposer

string

Validator address who proposed this block, as a 0x-prefixed hex string

hardfork

object

Hardfork metadata containing version and round

version

integer

Hardfork version

round

integer

Hardfork round value

signed_action_bundles

array

List of signed action bundles in this block; each bundle is a 2-item tuple of [bundle_hash, bundle]

bundle_hash

string

Bundle hash as a 0x-prefixed hex string

bundle

object

Bundle contents

signed_actions

array

List of signed actions in this bundle

signature

object

ECDSA signature with r, s, v components

r

string

Signature r component as a 0x-prefixed hex string

s

string

Signature s component as a 0x-prefixed hex string

v

integer

Signature v component

action

object

The actual operation being performed. The type field identifies the action; see the blocks dataset for the full list of action types.

type

string

Action type identifier (e.g., order, cancel, cancelByCloid, batchModify, scheduleCancel, updateLeverage)

nonce

integer

Transaction nonce for replay protection

vaultAddress

string

Vault address as a 0x-prefixed hex string. Present only when the action is performed by a vault; the key is omitted otherwise.

expiresAfter

integer

Expiry timestamp for the transaction. The key is omitted when no expiry is set.

isFrontend

boolean

Indicates the transaction originated from the Hyperliquid frontend. The key is omitted when not set.

broadcaster

string

Address that broadcasted the transaction bundle

broadcaster_nonce

integer

Broadcaster's nonce for the bundle

resps

object

Responses showing the success or failure of each action in the block

Full

array

List of responses; each entry is a 2-item tuple of [tx_hash, results]

tx_hash

string

Transaction hash as a 0x-prefixed hex string

results

array

Results produced by the transaction

user

string

Address the result applies to, as a 0x-prefixed hex string

res

object

Result of the action

status

string

Action status: ok when the action executed successfully, err when it failed

response

object|string

Response payload for the action. An object when status is ok, and a plain string carrying the error message when status is err.

Request

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "jsonrpc": "2.0",
6
    "method": "hl_getBlock",
7
    "params": ["trades", 817824084],
8
    "id": 1
9
  }'

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "jsonrpc": "2.0",
6
    "method": "hl_getBlock",
7
    "params": ["trades", 817824084],
8
    "id": 1
9
  }'

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

4
var raw = JSON.stringify({
5
  "jsonrpc": "2.0",
6
  "method": "hl_getBlock",
7
  "params": ["trades", 817824084],
8
  "id": 1
9
});
10

11
var requestOptions = {
12
  method: 'POST',
13
  headers: myHeaders,
14
  body: raw,
15
  redirect: 'follow'
16
};
17

18
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
19
  .then(response => response.text())
20
  .then(result => console.log(result))
21
  .catch(error => console.log('error', error));

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

4
var raw = JSON.stringify({
5
  "jsonrpc": "2.0",
6
  "method": "hl_getBlock",
7
  "params": ["trades", 817824084],
8
  "id": 1
9
});
10

11
var requestOptions = {
12
  method: 'POST',
13
  headers: myHeaders,
14
  body: raw,
15
  redirect: 'follow'
16
};
17

18
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
19
  .then(response => response.text())
20
  .then(result => console.log(result))
21
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "hl_getBlock",
9
  "params": ["trades", 817824084],
10
  "id": 1
11
})
12

13
headers = {
14
  'Content-Type': 'application/json'
15
}
16

17
response = requests.request("POST", url, headers=headers, data=payload)
18

19
print(response.text)

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "hl_getBlock",
9
  "params": ["trades", 817824084],
10
  "id": 1
11
})
12

13
headers = {
14
  'Content-Type': 'application/json'
15
}
16

17
response = requests.request("POST", url, headers=headers, data=payload)
18

19
print(response.text)

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

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
6

7
http = Net::HTTP.new(url.host, url.port)
8
http.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "method": "hl_getBlock",
15
  "params": ["trades", 817824084],
16
  "id": 1
17
})
18

19
response = http.request(request)
20
puts response.read_body

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

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
6

7
http = Net::HTTP.new(url.host, url.port)
8
http.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "method": "hl_getBlock",
15
  "params": ["trades", 817824084],
16
  "id": 1
17
})
18

19
response = http.request(request)
20
puts response.read_body

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free