Block by Number

Endpoint

POST /info

Request Body

Parameter	Type	Description
type*	string	Must be "blockByNumber"
blockNumber*	number	Block number to retrieve, e.g., 12345

Response

{
  "blockNumber": 12345,
  "timestamp": 1701234567890,
  "transactionCount": 15,
  "blockHash": "0x1234abcd...",
  "transactions": [
    {
      "transactionId": "0x...",
      "type": "OrderPlaced",
      "timestamp": 1701234567890,
      "orderId": "0x..."
    }
  ]
}

Response Fields

Field	Type	Description
blockNumber	number	Block number
timestamp	number	Block timestamp (ms)
transactionCount	number	Number of transactions
blockHash	string	Block hash
transactions	array	List of transactions in block

| transactions[].transactionId | string | Transaction hash | | transactions[].type | string | Transaction type (event type) | | transactions[].timestamp | number | Transaction timestamp | | transactions[].orderId | string | Related order ID (if applicable) |

Example Request

curl -X POST https://api.notional.xyz/info \
  -H "Content-Type: application/json" \
  -d '{
    "type": "blockByNumber",
    "blockNumber": 12345
  }'

Error Responses

{
  "error": "Block 12345 not found"
}

HTTP Status: 400 Bad Request

Notes

• Block numbers start at 1 (no block 0)
• Transactions ordered by position in block