Block info + nearest-block-to-timestamp API

Return normalized block facts (height, time, tx count, gas used / limit, gas-used %, base fee in gwei) by block number, 'latest', OR a unix timestamp — the timestamp path binary-searches the chain to resolve 'which block was live at time T?', a primitive no single RPC method provides. Raw hex is decoded into clean numbers. Answers 'what block was at this timestamp', 'block info for height N', 'latest block on base', 'gas used in this block'.

Price$0.01per request

MethodPOST

Route/v1/chain/block

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

chainblocktimestamprpcevmheightresolvergas

API URLhttps://x402.hexl.dev/v1/chain/block

Integration docs

Example request

{
  "chain": "ethereum",
  "timestamp": 1609459200
}

Example response

{
  "chain": "ethereum",
  "number": 11565019,
  "hash": "0x12620d72a9306bc7c5ed1e2ba1ac75115197020d5101925305c714e8e1d174d7",
  "timestamp": 1609459200,
  "time": "2021-01-01T00:00:00.000Z",
  "transactionCount": 130,
  "gasUsed": "12424293",
  "gasLimit": "12444416",
  "gasUsedPercent": 99.83,
  "baseFeeGwei": null,
  "resolvedFromTimestamp": 1609459200
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "chain": {
      "type": "string",
      "enum": [
        "ethereum",
        "base",
        "arbitrum",
        "optimism",
        "polygon"
      ],
      "default": "ethereum"
    },
    "block": {
      "type": [
        "number",
        "string"
      ],
      "examples": [
        "latest",
        11565019
      ]
    },
    "timestamp": {
      "type": "number",
      "examples": [
        1609459200
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}