Home

Ethereum JSON-RPC

v1.0.0
Base URL
https://hype.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

MAINNET / EVM

eth_accounts

Ethereum method - eth_accounts

POST
https://hype.nownodes.io/evm

Returns an array of addresses controlled by the client.

Body

application/json
jsonrpcstringrequired

JSON-RPC version identifier

methodstringrequired

Name of the JSON-RPC method

paramsarrayrequired

No parameters are required for this method. This must be an empty array.

idintegerrequired

Unique identifier for the JSON-RPC request

Response

200OK

A list of Ethereum addresses

Authorization

api-keyAuthapiKey in header

eth_blockNumber

Ethereum method - eth_blockNumber

POST
https://hype.nownodes.io/evm

Returns the number of the latest block on the chain in hexadecimal format.

Body

application/json
jsonrpcstringrequired

The JSON-RPC protocol version

methodstringrequired

Name of the method being called

paramsarrayrequired

This method does not take parameters; always send an empty array.

idintegerrequired

A unique ID for the request

Response

200OK

The latest block number

Authorization

api-keyAuthapiKey in header

eth_call

Ethereum method - eth_call

POST
https://hype.nownodes.io/evm

Executes a call to a contract or address and returns the result without broadcasting a transaction.

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<object | string>required

The first object specifies the call transaction object. The second (optional) parameter specifies the block context.

Show child attributes
One of
fromstring

Address the call is sent from (optional)

tostringrequired

Target address for the call (required)

gasstring

Gas provided for the call, as hex

gasPricestring

Gas price in wei, as hex

valuestring

Amount of ETH sent, as hex (optional)

datastring

Compiled contract method call data

(Optional) Integer block number, or the string "latest", "earliest", or "pending".

string
idintegerrequired

Response

200OK

Result of the call

Authorization

api-keyAuthapiKey in header

eth_chainId

Ethereum method - eth_chainId

POST
https://hype.nownodes.io/evm

Returns the hexadecimal string of the current chain ID.

Body

application/json
jsonrpcstringrequired

JSON-RPC protocol version

methodstringrequired

Name of the method to call

paramsarrayrequired

This method does not require parameters. Use an empty array.

idintegerrequired

Unique identifier for the request

Response

200OK

Chain ID response

Authorization

api-keyAuthapiKey in header

eth_coinbase

eth_coinbase

POST
https://hype.nownodes.io/evm

Returns the Ethereum coinbase address (i.e., the address that receives mining rewards).

Body

application/json
jsonrpcstringrequired
methodstringeth_coinbaserequired
paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC Response with the coinbase address

Authorization

api-keyAuthapiKey in header

eth_estimateGas

Estimate Gas for Transaction

POST
https://hype.nownodes.io/evm

Simulates a transaction and returns an estimate of how much gas would be used.

Body

application/json
jsonrpcstringrequired

JSON-RPC protocol version

methodstringrequired

The method name

paramsArray<object | string>required

The transaction call object and an optional block tag.

Show child attributes
One of
fromstring

Address the transaction is sent from (optional)

tostringrequired

Destination address of the call

gasstring

Gas limit provided for execution (optional)

gasPricestring

Gas price in wei (optional)

valuestring

Amount of ETH to send, in hexadecimal wei (optional)

datastring

The compiled input data for the transaction (optional)

Optional block tag (e.g., "latest", "earliest", or a block number)

string
idintegerrequired

Request identifier

Response

200OK

Estimated gas amount

Authorization

api-keyAuthapiKey in header

eth_feeHistory

eth_feeHistory

POST
https://hype.nownodes.io/evm

Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string | integer | Array<number>>required

Parameters:

  1. blockCount — number of blocks in the requested range.
  2. newestBlock — highest block number in the requested range (can be "latest").
  3. rewardPercentiles — list of percentile values to sample priority fees from each block (optional).
Show child attributes
Any of
string
integer
Array<number>
idintegerrequired

Response

200OK

JSON-RPC Response with fee history data

Authorization

api-keyAuthapiKey in header

eth_gasPrice

Get Suggested Gas Price

