Skip to main content

Endpoint

POST /info

Request Body

ParameterTypeDescription
type*stringMust be "blockByHash"
hash*stringBlock hash (0x-prefixed hex), e.g., "0x1234abcd..."

Response

Same format as Block by Number:
{
  "blockNumber": 12345,
  "timestamp": 1701234567890,
  "parentHash": "0x5678efgh...",
  "blockHash": "0x1234abcd...",
  "transactions": [
    {
      "transactionId": "0x...",
      "type": "OrderPlaced",
      "timestamp": 1701234567890,
      "blockNumber": 12345,
      "txIndex": 0,
      "orderId": "0x...",
      "data": {}
    }
  ]
}

Example Request

curl -X POST https://api.notional.xyz/info \
  -H "Content-Type: application/json" \
  -d '{
    "type": "blockByHash",
    "hash": "0x1234abcd..."
  }'

Error Responses

{
  "error": "Block with hash 0x1234abcd... not found"
}
HTTP Status: 400 Bad Request

Notes

  • Block hash lookup uses the block_by_hash index - Use blockByNumber if you already know the block number