Skip to main content

Endpoint

POST /info

Request Body

ParameterTypeDescription
type*stringMust be "transactionByHash"
hash*stringTransaction hash (0x-prefixed), e.g., "0xabc123..."

Response

{
  "transactionId": "0xabc123...",
  "type": "OrderPlaced",
  "timestamp": 1701234567890,
  "blockNumber": 12345,
  "txIndex": 0,
  "orderId": "0xdef456...",
  "data": {
    "userAddress": "0x742d...",
    "asset": "BTC",
    "side": "buy",
    "limitPx": "50000.00",
    "sz": "0.1"
  }
}

Response Fields

FieldTypeDescription
transactionIdstringTransaction hash
typestringTransaction type
timestampnumberTransaction timestamp (ms)
blockNumbernumberBlock containing transaction
txIndexnumberPosition within block
orderIdstringRelated order ID (optional)
dataobjectFull transaction data

Example Request

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

Error Responses

{
  "error": "Transaction 0xabc123... not found"
}
HTTP Status: 400 Bad Request

Notes

  • Transaction hashes are deterministic and unique
  • The data field contains type-specific information