POST
https://hype.nownodes.io/evm

Returns the current gas price in wei as a hexadecimal string. This value is a node estimate based on recent blocks and mempool activity.

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsarrayrequired

This method takes an empty array.

idintegerrequired

Request identifier

Response

200OK

Suggested gas price in wei

Authorization

api-keyAuthapiKey in header

eth_getBalance

Get ETH Balance of an Address

POST
https://hype.nownodes.io/evm

Retrieves the balance (in wei) of a given Ethereum address. You can specify the block parameter to get the balance at a specific block.

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array with 2 parameters:

  1. Address (20-byte hex string with '0x' prefix)
  2. Block tag (e.g., 'latest', 'earliest', 'pending', or block number in hex)
idintegerrequired

Request ID

Response

200OK

Balance (in wei) as hex string

Authorization

api-keyAuthapiKey in header

eth_getBlockByHash

Get Block by Hash

POST
https://hype.nownodes.io/evm

Returns the block information for the specified block hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

  1. Block hash (string)
  2. Boolean flag — if true, return full transactions; if false, only hashes.
idintegerrequired

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

eth_getBlockByNumber

Get Block by Number

POST
https://hype.nownodes.io/evm

Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

  1. Block number (hex string, e.g., "0x1b4") or special tags ("latest", "earliest", "pending")
  2. Boolean flag — if true, return full transactions; if false, only hashes.
idintegerrequired

Request ID

Response

200OK

Block information

Authorization

api-keyAuthapiKey in header

eth_getBlockReceipts

Get All Transaction Receipts for a Block

POST
https://hype.nownodes.io/evm

Returns an array of transaction receipts for every transaction in the block specified by block number or block hash.

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

One parameter:

  • Block identifier, which can be either:
    • block number as hex string (e.g. "0x10d4f")
    • or block hash as hex string (0x-prefixed)
idintegerrequired

Request identifier

Response

200OK

Array of transaction receipts in the block

Authorization

api-keyAuthapiKey in header

eth_getBlockTransactionCountByHash

Get Transaction Count by Block Hash

POST
https://hype.nownodes.io/evm

Returns the number of transactions contained in the block with the given hash.

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array containing a single parameter:

  • Block hash as a hex string (32 bytes with 0x prefix)
idintegerrequired

Request ID

Response

200OK

Number of transactions in the block

Authorization

api-keyAuthapiKey in header

eth_getBlockTransactionCountByNumber

Get Transaction Count by Block Number

POST
https://hype.nownodes.io/evm

Returns the number of transactions contained in the block with the given block number.

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array containing a single parameter:

  • Block number as a hex string (e.g. "0x10d4f" for block 69007) or
  • predefined block tags such as "latest", "earliest", or "pending"
idintegerrequired

Request ID

Response

200OK

Number of transactions in the block

Authorization

api-keyAuthapiKey in header

eth_getCode

Get Contract Bytecode at Address

POST
https://hype.nownodes.io/evm

Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".

Body

application/json
jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with two elements:

  1. The address to get the code for (hex string, 0x-prefixed).
  2. The block number or block tag (e.g., "latest", "earliest", "pending").
idintegerrequired

Request identifier.

Response

200OK

Contract bytecode in hex format

Authorization

api-keyAuthapiKey in header

eth_getFilterChanges

Get Filter Changes

POST
https://hype.nownodes.io/evm

Returns an array of logs that occurred since the last poll for the specified filter ID. The filter must have been previously created with eth_newFilter or eth_newBlockFilter or eth_newPendingTransactionFilter.

Body

application/json
jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with a single element:

  1. The filter ID (hex string).
idintegerrequired

Request identifier.

Response

200OK

Array of log objects or transaction hashes depending on filter type

Authorization

api-keyAuthapiKey in header

eth_getFilterLogs

Get Filter Logs

POST
https://hype.nownodes.io/evm

Returns all logs matching a filter with the specified filter ID. The filter must have been previously created with eth_newFilter.

Body

application/json
jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with one element:

  1. The filter ID (hex string).
idintegerrequired

Request identifier.

