Chainstack Hyperliquid Node API
Chainstack-managed Hyperliquid HyperCore and HyperEVM nodes. 185 documented HTTP methods covering perpetual DEX state, orders, fills, and EVM RPC.
OpenAPI Specification
openapi: 3.0.3
info:
title: Chainstack Hyperliquid Node API
version: 1.0.0
description: Chainstack-managed RPC node API for the Hyperliquid blockchain. Endpoints follow the canonical JSON-RPC over
HTTPS interface for the network. Authenticate against your Chainstack node's per-node URL (e.g. https://nd-XXX-XXX-XXX.p2pify.com/<key>).
Merged from the Chainstack Developer Portal per-method fragments at https://github.com/chainstack/dev-portal/tree/main/openapi/hyperliquid_node_api.
contact:
name: Chainstack API Support
email: [email protected]
license:
name: Chainstack Terms
url: https://chainstack.com/terms-of-service/
servers:
- url: https://{node_id}.p2pify.com/{api_key}
description: Chainstack-managed node endpoint
variables:
node_id:
default: nd-000-000-000
description: Your Chainstack node identifier
api_key:
default: <api-key>
description: Per-node access key
tags:
- name: General
paths:
/evm_debug_get_raw_block:
post:
summary: debug_getRawBlock
description: Returns the complete raw block data for a specific block. This method provides the entire block in its
raw encoded format, including header and all transactions.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- debug_getRawBlock
default: debug_getRawBlock
description: The RPC method name
params:
type: array
description: 'Parameters: [block identifier (block number, hash, or ''latest''/''earliest''/''pending'')]'
default:
- latest
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: debug_getRawBlock
params:
- latest
id: 1
responses:
'200':
description: Successful response with raw block data
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: string
description: Complete raw block data in hexadecimal format
example:
jsonrpc: '2.0'
id: 1
result: 0xf90211a0...
tags:
- General
operationId: evm_debug_get_raw_block
/evm_debug_get_raw_header:
post:
summary: debug_getRawHeader
description: Returns the raw header data for a specific block. This method provides the complete block header in its
raw encoded format, useful for low-level blockchain analysis and debugging.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- debug_getRawHeader
default: debug_getRawHeader
description: The RPC method name
params:
type: array
description: 'Parameters: [block identifier (block number, hash, or ''latest''/''earliest''/''pending'')]'
default:
- latest
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: debug_getRawHeader
params:
- latest
id: 1
responses:
'200':
description: Successful response with raw header data
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: string
description: Raw header data in hexadecimal format
example:
jsonrpc: '2.0'
id: 1
result: 0xf90211a0...
tags:
- General
operationId: evm_debug_get_raw_header
/evm_debug_get_raw_receipts:
post:
summary: debug_getRawReceipts
description: Returns the raw receipt data for all transactions in a specific block. This method provides complete receipt
information in raw encoded format for all transactions in a block.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- debug_getRawReceipts
default: debug_getRawReceipts
description: The RPC method name
params:
type: array
description: 'Parameters: [block identifier (block number, hash, or ''latest''/''earliest''/''pending'')]'
default:
- latest
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: debug_getRawReceipts
params:
- latest
id: 1
responses:
'200':
description: Successful response with raw receipts data
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: array
description: Array of raw receipt data for all transactions in the block
example:
jsonrpc: '2.0'
id: 1
result:
- 0xf90111a0...
- 0xf90112a1...
tags:
- General
operationId: evm_debug_get_raw_receipts
/evm_debug_get_raw_transaction:
post:
summary: debug_getRawTransaction
description: Returns the raw transaction data for a specific transaction. This method provides the complete transaction
in its raw encoded format, useful for low-level analysis and debugging.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- debug_getRawTransaction
default: debug_getRawTransaction
description: The RPC method name
params:
type: array
description: 'Parameters: [transaction hash]'
default:
- '0x07712544ce8f50091c6c3b227921f763b342bf9465a22f0226d651a3246adb31'
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: debug_getRawTransaction
params:
- '0x07712544ce8f50091c6c3b227921f763b342bf9465a22f0226d651a3246adb31'
id: 1
responses:
'200':
description: Successful response with raw transaction data
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: string
description: Raw transaction data in hexadecimal format
example:
jsonrpc: '2.0'
id: 1
result: 0xf86d80843b9aca0082520894...
tags:
- General
operationId: evm_debug_get_raw_transaction
/evm_debug_trace_block:
post:
summary: debug_traceBlockByHash
description: Returns detailed trace information for all transactions in a specific block. This method provides comprehensive
debugging information for an entire block, including call traces, gas usage, and execution details for each transaction.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- debug_traceBlockByHash
default: debug_traceBlockByHash
description: The RPC method name
params:
type: array
description: 'Parameters: [blockHash, tracerConfig]'
default:
- '0x2ce91ae0ed242b4b78b432a45b982fb81a414d6b04167762ed3c7446710a4b8e'
- tracer: callTracer
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: debug_traceBlockByHash
params:
- '0x2ce91ae0ed242b4b78b432a45b982fb81a414d6b04167762ed3c7446710a4b8e'
- tracer: callTracer
id: 1
responses:
'200':
description: Successful response with block trace data
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: array
description: Array of trace data for each transaction in the block
example:
jsonrpc: '2.0'
id: 1
result:
- type: CALL
from: 0x...
to: 0x...
value: '0x0'
gas: 0x...
gasUsed: 0x...
input: 0x...
output: 0x...
tags:
- General
operationId: evm_debug_trace_block
/evm_debug_trace_block_by_number:
post:
summary: debug_traceBlockByNumber
description: Returns detailed trace information for all transactions in a specific block identified by block number.
This method provides comprehensive debugging information for an entire block, including call traces, gas usage, and
execution details for each transaction.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- debug_traceBlockByNumber
default: debug_traceBlockByNumber
description: The RPC method name
params:
type: array
description: Method parameters
default:
- '0x1'
- tracer: callTracer
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: debug_traceBlockByNumber
params:
- '0x1'
- tracer: callTracer
id: 1
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
id:
type: integer
result:
type: array
description: Trace results
tags:
- General
operationId: evm_debug_trace_block_by_number
/evm_debug_trace_call:
post:
summary: debug_traceCall
description: Executes a call and returns detailed trace information without creating a transaction. This method simulates
transaction execution and provides debugging information including call traces and state changes.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- debug_traceCall
default: debug_traceCall
description: The RPC method name
params:
type: array
description: 'Parameters: [callObject, block, tracerConfig]'
default:
- from: '0x69835D480110e4919B7899f465aAB101e21c8A87'
to: '0xB7C609cFfa0e47DB2467ea03fF3e598bf59361A5'
gas: '0x76c0'
gasPrice: '0x9184e72a000'
value: '0xde0b6b3a7640000'
data: 0x
- latest
- tracer: callTracer
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: debug_traceCall
params:
- from: '0x69835D480110e4919B7899f465aAB101e21c8A87'
to: '0xB7C609cFfa0e47DB2467ea03fF3e598bf59361A5'
gas: '0x76c0'
gasPrice: '0x9184e72a000'
value: '0xde0b6b3a7640000'
data: 0x
- latest
- tracer: callTracer
id: 1
responses:
'200':
description: Successful response with call trace data
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: object
description: Call trace data containing execution information, gas usage, and state changes
example:
jsonrpc: '2.0'
id: 1
result:
type: CALL
from: '0x69835D480110e4919B7899f465aAB101e21c8A87'
to: '0xB7C609cFfa0e47DB2467ea03fF3e598bf59361A5'
value: '0xde0b6b3a7640000'
gas: '0x76c0'
gasUsed: '0x5208'
input: 0x
output: 0x
tags:
- General
operationId: evm_debug_trace_call
/evm_debug_trace_transaction:
post:
summary: debug_traceTransaction
description: Returns detailed trace information for a specific transaction. This method provides comprehensive debugging
information including call traces, state changes, and execution details.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- debug_traceTransaction
default: debug_traceTransaction
description: The RPC method name
params:
type: array
description: 'Parameters: [transactionHash, tracerConfig]'
default:
- '0x07712544ce8f50091c6c3b227921f763b342bf9465a22f0226d651a3246adb31'
- tracer: callTracer
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: debug_traceTransaction
params:
- '0x07712544ce8f50091c6c3b227921f763b342bf9465a22f0226d651a3246adb31'
- tracer: callTracer
id: 1
responses:
'200':
description: Successful response with transaction trace data
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: object
description: Transaction trace data containing call information, gas usage, and state changes
example:
jsonrpc: '2.0'
id: 1
result:
type: CALL
from: 0x...
to: 0x...
value: '0x0'
gas: 0x...
gasUsed: 0x...
input: 0x...
output: 0x...
tags:
- General
operationId: evm_debug_trace_transaction
/evm_erigon_get_header_by_number:
post:
summary: erigon_getHeaderByNumber
description: Get block header by number using Erigon-specific method on Hyperliquid EVM. Returns detailed header information.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- erigon_getHeaderByNumber
default: erigon_getHeaderByNumber
description: The RPC method name
params:
type: array
description: 'Parameters: [block number]'
default:
- 1000
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: erigon_getHeaderByNumber
params:
- 1000
id: 1
responses:
'200':
description: Successful response with block header
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: object
description: Block header object
example:
jsonrpc: '2.0'
id: 1
result:
number: '0x3e8'
hash: '0xe8399bf41516f5ca663c79bc30db02b4989385c2f3a96f42958dea5753cbf4a9'
parentHash: '0x7c8f6a0e4d3b2a1c9e5f8b7d4a6c3e9f2b8d5a7c1e4f9b3a6d8c2e5f7a9b4c6d'
timestamp: '0x6734e8d0'
tags:
- General
operationId: evm_erigon_get_header_by_number
/evm_eth_big_block_gas_price:
post:
summary: eth_bigBlockGasPrice
description: Returns the gas price for large blocks on Hyperliquid EVM.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- eth_bigBlockGasPrice
default: eth_bigBlockGasPrice
description: The RPC method name
params:
type: array
description: No parameters required
default: []
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: eth_bigBlockGasPrice
params: []
id: 1
responses:
'200':
description: Successful response with the big block gas price
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: string
description: The big block gas price in wei as a hexadecimal string
example:
jsonrpc: '2.0'
id: 1
result: '0x3b9aca00'
tags:
- General
operationId: evm_eth_big_block_gas_price
/evm_eth_blob_base_fee:
post:
summary: eth_blobBaseFee
description: Returns the current base fee for blob transactions. This method provides the current pricing information
needed for EIP-4844 blob transactions, essential for cost estimation and blob data submission.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- eth_blobBaseFee
default: eth_blobBaseFee
description: The RPC method name
params:
type: array
default: []
description: Parameters for the method (empty array for eth_blobBaseFee)
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: eth_blobBaseFee
params: []
id: 1
responses:
'200':
description: Successful response with the current blob base fee
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: string
description: The current blob base fee as a hexadecimal string (in wei)
example:
jsonrpc: '2.0'
id: 1
result: '0x1'
tags:
- General
operationId: evm_eth_blob_base_fee
/evm_eth_block_number:
post:
summary: eth_blockNumber
description: Returns the number of the most recent block. This method provides the current block height of the Hyperliquid
EVM blockchain, which is essential for tracking blockchain state and synchronization.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- eth_blockNumber
default: eth_blockNumber
description: The RPC method name
params:
type: array
default: []
description: Parameters for the method (empty array for eth_blockNumber)
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: eth_blockNumber
params: []
id: 1
responses:
'200':
description: Successful response with the current block number
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: string
description: The current block number as a hexadecimal string
example:
jsonrpc: '2.0'
id: 1
result: '0x1b4'
tags:
- General
operationId: evm_eth_block_number
/evm_eth_call:
post:
summary: Eth_Call
description: Executes a new message call immediately without creating a transaction on the blockchain. This method is
used to call smart contract functions and retrieve data without modifying the blockchain state.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- eth_call
default: eth_call
description: The RPC method name
params:
type: array
description: 'Parameters: [transaction object, block parameter]'
default:
- to: '0x5555555555555555555555555555555555555555'
data: '0x18160ddd'
- latest
id:
type: integer
default: 1
description: Request identifier
example:
jsonrpc: '2.0'
method: eth_call
params:
- to: '0x5555555555555555555555555555555555555555'
data: '0x18160ddd'
- latest
id: 1
responses:
'200':
description: Successful response with the call result
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC version
id:
type: integer
description: Request identifier
result:
type: string
description: The return value of the executed contract method as a hexadecimal string
example:
jsonrpc: '2.0'
id: 1
result: '0x0000000000000000000000000000000000000000000000000de0b6b3a7640000'
tags:
- General
operationId: evm_eth_call
/evm_eth_call_many:
post:
summary: eth_callMany
description: Executes multiple call transactions in sequence without creating transactions on the blockchain.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
- params
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version
method:
type: string
enum:
- eth_callMany
default: eth_callMany
description: The RPC method name
params:
# --- truncated at 32 KB (563 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/chainstack/refs/heads/main/openapi/chainstack-hyperliquid-node-api-openapi.yml