v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB

Actions

Get unified perp activity

Paginated chronological feed of timeline events and user actions for an address on one or more providers (newest first). Pass providerId or providerIds. Events use occurredAt; actions use createdAt.

get/v1/activity

Query parameters

offsetnumber

Offset for pagination

limitnumber

Maximum number of items to return

providerId'hyperliquid' | 'hyperliquid-xyz'

Single provider identifier. At least one of providerId or providerIds must be provided.

providerIdsstring[]

Filter by multiple providers (CSV, repeated query params, or JSON array). At least one of providerId or providerIds must be provided. When both providerId and providerIds are set, results include all listed providers.

addressstring required

User wallet address

Current action status

If provided, filters only action items by their status. Timeline events are not affected.

actionStatusesActionStatus[]

Filter by multiple action statuses (supports CSV or repeated query params)

Response

Paginated unified activity

totalnumber required

Total number of items available

offsetnumber required

Offset of the current page

limitnumber required

Limit of the current page

Example response

{
  "total": 150,
  "limit": 100,
  "items": [
    {
      "event": {
        "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
        }
      }
    }
  ]
}