Response

200OK

Array of log objects matching the filter

Authorization

api-keyAuthapiKey in header

eth_getLogs

Get Logs

POST
https://hype.nownodes.io/evm

Returns an array of logs that match the filter criteria specified in the params. The filter object supports filtering by block range, addresses, and topics.

Body

application/json
jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Parameters array with one element: the filter object.

Show child attributes
fromBlockstring

Starting block number (hex string) or "earliest", "latest", "pending".

toBlockstring

Ending block number (hex string) or "earliest", "latest", "pending".

addressstring | Array<string>

Contract address or list of addresses from which logs should originate.

topicsarray

Array of topic filters. Each topic can be a string, null, or an array of strings for OR filtering.

idintegerrequired

Request identifier.

Response

200OK

Array of log objects matching the filter

Authorization

api-keyAuthapiKey in header

eth_getStorageAt

Get Storage At

POST
https://hype.nownodes.io/evm

Returns the value stored at position in the storage of the contract at address at the given blockNumber.

Body

application/json
jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array:

  1. address: string - Contract address to query storage from.
  2. position: string - Storage slot position (hex string).
  3. block number: string - Block number or keywords ("latest", "earliest", "pending").
idintegerrequired

Request identifier.

Response

200OK

Storage slot value at the specified position

Authorization

api-keyAuthapiKey in header

eth_getTransactionByBlockHashAndIndex

Get Transaction by Block Hash and Index

POST
https://hype.nownodes.io/evm

Retrieves the transaction from a block using the block's hash and the transaction's index position within the block.

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required

Parameters:

  1. blockHash (string): The 32-byte hash of the block.
  2. transactionIndex (string): The transaction index (hex).
idintegerrequired

Response

200OK

A transaction object or null if no transaction was found.

Authorization

api-keyAuthapiKey in header

eth_getTransactionByBlockNumberAndIndex

Get Transaction by Block Number and Index

POST
https://hype.nownodes.io/evm

Returns the information about a transaction using the block number and the transaction index within the block.

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required

Parameters:

  1. Block number in hex format (e.g., "0x5daf3b")
  2. Transaction index in the block (e.g., "0x0")
idintegerrequired

Response

200OK

A transaction object, or null if not found.

Authorization

api-keyAuthapiKey in header

eth_getTransactionByHash

Get transaction by hash

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required

Array containing a single transaction hash

idintegerrequired

Response

200OK

Transaction object or null

Authorization

api-keyAuthapiKey in header

eth_getTransactionCount

Get transaction count (nonce) for address

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required
  • address: The address to check for transaction count.
  • block: The block parameter (e.g., "latest", "earliest", "pending").
idintegerrequired

Response

200OK

Hex encoded nonce (transaction count)

Authorization

api-keyAuthapiKey in header

eth_getTransactionReceipt

Get transaction receipt by hash

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required
idintegerrequired

Response

200OK

Transaction receipt if mined, otherwise null

Authorization

api-keyAuthapiKey in header

eth_getUncleByBlockHashAndIndex

Get uncle block by block hash and index

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required
  • blockHash: 32-byte block hash
  • index: the uncle index as hex (e.g., "0x0" for the first uncle)
idintegerrequired

Response

200OK

Uncle block object or null

Authorization

api-keyAuthapiKey in header

eth_getUncleByBlockNumberAndIndex

Get uncle block by block number and index

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required
  • blockNumber: The block number as hex string (e.g., "0x10fb78"), or "latest", "earliest", "pending".
  • index: The uncle index as hex (e.g., "0x0" for the first uncle).
idintegerrequired

Response

200OK

Uncle block object or null

Authorization

api-keyAuthapiKey in header

eth_getUncleCountByBlockHash

Get the number of uncle blocks by block hash

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required

An array containing the block hash.

idintegerrequired

Response

200OK

Number of uncles in the block

Authorization

api-keyAuthapiKey in header

eth_getUncleCountByBlockNumber

Get the number of uncle blocks by block number

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required

An array containing the block number as a hex string.

idintegerrequired

Response

200OK

