v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB

Actions

Get event by ID

Retrieve a single perp event by its UUID.

get/v1/events/{id}

Path parameters

idstring uuid required

The unique identifier of the event (UUID)

Response

Event details retrieved successfully

idstring uuid required

eventType'order_filled' | 'liquidation' | 'stop_loss_triggered' | 'take_profit_triggered' required

providerIdstring required

occurredAtstring date-time required

marketIdstring nullable

perpActionIdstring uuid nullable

Linked StakeKit action; null for liquidations

providerOrderIdstring nullable

Venue order identifier (e.g. Hyperliquid oid)

explorerUrlstring nullable

Block explorer URL for the settlement transaction

Example response

{
  "providerId": "hyperliquid",
  "explorerUrl": "https://app.hyperliquid.xyz/explorer/tx/0x8a3fb2c1d4e5f67890abcdef12345678901234567890abcdef1234567890abcd",
  "order": {
    "orderId": "394438950581",
    "marketId": "hyperliquid-eth-usdc",
    "asset": "ETH",
    "originalSizeBase": "0.0063",
    "remainingSizeBase": "0.0",
    "limitPrice": 2395.2,
    "triggerPrice": 2500,
    "childOrderIds": [],
    "createdAt": "2026-04-23T07:52:05.187Z",
    "closedPnl": "-12.45",
    "fillPrice": 2500.5
  }
}