POST
/
evm
ots_getBlockDetailsByHash
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "method": "ots_getBlockDetailsByHash",
  "params": [
    "0xe8399bf41516f5ca663c79bc30db02b4989385c2f3a96f42958dea5753cbf4a9"
  ],
  "id": 1
}'
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block": {
      "number": "0x3e8",
      "hash": "0xe8399bf41516f5ca663c79bc30db02b4989385c2f3a96f42958dea5753cbf4a9"
    },
    "transactions": []
  }
}
The ots_getBlockDetailsByHash JSON-RPC method retrieves expanded block details by block hash on the Hyperliquid EVM blockchain. This Otterscan-specific method provides a tailored response for block detail pages in block explorers, including calculated total fees and other aggregated information.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

  1. block hash (string, required): The hash of the block to retrieve details for

Response

The method returns an enhanced block object with additional calculated fields.

Response structure

  • block — standard block object with all transactions
    • number — the block number
    • hash — the block hash
    • parentHash — the parent block hash
    • timestamp — Unix timestamp of the block
    • gasLimit — maximum gas allowed in the block
    • gasUsed — total gas used by all transactions
    • miner — address that mined/validated the block
    • baseFeePerGas — base fee per gas (post-EIP-1559)
    • transactions — array of transaction objects
    • transactionCount — number of transactions in the block
  • issuance — block reward issuance information
    • blockReward — reward for mining the block
    • uncleReward — rewards for uncle blocks
    • issuance — total new ETH issued
  • totalFees — total transaction fees collected in the block (in wei)

Usage example

Shell
curl -X POST https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "ots_getBlockDetailsByHash",
    "params": ["0xe8399bf41516f5ca663c79bc30db02b4989385c2f3a96f42958dea5753cbf4a9"],
    "id": 1
  }'

Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block": {
      "number": "0x3e8",
      "hash": "0xe8399bf41516f5ca663c79bc30db02b4989385c2f3a96f42958dea5753cbf4a9",
      "parentHash": "0x7c8f6a0e4d3b2a1c9e5f8b7d4a6c3e9f2b8d5a7c1e4f9b3a6d8c2e5f7a9b4c6d",
      "timestamp": "0x6734e8d0",
      "gasLimit": "0x1c9c380",
      "gasUsed": "0x5208",
      "miner": "0x0000000000000000000000000000000000000000",
      "baseFeePerGas": "0x7",
      "transactions": [
        {
          "hash": "0xf94f3d2ed5b59aefb6a0e566af8e86552014d84f6ed2f38a1366dedffe723381",
          "from": "0x1234567890abcdef1234567890abcdef12345678",
          "to": "0x5555555555555555555555555555555555555555",
          "value": "0xde0b6b3a7640000",
          "gas": "0x5208",
          "gasPrice": "0x3b9aca00"
        }
      ],
      "transactionCount": 1
    },
    "issuance": {
      "blockReward": "0x0",
      "uncleReward": "0x0",
      "issuance": "0x0"
    },
    "totalFees": "0x1236efcbcbb340"
  }
}

Use cases

The ots_getBlockDetailsByHash method is essential for:
  • Block explorers: Display comprehensive block information when accessed by hash
  • Block verification: Retrieve detailed information for specific known blocks
  • Cross-reference validation: Verify block data using hash identifiers
  • Fee reconciliation: Calculate total fees for specific blocks
  • Fork detection: Analyze blocks on different chain branches
  • Archive queries: Access historical block data by hash
  • Integration testing: Verify specific blocks in test scenarios
  • Audit trails: Reference specific blocks in compliance reports
  • Performance benchmarking: Analyze specific blocks for metrics
  • Research tools: Study particular blocks of interest
This method is particularly useful when you have a block hash from an event log or transaction receipt and need to retrieve comprehensive block information.

Body

application/json

Response

200 - application/json

Successful response with detailed block information

The response is of type object.