Number of uncle blocks in the block

Authorization

api-keyAuthapiKey in header

eth_hashrate

eth_hashrate

POST
https://hype.nownodes.io/evm

Returns the current mining hashrate reported by the client.

Body

application/json
jsonrpcstringrequired
methodstringeth_hashraterequired
paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the current mining hashrate

Authorization

api-keyAuthapiKey in header

eth_maxPriorityFeePerGas

Get recommended maxPriorityFeePerGas value

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsarrayrequired

No parameters are required.

idintegerrequired

Response

200OK

Returns the suggested maxPriorityFeePerGas value

Authorization

api-keyAuthapiKey in header

eth_mining

eth_mining

POST
https://hype.nownodes.io/evm

Checks whether the Ethereum client is actively mining.

Body

application/json
jsonrpcstringrequired
methodstringeth_miningrequired
paramsarrayrequired

This method does not accept parameters.

idintegerrequired

Response

200OK

JSON-RPC Response indicating mining status

Authorization

api-keyAuthapiKey in header

eth_newBlockFilter

Create a new block filter

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<any>required

This method does not require any parameters.

idintegerrequired

Response

200OK

Filter ID created successfully

Authorization

api-keyAuthapiKey in header

eth_newFilter

Create a new log filter

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<object>required

Array with one object describing the filter options.

Show child attributes
fromBlockstring

Starting block number or tag ("latest", "earliest", "pending").

toBlockstring

Ending block number or tag.

addressstring | Array<string> | null
topicsArray<string | Array<string>> | null

Array of topic filters. Topics are 32-byte hashes identifying events.

Show child attributes
One of
string
Array<string>
idintegerrequired

Response

200OK

Filter ID created successfully

Authorization

api-keyAuthapiKey in header

eth_newPendingTransactionFilter

Create a filter for pending transactions

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<any>required

No parameters required for this method

idintegerrequired

Request identifier

Response

200OK

Filter ID created successfully

Authorization

api-keyAuthapiKey in header

eth_sendRawTransaction

Send a raw signed transaction

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

paramsArray<string>required

Array containing a single signed transaction data (hex string)

idintegerrequired

Request ID

Response

200OK

Transaction successfully sent

Authorization

api-keyAuthapiKey in header

eth_sendTransaction

Send a transaction using node-managed account

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<object>required

Transaction object

Show child attributes
fromstring

Address the transaction is sent from

tostring

Address the transaction is directed to

gasstring

Gas provided for the transaction (hex)

gasPricestring

Gas price in wei (hex)

valuestring

Value sent with the transaction in wei (hex)

datastring

(Optional) Data for contract interaction

idintegerrequired

Response

200OK

Transaction successfully sent

Authorization

api-keyAuthapiKey in header

eth_sign

Sign arbitrary data using eth_sign

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required

[address, data]

  • address: The account that will sign the data
  • data: The data to be signed (must be a hex string)
idintegerrequired

Response

200OK

Returns the signature of the message

Authorization

api-keyAuthapiKey in header

eth_signTransaction

eth_signTransaction

POST
https://hype.nownodes.io/evm

Signs a transaction locally with the private key of the specified account.

Body

application/json
jsonrpcstringrequired
methodstringeth_signTransactionrequired
paramsArray<object>required

Array with a single object representing the transaction to sign.

Show child attributes
fromstringrequired

The address of the account that will sign the transaction.

tostring

The destination address of the transaction.

gasstring

Gas limit for the transaction, as a hex string.

gasPricestring

Gas price in wei, as a hex string.

valuestring

Amount of wei to send, as a hex string.

datastring

Data payload of the transaction, hex encoded.

noncestring

Nonce of the transaction, as a hex string.

chainIdinteger

The chain ID to protect against replay attacks.

idintegerrequired

Response

200OK

JSON-RPC response with the signed transaction data

Authorization

api-keyAuthapiKey in header

eth_syncing

Check if node is syncing

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsarrayrequired

Must be an empty array.

idintegerrequired

Response

200OK

Returns sync status object or false

Authorization

api-keyAuthapiKey in header

