{ "openrpc": "1.2.6", "info": { "title": "Hyperliquid Ethereum JSON-RPC API", "description": "Quicknode Hyperliquid Ethereum JSON-RPC API reference", "version": "1.0.0" }, "methods": [ { "name": "eth_accounts", "summary": "Returns an array of addresses owned by the client.", "description": "Returns an array of addresses owned by the client. Since Quicknode does not store private keys, this will always return an empty response.", "params": [], "result": { "name": "result", "description": "An array of addresses owned by the client", "schema": { "type": "array", "items": {} } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_accounts" }, "examples": [ { "name": "eth_accounts example", "params": [], "result": { "name": "eth_accounts result", "value": [] } } ] }, { "name": "eth_bigBlockGasPrice", "summary": "Returns the base fee for the next big block.", "description": "Returns the base fee for the next big block. HyperEVM uses a dual-block architecture with fast blocks (1-second interval, 2M gas limit) and big blocks (1-minute interval, 30M gas limit). This method returns the base fee specifically for big blocks, as opposed to eth_gasPrice which returns the base fee for the next fast block.", "params": [], "result": { "name": "result", "description": "The hexadecimal value of the base fee for the next big block", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_bigBlockGasPrice" }, "examples": [ { "name": "eth_bigBlockGasPrice example", "params": [], "result": { "name": "eth_bigBlockGasPrice result", "value": "0x5f5e100" } } ] }, { "name": "eth_blockNumber", "summary": "Returns the latest block number of the blockchain.", "description": "Returns the latest block number of the blockchain.", "params": [], "result": { "name": "result", "description": "An integer value of the latest block number encoded as hexadecimal", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_blockNumber" }, "examples": [ { "name": "eth_blockNumber example", "params": [], "result": { "name": "eth_blockNumber result", "value": "0x1f21916" } } ] }, { "name": "eth_call", "summary": "Executes a new message call immediately without creating a transaction on the block chain.", "description": "Executes a new message call immediately without creating a transaction on the block chain.", "params": [ { "name": "transaction", "description": "The transaction call object which contains the following fields:", "required": true, "schema": { "type": "object", "properties": { "from": { "type": "string", "description": "The address from which the transaction is sent" }, "to": { "type": "string", "description": "The address to which the transaction is addressed" }, "gas": { "type": "integer", "description": "The integer of gas provided for the transaction execution" }, "gasPrice": { "type": "integer", "description": "The integer of gasPrice used for each paid gas encoded as hexadecimal" }, "value": { "type": "integer", "description": "The integer of value sent with this transaction encoded as hexadecimal" }, "data": { "type": "string", "description": "The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation" } } } }, { "name": "blockNumber/tag", "description": "The block number in hexadecimal format or the tag 'latest'", "required": true, "schema": { "type": "string" } }, { "name": "Object", "description": "The State Override Set option allows you to change the state of a contract before executing the call, which means you can modify the values of variables stored in the contract, such as balances and approvals for that call without actually modifying the contract. Each address maps to an object containing:", "schema": { "type": "object", "properties": { "balance": { "type": "string", "description": "The fake balance to set for the account before executing the call" }, "nonce": { "type": "string", "description": "The fake nonce to set for the account before executing the call" }, "code": { "type": "string", "description": "The fake EVM bytecode to inject into the account before executing the call" }, "state": { "type": "object", "description": "The fake key-value mapping to override all slots in the account storage before executing the call" }, "stateDiff": { "type": "integer", "description": "The fake key-value mapping to override individual slots in the account storage before executing the call" } } } } ], "result": { "name": "result", "description": "The return value of the executed contract method", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_call" } }, { "name": "eth_chainId", "summary": "Returns the current network/chain ID, used to sign replay-protected transaction introduced in EIP-155.", "description": "Returns the current network/chain ID, used to sign replay-protected transaction introduced in EIP-155.", "params": [], "result": { "name": "result", "description": "It returns a hexadecimal value in string format which represents an integer of the chain ID", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_chainId" }, "examples": [ { "name": "eth_chainId example", "params": [], "result": { "name": "eth_chainId result", "value": "0x3e7" } } ] }, { "name": "eth_estimateGas", "summary": "Returns an estimation of gas for a given transaction.", "description": "Returns an estimation of gas for a given transaction.", "params": [ { "name": "transaction", "description": "The transaction call object:", "schema": { "type": "object", "properties": { "from": { "type": "string", "description": "The address from which the transaction is sent" }, "to": { "type": "string", "description": "The address to which the transaction is addressed" }, "gas": { "type": "integer", "description": "The integer of gas provided for the transaction execution" }, "gasPrice": { "type": "integer", "description": "The integer of gasPrice used for each paid gas encoded as hexadecimal" }, "value": { "type": "integer", "description": "The integer of value sent with this transaction encoded as hexadecimal" }, "data": { "type": "string", "description": "The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation." } } } }, { "name": "blockNumber", "description": "The block number in hexadecimal format or the tag 'latest'", "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The estimated amount of gas used", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_estimateGas" } }, { "name": "eth_feeHistory", "summary": "Returns the collection of historical gas information.", "description": "Returns the collection of historical gas information.", "params": [ { "name": "blockCount", "description": "The number of blocks in the requested range. Between 1 and 1024 blocks can be requested in a single query. It will return less than the requested range if not all blocks are available", "required": true, "schema": { "type": [ "string", "integer" ] } }, { "name": "newestBlock", "description": "The highest number block of the requested range in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain", "required": true, "schema": { "type": "string" } }, { "name": "rewardPercentiles", "description": "A list of percentile values with a monotonic increase in value. The transactions will be ranked by effective tip per gas for each block in the requested range, and the corresponding effective tip for the percentile will be calculated while taking gas consumption into consideration", "required": true, "schema": { "type": "integer" } } ], "result": { "name": "result", "description": "eth_feeHistory result", "schema": { "type": "object", "properties": { "oldestBlock": { "type": "string", "description": "The lowest number block of the returned range encoded in hexadecimal format" }, "baseFeePerGas": { "type": "array", "items": {}, "description": "An array of block base fees per gas. This includes the next block after the newest of the returned range, because this value can be derived from the newest block. Zeroes are returned for pre-EIP-1559 blocks" }, "gasUsedRatio": { "type": "array", "items": {}, "description": "An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit" }, "reward": { "type": "array", "items": {}, "description": "(Optional) An array of effective priority fees per gas data points from a single block. All zeroes are returned if the block is empty" }, "baseFeePerBlobGas": { "type": "array", "items": {}, "description": "The base fee per unit of blob gas (in hexadecimal) for a set of blocks" }, "blobGasUsedRatio": { "type": "array", "items": {}, "description": "The ratio of blob gas used to the blob gas limit" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_feeHistory" }, "examples": [ { "name": "eth_feeHistory example", "params": [], "result": { "name": "eth_feeHistory result", "value": { "baseFeePerGas": [ "0x5f5e100", "0x5f5e100", "0x5f5e100", "0x5f5e100", "0x54de2b8" ], "gasUsedRatio": [ 0.007, 0, 0.035887, 0.059615666666666664 ], "baseFeePerBlobGas": [ "0x1", "0x1", "0x1", "0x1", "0x1" ], "blobGasUsedRatio": [ 0, 0, 0, 0 ], "oldestBlock": "0x1f21914", "reward": [ [ "0x17d78400", "0x17d78400" ], [ "0x0", "0x0" ], [ "0x5f5e100", "0x17d78400" ], [ "0x59682f00", "0x59682f00" ] ] } } } ] }, { "name": "eth_gasPrice", "summary": "Returns the base fee for the next small block.", "description": "Returns the base fee for the next small block.", "params": [], "result": { "name": "result", "description": "The hexadecimal value of the base fee for the next small block", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_gasPrice" }, "examples": [ { "name": "eth_gasPrice example", "params": [], "result": { "name": "eth_gasPrice result", "value": "0x5f5e100" } } ] }, { "name": "eth_getBalance", "summary": "Returns the balance of given account address in wei.", "description": "Returns the balance of given account address in wei.", "params": [ { "name": "address", "description": "The address (20 bytes) to check for balance", "required": true, "schema": { "type": "string" } }, { "name": "blockNumber/tag", "description": "The block number in hexadecimal format or the tag 'latest'", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The ETH balance of the specified address in hexadecimal value, measured in wei", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getBalance" }, "examples": [ { "name": "eth_getBalance example", "params": [], "result": { "name": "eth_getBalance result", "value": "0x33f5bffa275d7126ceb8" } } ] }, { "name": "eth_getBlockByHash", "summary": "Returns information of the block matching the given block hash.", "description": "Returns information of the block matching the given block hash.", "params": [ { "name": "hash", "description": "The hash (32 bytes) of the block", "required": true, "schema": { "type": "string" } }, { "name": "transaction detail flag", "description": "(default: false) It returns the full transaction objects when it is true otherwise it returns only the hashes of the transactions", "required": true, "schema": { "type": "boolean" } } ], "result": { "name": "object", "description": "A block object, or null when no block was found", "schema": { "type": "object", "properties": { "hash": { "type": "string", "description": "The block hash of the requested block. null if pending" }, "parentHash": { "type": "string", "description": "The hash of the parent block" }, "sha3Uncles": { "type": "string", "description": "The SHA3 of the uncles data in the block" }, "miner": { "type": "string", "description": "The address of the beneficiary to whom the mining rewards were given" }, "stateRoot": { "type": "string", "description": "The root of the final state trie of the block" }, "transactionsRoot": { "type": "string", "description": "The root of the transaction trie of the block" }, "receiptsRoot": { "type": "string", "description": "The root of the receipts trie of the block" }, "logsBloom": { "type": "string", "description": "The bloom filter for the logs of the block. null if pending" }, "difficulty": { "type": "string", "description": "The integer of the difficulty for this block encoded as a hexadecimal" }, "number": { "type": "string", "description": "The block number of the requested block encoded as a hexadecimal. null if pending" }, "gasLimit": { "type": "string", "description": "The maximum gas allowed in this block encoded as a hexadecimal" }, "gasUsed": { "type": "string", "description": "The total used gas by all transactions in this block encoded as a hexadecimal" }, "timestamp": { "type": "string", "description": "The unix timestamp for when the block was collated" }, "extraData": { "type": "string", "description": "The “extra data” field of this block" }, "mixHash": { "type": "string", "description": "A string of a 256-bit hash encoded as a hexadecimal" }, "nonce": { "type": "string", "description": "The hash of the generated proof-of-work. null if pending" }, "baseFeePerGas": { "type": "string", "description": "(Optional) A string of the base fee encoded in hexadecimal format. Please note that this response field will not be included in a block requested before the EIP-1559 upgrade" }, "withdrawalsRoot": { "type": "string", "description": "The root of the withdrawals trie of the block" }, "blobGasUsed": { "type": "string", "description": "The total blob gas used in the block, encoded as a hexadecimal" }, "excessBlobGas": { "type": "string", "description": "The excess blob gas in the block, encoded as a hexadecimal" }, "parentBeaconBlockRoot": { "type": "string", "description": "The root of the parent beacon block for the block, used in blob verification" }, "size": { "type": "string", "description": "The size of this block in bytes as an Integer value encoded as hexadecimal" }, "uncles": { "type": "array", "items": {}, "description": "An array of uncle hashes" }, "transactions": { "type": "array", "items": {}, "description": "An array of transaction objects" }, "withdrawals": { "type": "array", "items": {}, "description": "An array of withdrawal operations included in the block" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getBlockByHash" }, "examples": [ { "name": "eth_getBlockByHash example", "params": [], "result": { "name": "eth_getBlockByHash result", "value": null } } ] }, { "name": "eth_getBlockByNumber", "summary": "Returns information of the block matching the given block number.", "description": "Returns information of the block matching the given block number.", "params": [ { "name": "blockNumber/tag", "description": "The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized", "required": true, "schema": { "type": "string" } }, { "name": "transaction detail flag", "description": "(default: false) The method returns the full transaction objects when this value is true otherwise, it returns only the hashes of the transactions", "required": true, "schema": { "type": "boolean" } } ], "result": { "name": "object", "description": "A block object, or null when no block was found", "schema": { "type": "object", "properties": { "hash": { "type": "string", "description": "The block hash of the requested block. null if pending" }, "parentHash": { "type": "string", "description": "The hash of the parent block" }, "sha3Uncles": { "type": "string", "description": "The SHA3 of the uncles data in the block" }, "miner": { "type": "string", "description": "The address of the beneficiary to whom the mining rewards were given" }, "stateRoot": { "type": "string", "description": "The root of the final state trie of the block" }, "transactionsRoot": { "type": "string", "description": "The root of the transaction trie of the block" }, "receiptsRoot": { "type": "string", "description": "The root of the receipts trie of the block" }, "logsBloom": { "type": "string", "description": "The bloom filter for the logs of the block. null if pending" }, "difficulty": { "type": "string", "description": "The integer of the difficulty for this block encoded as a hexadecimal" }, "number": { "type": "string", "description": "The block number of the requested block encoded as a hexadecimal. null if pending" }, "gasLimit": { "type": "string", "description": "The maximum gas allowed in this block encoded as a hexadecimal" }, "gasUsed": { "type": "string", "description": "The total used gas by all transactions in this block encoded as a hexadecimal" }, "timestamp": { "type": "string", "description": "The unix timestamp for when the block was collated" }, "extraData": { "type": "string", "description": "The “extra data” field of this block" }, "mixHash": { "type": "string", "description": "A string of a 256-bit hash encoded as a hexadecimal" }, "nonce": { "type": "string", "description": "The hash of the generated proof-of-work. null if pending" }, "baseFeePerGas": { "type": "string", "description": "(Optional) A string of the base fee encoded in hexadecimal format. Please note that this response field will not be included in a block requested before the EIP-1559 upgrade" }, "withdrawalsRoot": { "type": "string", "description": "The root of the withdrawals trie of the block" }, "blobGasUsed": { "type": "string", "description": "The total blob gas used in the block, encoded as a hexadecimal" }, "excessBlobGas": { "type": "string", "description": "The excess blob gas in the block, encoded as a hexadecimal" }, "parentBeaconBlockRoot": { "type": "string", "description": "The root of the parent beacon block for the block, used in blob verification" }, "size": { "type": "string", "description": "The size of this block in bytes as an Integer value encoded as hexadecimal" }, "uncles": { "type": "array", "items": {}, "description": "An array of uncle hashes" }, "transactions": { "type": "array", "items": {}, "description": "An array of transaction objects" }, "withdrawals": { "type": "array", "items": {}, "description": "An array of withdrawal operations included in the block" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getBlockByNumber" } }, { "name": "eth_getBlockReceipts", "summary": "Returns all transaction receipts for a given block.", "description": "Returns all transaction receipts for a given block.", "params": [ { "name": "blockNumber", "description": "The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "An array of transaction receipt objects", "schema": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "The transaction type" }, "status": { "type": "string", "description": "Either 1 (success) or 0 (failure) encoded as hexadecimal" }, "cumulativeGasUsed": { "type": "string", "description": "The total amount of gas used when this transaction was executed in the block" }, "logs": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "topics": { "type": "array", "items": {}, "description": "Array of 0 to 4 32-byte DATA of indexed log arguments" }, "data": { "type": "string", "description": "Contains one or more 32-byte non-indexed arguments of the log" }, "blockHash": { "type": "string", "description": "Hash of the block where this log was in. null when pending" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when its a pending log" }, "blockTimestamp": { "type": "string", "description": "The timestamp of the block in which this log was included" }, "transactionHash": { "type": "string", "description": "The hash of the transactions this log was created from" }, "transactionIndex": { "type": "string", "description": "Integer of the transaction's index position log was created from" }, "logIndex": { "type": "string", "description": "Integer of the log index position in the block" }, "removed": { "type": "boolean", "description": "True when the log was removed due to a chain reorganization" } } }, "description": "Array of log objects generated by this transaction" }, "logsBloom": { "type": "string", "description": "The bloom filter for light clients to quickly retrieve related logs" }, "transactionHash": { "type": "string", "description": "The hash of the transaction" }, "transactionIndex": { "type": "string", "description": "The index of the transaction in the block" }, "blockHash": { "type": "string", "description": "The hash of the block. null when pending" }, "blockNumber": { "type": "string", "description": "The block number in hexadecimal" }, "gasUsed": { "type": "string", "description": "The amount of gas used by this specific transaction alone" }, "effectiveGasPrice": { "type": "string", "description": "The actual value per gas deducted from the sender's account" }, "from": { "type": "string", "description": "The address of the sender" }, "to": { "type": "string", "description": "The address of the receiver. null when it's a contract creation transaction" }, "contractAddress": { "type": "string", "description": "The contract address created if the transaction was a contract creation, otherwise null" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getBlockReceipts" } }, { "name": "eth_getBlockTransactionCountByHash", "summary": "Returns the number of transactions for the block matching the given block hash.", "description": "Returns the number of transactions for the block matching the given block hash.", "params": [ { "name": "hash", "description": "The hash of the block", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The number of transactions associated with a specific block, in hexadecimal value", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getBlockTransactionCountByHash" }, "examples": [ { "name": "eth_getBlockTransactionCountByHash example", "params": [], "result": { "name": "eth_getBlockTransactionCountByHash result", "value": null } } ] }, { "name": "eth_getBlockTransactionCountByNumber", "summary": "Returns the number of transactions for the block matching the given block number.", "description": "Returns the number of transactions for the block matching the given block number.", "params": [ { "name": "blockNumber", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The number of transactions in a specific block represented in hexadecimal format", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getBlockTransactionCountByNumber" } }, { "name": "eth_getCode", "summary": "Returns the compiled bytecode of a smart contract.", "description": "Returns the compiled bytecode of a smart contract.", "params": [ { "name": "address", "description": "The address of the smart contract from which the bytecode will be obtained", "required": true, "schema": { "type": "string" } }, { "name": "blockNumber", "description": "The block number in hexadecimal format or the tag 'latest'", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The bytecode from a given address returned as a string", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getCode" }, "examples": [ { "name": "eth_getCode example", "params": [], "result": { "name": "eth_getCode result", "value": "0x" } } ] }, { "name": "eth_getLogs", "summary": "Returns an array of all logs matching a given filter object.", "description": "Returns an array of all logs matching a given filter object.", "params": [ { "name": "object", "description": "The transaction call object which contains the following fields", "schema": { "type": "object", "properties": { "fromBlock": { "type": "string", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain" }, "toBlock": { "type": "string", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain" }, "address": { "type": "string", "description": "The contract address or a list of addresses from which logs should originate" }, "topics": { "type": "array", "items": {}, "description": "An array of DATA topics and also, the topics are order-dependent. Visit this official page to learn more about topics" }, "blockHash": { "type": "string", "description": "With the addition of EIP-234, blockHash is a new filter option that restricts the logs returned to the block number referenced in the blockHash. Using the blockHash field is equivalent to setting the fromBlock and toBlock to the block number the blockHash references. If blockHash is present in the filter criteria, neither fromBlock nor toBlock is allowed" } } } } ], "result": { "name": "result", "description": "An array of log objects, or an empty array if nothing has changed since last poll", "schema": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "topics": { "type": "array", "items": {}, "description": "An array of (0 to 4) 32 Bytes DATA of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier)" }, "data": { "type": "string", "description": "It contains one or more 32 Bytes non-indexed arguments of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when its pending. Null when it's a pending log" }, "transactionHash": { "type": "string", "description": "The hash of the transaction from which this log was created from. null if the log is pending" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. Null when it's a pending log" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. Null when it's a pending log" }, "logIndex": { "type": "string", "description": "The integer of the log index position in the block. Null when it's a pending log" }, "removed": { "type": "boolean", "description": "It is true if log was removed, due to a chain reorganization and false if it's a valid log" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getLogs" } }, { "name": "eth_getStorageAt", "summary": "Returns the value from a storage position at a given address.", "description": "Returns the value from a storage position at a given address.", "params": [ { "name": "address", "description": "The address to check for storage", "required": true, "schema": { "type": "string" } }, { "name": "position", "description": "The integer of the position in storage", "required": true, "schema": { "type": "string" } }, { "name": "blockNumber", "description": "The block number in hexadecimal format or the tag 'latest'", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "It returns the value from a storage position at a given address", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getStorageAt" }, "examples": [ { "name": "eth_getStorageAt example", "params": [], "result": { "name": "eth_getStorageAt result", "value": "0x00000000000000000000002f0ff4d1aa20c44c72cbfd57f7abf4736585b10200" } } ] }, { "name": "eth_getSystemTxsByBlockHash", "summary": "Returns system transactions for a specified block hash on Hyperliquid EVM.", "description": "Returns system transactions for a specified block hash on Hyperliquid EVM. This Hyperliquid-specific method retrieves internal system transactions using the block’s unique hash, ensuring accurate block identification even in the event of chain reorganizations.", "params": [ { "name": "hash", "description": "The hash (32 bytes) of the block", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "An array of system transaction objects included in the block", "schema": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "The transaction type" }, "chainId": { "type": "string", "description": "The chain ID encoded as hexadecimal" }, "nonce": { "type": "string", "description": "The transaction count of the sender" }, "gasPrice": { "type": "string", "description": "Gas price in wei, encoded as hexadecimal" }, "gas": { "type": "string", "description": "Gas limit provided by the sender" }, "to": { "type": "string", "description": "Recipient address (null for contract creation)" }, "value": { "type": "string", "description": "Value transferred in wei, encoded as hexadecimal" }, "input": { "type": "string", "description": "Input data of the transaction" }, "r": { "type": "string", "description": "ECDSA signature r" }, "s": { "type": "string", "description": "ECDSA signature s" }, "v": { "type": "string", "description": "ECDSA recovery id" }, "hash": { "type": "string", "description": "Transaction hash" }, "blockHash": { "type": "string", "description": "Block hash" }, "blockNumber": { "type": "string", "description": "Block number in hexadecimal" }, "transactionIndex": { "type": "string", "description": "Index of the transaction in the block" }, "from": { "type": "string", "description": "Sender address" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getSystemTxsByBlockHash" } }, { "name": "eth_getSystemTxsByBlockNumber", "summary": "Returns system transactions for a specified block number on Hyperliquid EVM.", "description": "Returns system transactions for a specified block number on Hyperliquid EVM. This Hyperliquid-specific method exposes internal system transactions responsible for protocol operations, network maintenance, and other system-level activities.", "params": [ { "name": "blockNumber/tag", "description": "The block number in hexadecimal format or the string latest, pending, safe or finalized", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "An array of system transaction objects included in the block", "schema": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "The transaction type" }, "chainId": { "type": "string", "description": "The chain ID encoded as hexadecimal" }, "nonce": { "type": "string", "description": "The transaction count of the sender" }, "gasPrice": { "type": "string", "description": "Gas price in wei, encoded as hexadecimal" }, "gas": { "type": "string", "description": "Gas limit provided by the sender" }, "to": { "type": "string", "description": "Recipient address (null for contract creation)" }, "value": { "type": "string", "description": "Value transferred in wei, encoded as hexadecimal" }, "input": { "type": "string", "description": "Input data of the transaction" }, "r": { "type": "string", "description": "ECDSA signature r" }, "s": { "type": "string", "description": "ECDSA signature s" }, "v": { "type": "string", "description": "ECDSA recovery id" }, "hash": { "type": "string", "description": "Transaction hash" }, "blockHash": { "type": "string", "description": "Block hash" }, "blockNumber": { "type": "string", "description": "Block number in hexadecimal" }, "transactionIndex": { "type": "string", "description": "Index of the transaction in the block" }, "from": { "type": "string", "description": "Sender address" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getSystemTxsByBlockNumber" } }, { "name": "eth_getTransactionByBlockHashAndIndex", "summary": "Returns information about a transaction given a blockhash and transaction index position.", "description": "Returns information about a transaction given a blockhash and transaction index position.", "params": [ { "name": "blockHash", "description": "The block hash", "required": true, "schema": { "type": "string" } }, { "name": "index", "description": "An integer of the transaction index position encoded as a hexadecimal", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "The transaction response object, or null if no transaction is found:", "schema": { "type": "object", "properties": { "type": { "type": "string", "description": "The transaction type" }, "chainId": { "type": "string", "description": "The chain id of the transaction, if any" }, "nonce": { "type": "string", "description": "The number of transactions made by the sender before this one encoded as hexadecimal" }, "gasPrice": { "type": "string", "description": "The gas price provided by the sender in wei, encoded as hexadecimal" }, "gas": { "type": "string", "description": "The gas provided by the sender, encoded as hexadecimal" }, "to": { "type": "string", "description": "The address of the receiver. null when it's a contract creation transaction" }, "value": { "type": "string", "description": "The value transferred in wei encoded as hexadecimal" }, "input": { "type": "string", "description": "The data sent along with the transaction" }, "r": { "type": "string", "description": "The R field of the signature" }, "s": { "type": "string", "description": "The S field of the signature" }, "v": { "type": "string", "description": "The standardized V field of the signature" }, "hash": { "type": "string", "description": "The hash of the transaction" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. null when it's a pending log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when it's a pending log" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. null when it's a pending log" }, "from": { "type": "string", "description": "The address of the sender" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getTransactionByBlockHashAndIndex" }, "examples": [ { "name": "eth_getTransactionByBlockHashAndIndex example", "params": [], "result": { "name": "eth_getTransactionByBlockHashAndIndex result", "value": null } } ] }, { "name": "eth_getTransactionByBlockNumberAndIndex", "summary": "Returns information about a transaction given a block number and transaction index position.", "description": "Returns information about a transaction given a block number and transaction index position.", "params": [ { "name": "blockNumber", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain", "required": true, "schema": { "type": "string" } }, { "name": "index", "description": "An integer of the transaction index position encoded as a hexadecimal", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "The transaction response object, or null if no transaction is found:", "schema": { "type": "object", "properties": { "type": { "type": "string", "description": "The transaction type" }, "chainId": { "type": "string", "description": "The chain id of the transaction, if any" }, "nonce": { "type": "string", "description": "The number of transactions made by the sender before this one encoded as hexadecimal" }, "gasPrice": { "type": "string", "description": "The gas price provided by the sender in wei, encoded as hexadecimal" }, "gas": { "type": "string", "description": "The gas provided by the sender, encoded as hexadecimal" }, "to": { "type": "string", "description": "The address of the receiver. null when it's a contract creation transaction" }, "value": { "type": "string", "description": "The value transferred in wei encoded as hexadecimal" }, "input": { "type": "string", "description": "The data sent along with the transaction" }, "r": { "type": "string", "description": "The R field of the signature" }, "s": { "type": "string", "description": "The S field of the signature" }, "v": { "type": "string", "description": "The standardized V field of the signature" }, "hash": { "type": "string", "description": "The hash of the transaction" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. null when it's a pending log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when it's a pending log" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. null when it's a pending log" }, "from": { "type": "string", "description": "The address of the sender" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getTransactionByBlockNumberAndIndex" } }, { "name": "eth_getTransactionByHash", "summary": "Returns the information about a transaction from a transaction hash.", "description": "Returns the information about a transaction from a transaction hash.", "params": [ { "name": "hash", "description": "The hash of a transaction", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "The transaction response object, or null if no transaction is found:", "schema": { "type": "object", "properties": { "type": { "type": "string", "description": "The transaction type" }, "chainId": { "type": "string", "description": "The chain id of the transaction, if any" }, "nonce": { "type": "string", "description": "The number of transactions made by the sender before this one encoded as hexadecimal" }, "gasPrice": { "type": "string", "description": "The gas price provided by the sender in wei, encoded as hexadecimal" }, "gas": { "type": "string", "description": "The gas provided by the sender, encoded as hexadecimal" }, "to": { "type": "string", "description": "The address of the receiver. null when it's a contract creation transaction" }, "value": { "type": "string", "description": "The value transferred in wei encoded as hexadecimal" }, "input": { "type": "string", "description": "The data sent along with the transaction" }, "r": { "type": "string", "description": "The R field of the signature" }, "s": { "type": "string", "description": "The S field of the signature" }, "v": { "type": "string", "description": "The standardized V field of the signature" }, "hash": { "type": "string", "description": "The hash of the transaction" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. null when it's a pending log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when it's a pending log" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. null when it's a pending log" }, "from": { "type": "string", "description": "The address of the sender" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getTransactionByHash" }, "examples": [ { "name": "eth_getTransactionByHash example", "params": [], "result": { "name": "eth_getTransactionByHash result", "value": null } } ] }, { "name": "eth_getTransactionCount", "summary": "Returns the number of transactions sent from an address.", "description": "Returns the number of transactions sent from an address.", "params": [ { "name": "address", "description": "The address from which the transaction count to be checked", "required": true, "schema": { "type": "string" } }, { "name": "blockNumber", "description": "The block number in hexadecimal format or the tag 'latest'", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The integer of the number of transactions sent from an address encoded as hexadecimal", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getTransactionCount" }, "examples": [ { "name": "eth_getTransactionCount example", "params": [], "result": { "name": "eth_getTransactionCount result", "value": "0xcbc83" } } ] }, { "name": "eth_getTransactionReceipt", "summary": "Returns the receipt of a transaction by transaction hash.", "description": "Returns the receipt of a transaction by transaction hash.", "params": [ { "name": "hash", "description": "The hash of a transaction", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "An array of transaction receipt objects", "schema": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "The transaction type" }, "status": { "type": "string", "description": "Either 1 (success) or 0 (failure) encoded as hexadecimal" }, "cumulativeGasUsed": { "type": "string", "description": "The total amount of gas used when this transaction was executed in the block" }, "logs": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "topics": { "type": "array", "items": {}, "description": "Array of 0 to 4 32-byte DATA of indexed log arguments" }, "data": { "type": "string", "description": "Contains one or more 32-byte non-indexed arguments of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when its a pending log" }, "transactionHash": { "type": "string", "description": "The hash of the transactions this log was created from" }, "transactionIndex": { "type": "string", "description": "Integer of the transaction's index position log was created from" }, "blockHash": { "type": "string", "description": "Hash of the block where this log was in. null when pending" }, "logIndex": { "type": "string", "description": "Integer of the log index position in the block" }, "removed": { "type": "boolean", "description": "True when the log was removed due to a chain reorganization" } } }, "description": "An array of log objects generated by this transaction" }, "logsBloom": { "type": "string", "description": "The bloom filter for light clients to quickly retrieve related logs" }, "transactionHash": { "type": "string", "description": "The hash of the transaction" }, "transactionIndex": { "type": "string", "description": "The index of the transaction in the block" }, "blockHash": { "type": "string", "description": "The hash of the block. null when pending" }, "blockNumber": { "type": "string", "description": "The block number in hexadecimal" }, "gasUsed": { "type": "string", "description": "The amount of gas used by this specific transaction alone" }, "effectiveGasPrice": { "type": "string", "description": "The actual value per gas deducted from the sender's account" }, "from": { "type": "string", "description": "The address of the sender" }, "to": { "type": "string", "description": "The address of the receiver. null when it's a contract creation transaction" }, "contractAddress": { "type": "string", "description": "The contract address created if the transaction was a contract creation, otherwise null" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_getTransactionReceipt" }, "examples": [ { "name": "eth_getTransactionReceipt example", "params": [], "result": { "name": "eth_getTransactionReceipt result", "value": null } } ] }, { "name": "eth_sendRawTransaction", "summary": "Creates new message call transaction or a contract creation for signed transactions.", "description": "Creates new message call transaction or a contract creation for signed transactions.", "params": [ { "name": "data", "description": "The signed transaction (typically signed with a library, using your private key)", "schema": {} } ], "result": { "name": "result", "description": "The transaction hash, or the zero hash if the transaction is not yet available", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_sendRawTransaction" } }, { "name": "eth_subscribe", "summary": "Starts a subscription to a specific event.", "description": "Starts a subscription to a specific event.", "params": [ { "name": "subscription name", "description": "The type of event you want to subscribe to (i.e., newHeads, logs, newPendingTransactions). This method supports the following subscription types:", "required": true, "schema": { "enum": [ "newHeads", "logs", "newPendingTransactions" ] } }, { "name": "data", "description": "The arguments such as an address, multiple addresses, and topics. Note, only logs that are created from these addresses or match the specified topics will return logs", "schema": { "type": "object" } } ], "result": { "name": "result", "description": "The hex encoded subscription ID. This ID will be attached to all received events and can also be used to cancel the subscription using eth_unsubscribe", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_subscribe" } }, { "name": "eth_syncing", "summary": "Returns an object with the sync status of the node if the node is out-of-sync and is syncing.", "description": "Returns an object with the sync status of the node if the node is out-of-sync and is syncing. Returns false when the node is already in sync.", "params": [], "result": { "name": "result", "description": "The result is false if JSON Object is not syncing otherwise it's true:", "schema": { "type": "object", "properties": { "startingBlock": { "type": "string", "description": "The block at which the import started encoded as hexadecimal" }, "currentBlock": { "type": "string", "description": "The current block, same as eth_blockNumber encoded as hexadecimal" }, "highestBlock": { "type": "string", "description": "The estimated highest block encoded as hexadecimal" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_syncing" }, "examples": [ { "name": "eth_syncing example", "params": [], "result": { "name": "eth_syncing result", "value": false } } ] }, { "name": "eth_unsubscribe", "summary": "Cancels an existing subscription so that no further events are sent.", "description": "Cancels an existing subscription so that no further events are sent.", "params": [ { "name": "subscription ID", "description": "A subscription ID that was previously generated in a eth_subscribe RPC request", "schema": { "type": "string" } } ], "result": { "name": "result", "description": "A boolean value indicating if the subscription was canceled successfully", "schema": { "type": "boolean" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_unsubscribe" } }, { "name": "eth_usingBigBlocks", "summary": "Returns whether a specific address is using big blocks on Hyperliquid EVM.", "description": "Returns whether a specific address is using big blocks on Hyperliquid EVM. This Hyperliquid-specific method helps determine if an address can utilize enhanced transaction processing capabilities.", "params": [ { "name": "address", "description": "The address to check for big blocks usage", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "True if the address is using big blocks, otherwise false", "schema": { "type": "boolean" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/eth_usingBigBlocks" } }, { "name": "net_version", "summary": "Returns the current network id.", "description": "Returns the current network id.", "params": [], "result": { "name": "result", "description": "The string value of current network id. Typical values are as follows:", "schema": { "type": "object", "properties": { "1 - ethereum mainnet": {}, "2 - morden testnet (deprecated)": {}, "3 - ropsten testnet": {}, "4 - rinkeby testnet": {}, "5 - goerli testnet": {}, "11155111 - sepolia testnet": {}, "10 - optimism mainnet": {}, "69 - optimism kovan testnet": {}, "42 - kovan testnet": {}, "137 - matic/polygon mainnet": {}, "80001 - matic/polygon mumbai testnet": {}, "250 - fantom mainnet": {}, "100 - xdai mainnet": {}, "56 - bsc mainnet": {}, "999 - Hyperliquid mainnet": {} } } }, "tags": [ { "name": "net" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/net_version" }, "examples": [ { "name": "net_version example", "params": [], "result": { "name": "net_version result", "value": "999" } } ] }, { "name": "web3_clientVersion", "summary": "Returns the current version of the chain client.", "description": "Returns the current version of the chain client.", "params": [], "result": { "name": "result", "description": "The current client version in string format", "schema": { "type": "string" } }, "tags": [ { "name": "web3" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/hyperliquid/web3_clientVersion" }, "examples": [ { "name": "web3_clientVersion example", "params": [], "result": { "name": "web3_clientVersion result", "value": "hyperliquid evm Mainnet" } } ] } ], "servers": [ { "name": "Ethereum JSON-RPC API", "url": "https://docs-demo.hype-mainnet.quiknode.pro/evm" } ] }