Skip to main content

​
Endpoint

POST /info

​
Request Body

ParameterTypeDescription
type*stringMust be "blockByNumber"
blockNumber*numberBlock 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

FieldTypeDescription
blockNumbernumberBlock number
timestampnumberBlock timestamp (ms)
transactionCountnumberNumber of transactions
blockHashstringBlock hash
transactionsarrayList 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