eth_uninstallFilter

Uninstall an existing filter

POST
https://hype.nownodes.io/evm

Body

application/json
jsonrpcstringrequired
methodstringrequired
paramsArray<string>required
idintegerrequired

Response

200OK

Success or failure of the uninstall operation

Authorization

api-keyAuthapiKey in header

net_listening

net_listening

POST
https://hype.nownodes.io/evm

Checks if the client is listening for network connections.

Body

application/json
jsonrpcstringrequired
methodstringnet_listeningrequired
paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with listening status

Authorization

api-keyAuthapiKey in header

net_peerCount

net_peerCount

POST
https://hype.nownodes.io/evm

Returns the number of peers currently connected to the client.

Body

application/json
jsonrpcstringrequired
methodstringnet_peerCountrequired
paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the number of connected peers

Authorization

api-keyAuthapiKey in header

net_version

net_version

POST
https://hype.nownodes.io/evm

Returns the current network ID of the Ethereum client.

Body

application/json
jsonrpcstringrequired
methodstringnet_versionrequired
paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the current network ID

Authorization

api-keyAuthapiKey in header

web3_clientVersion

web3_clientVersion

POST
https://hype.nownodes.io/evm

Returns the current Ethereum client version.

Body

application/json
jsonrpcstringrequired
methodstringweb3_clientVersionrequired
paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the client version string

Authorization

api-keyAuthapiKey in header

web3_sha3

web3_sha3

POST
https://hype.nownodes.io/evm

Computes the Keccak-256 (SHA-3) hash of the given hex-encoded data.

Body

application/json
jsonrpcstringrequired
methodstringweb3_sha3required
paramsArray<string>required

Array containing a single hex-encoded data string to hash.

idintegerrequired

Response

200OK

JSON-RPC response with the Keccak-256 hash of the input data

Authorization

api-keyAuthapiKey in header

MAINNET / INFO

allBorrowLendReserveStates

Get all borrow/lend reserve states

POST
https://hype.nownodes.io/info

Returns an overview of all borrow/lend reserve pools, including annualised rates, balances, utilisation, oracle price, LTV, and total supplied/borrowed amounts. No user address is required.

Body

application/json
typestringrequired

Operation type. Must be exactly "allBorrowLendReserveStates" (case‑sensitive).

Response

200OK

An array of reserve state tuples. Each tuple contains a pool identifier (integer) and an object with the reserve’s details.

Authorization

api-keyAuthapiKey in header

borrowLendUserState

Get borrow/lend user state

POST
https://hype.nownodes.io/info

Retrieves the health summary and token-level snapshots for the user's borrow/lend positions. The tokenToState array is empty when the user has no active borrows or supplies.

Body

application/json
typestringrequired

Operation type; must be exactly "borrowLendUserState" (case‑sensitive).

userstringrequired

Ethereum wallet address. Format: 0x‑prefixed hex string, 42 characters.

Response

200OK

Simplified borrow/lend state object.

Authorization

api-keyAuthapiKey in header

clearinghouseState

Get clearinghouse state for a user

POST
https://hype.nownodes.io/info

Retrieves a user’s clearinghouse state, which includes margin summary (account value, total notional, margin used), cross‑margin information, maintenance margin used, withdrawable funds, and a list of open perpetual positions (one‑way positions).

Body

application/json
typestringrequired

Request type, must be "clearinghouseState"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

delegations

Get delegations

POST
https://hype.nownodes.io/info

Fetches a list of delegation objects for the given Ethereum wallet. Each object contains the delegator, the delegate, the delegated amount, and the time window during which the delegation is valid.

Body

application/json
typestringrequired

Operation type; must be exactly "delegations".

userstringrequired

Ethereum wallet address whose delegations you want to retrieve. Format: 0x‑prefixed hex string, 42 characters.

Response

200OK

Array of delegation objects (empty if none exist).

Authorization

api-keyAuthapiKey in header

delegatorSummary

Get delegator summary

POST
https://hype.nownodes.io/info

Fetches aggregated delegation information for the specified wallet address. The response indicates how much of the account's balance is currently delegated, how much remains undelegated, and the status of any pending withdrawals from delegations.

Body

application/json
typestringrequired

Operation type. Must be exactly "delegatorSummary" (case‑sensitive).

userstringrequired

Ethereum wallet address of the delegator. Format: 0x‑prefixed hex string, 42 characters.

Response

200OK

Aggregated delegator summary object.

Authorization

api-keyAuthapiKey in header

exchangeStatus

Get exchange status

POST
https://hype.nownodes.io/info

Retrieves the current operational status of the exchange.

Body

application/json
typestring

Request type, must be "exchangeStatus"

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

extraAgents

Get extra agents for a user

POST
https://hype.nownodes.io/info

Retrieves the extra agents (automated trading agents, sub‑account bots, etc.) linked to the given user.

Body

application/json
typestringrequired

Request type, must be "extraAgents"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

frontendOpenOrders

Get frontend-enriched open orders

POST
https://hype.nownodes.io/info

Returns all open orders for the specified user address, decorated with additional information relevant for frontend display. The response includes the full set of fields: coin, side, limitPx, sz, oid, timestamp, triggerCondition, isTrigger, triggerPx, children, isPositionTpsl, reduceOnly, orderType, origSz, tif, and cloid.

Body

application/json
typestringrequired

Operation type; must be exactly "frontendOpenOrders" (case‑sensitive).

userstringrequired

Ethereum wallet address. Format: 0x‑prefixed hex string, 42 characters.

Response

200OK

Array of enriched open order objects.

Authorization

api-keyAuthapiKey in header

maxMarketOrderNtls

Get max market order notional tiers

POST
https://hype.nownodes.io/info

Returns a list of leverage tiers together with the corresponding maximum notional value that can be sent in a single market order. The response is an array of tuples, where each tuple contains the leverage as an integer and the max notional as a decimal string.

Body

application/json
typestringrequired

Operation type. Must be exactly "maxMarketOrderNtls" (case‑sensitive).

Response

200OK

A JSON array of leverage‑tier tuples. Each tuple is an array of two elements: an integer (leverage) and a string (max notional value).

Authorization

api-keyAuthapiKey in header

meta

Get meta information

POST
https://hype.nownodes.io/info

Retrieves the universe of tradable assets, margin tables (leverage tiers), and collateral token configuration.

Body

application/json
typestring

Request type, must be "meta"

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

openOrders

Get open orders

POST
https://hype.nownodes.io/info

Queries the Hyperliquid exchange for all open orders belonging to the given Ethereum wallet address. The request body must contain "type": "openOrders" and a valid 0x-prefixed user address. The response returns an array of order objects, or an empty array if no open orders exist.

Body

application/json
typestringrequired

Operation type. Must be the exact string "openOrders" (case-sensitive).

userstringrequired

Ethereum wallet address of the user whose open orders you want to fetch. Format: 0x-prefixed hexadecimal string, 42 characters long (e.g. 0x31ca...974b). No checksum requirement is enforced, but the address must exist on the exchange.

Response

200OK

A JSON array containing all currently open orders for the specified user. Each order object includes full details: coin symbol, side, limit price, current size, order ID, timestamp, and original size. If there are no open orders, the array is empty.

Authorization

api-keyAuthapiKey in header

perpDeployAuctionStatus

Get perpetual deployment auction status

POST
https://hype.nownodes.io/info

Retrieves the gas auction parameters for deploying perpetual contracts.

Body

application/json
typestringrequired

Request type, must be "perpDeployAuctionStatus"

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

perpDexs

Get perpetual DEXs

POST
https://hype.nownodes.io/info

Retrieves an array of all deployed perpetual DEX contracts. Each DEX object includes its name, full name, deployer address, oracle updater, fee recipient, and per‑asset parameters (e.g., open interest caps, funding multipliers, funding interest rates).

Body

application/json
typestringrequired

Request type, must be "perpDexs"

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

perpsAtOpenInterestCap

Get perpetuals at open interest cap

POST
https://hype.nownodes.io/info

Retrieves an array of perpetual contract symbols that are currently at or above their open interest cap. Trading or opening new positions may be restricted for these assets.

Body

application/json
typestringrequired

Request type, must be "perpsAtOpenInterestCap"

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

spotClearinghouseState

Get spot clearinghouse state for a user

POST
https://hype.nownodes.io/info

Retrieves a user’s spot account state, including token holdings, total account value, withdrawable funds, and the number of open spot orders.

Body

application/json
typestringrequired

Request type, must be "spotClearinghouseState"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

spotDeployState

Get spot deploy state for a user

POST
https://hype.nownodes.io/info

Retrieves the deployment state of spot markets for a specific user address, along with the gas auction status.

Body

application/json
typestringrequired

Request type, must be "spotDeployState"

userstringrequired

Ethereum address (hex) of the user

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

spotMeta

Get spot meta information

POST
https://hype.nownodes.io/info

Retrieves the universe of spot trading pairs and the list of tokens with their decimals, EVM contract details, and metadata.

Body

application/json
typestring

Request type, must be "spotMeta"

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

subAccounts

Get sub‑accounts for a user

POST
https://hype.nownodes.io/info

Retrieves the sub‑accounts linked to a specific main account.

Body

application/json
typestringrequired

Request type, must be "subAccounts"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

userAbstraction

Get user abstraction setting

POST
https://hype.nownodes.io/info

Retrieves the abstraction configuration for a specific user (e.g., whether abstracted account mode is active).

Body

application/json
typestringrequired

Request type, must be "userAbstraction"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

userFees

Get user fee information

POST
https://hype.nownodes.io/info

Retrieves fee statistics and fee schedule for a given user.

Body

application/json
typestringrequired

Request type, must be "userFees"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

userRateLimit

Get user rate limit information

POST
https://hype.nownodes.io/info

Retrieves rate‑limit statistics for the given user, such as cumulative trading volume and request consumption.

Body

application/json
typestringrequired

Request type, must be "userRateLimit"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

userRole

Get user role

POST
https://hype.nownodes.io/info

Retrieves the role of a given user (e.g., "vault", "normal", "admin").

Body

application/json
typestringrequired

Request type, must be "userRole"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

userToMultiSigSigners

Get multi‑sig signers for a user

POST
https://hype.nownodes.io/info

Retrieves the multi‑signature signers mapped to the given user address.

Body

application/json
typestringrequired

Request type, must be "userToMultiSigSigners"

userstringrequired

Ethereum address (hex)

Response

200OK

Successful response

Authorization

api-keyAuthapiKey in header

userVaultEquities

Get user vault equities

POST
https://hype.nownodes.io/info

Fetches all vault equity positions held by the given wallet address. Each object in the response represents a single vault allocation, including the deposited amount and current equity value.

Body

application/json
typestringrequired

Operation type; must be exactly "userVaultEquities" (case‑sensitive).

userstringrequired

Ethereum wallet address whose vault stakes are queried. Format: 0x‑prefixed hex string, 42 characters.

Response

200OK

Array of vault equity objects (empty if none).

Authorization

api-keyAuthapiKey in header

vaultSummaries

Get all vault summaries

POST
https://hype.nownodes.io/info

Fetches a global list of vaults that exist on the Hyperliquid platform, including their address, name, total value locked, APR, user count, and other metadata.

Body

application/json
typestringrequired

Operation type; must be exactly "vaultSummaries" (case‑sensitive).

Response

200OK

Array of vault summary objects.

Authorization

api-keyAuthapiKey in header

webData2

Get full account and platform data (webData2)

POST
https://hype.nownodes.io/info

Fetches detailed information about the user's clearinghouse state, current asset contexts, TWAP states, and open interest caps. Requires a valid 0x‑prefixed wallet address.

Body

application/json
typestringrequired

Operation type. Must be exactly "webData2" (case‑sensitive).

userstringrequired

Ethereum wallet address. Format: 0x‑prefixed hex string, 42 characters.

Response

200OK

Full account snapshot and platform metadata.

Authorization

api-keyAuthapiKey in header