Returns a chronological feed of balance-changing events for a user — bridge deposits/withdrawals, on-chain account deposits/withdrawals, vault deposits/withdrawals, liquidations, and funding payments. Each row carries an `event_type` discriminator and a `notes` field with type-specific extras (e.g. funding rate and position size for funding events).
For trade fills, use `/v1/hyperliquid/markets/activity` instead.
Supply `event_types` (comma-separated) to filter to a subset. Defaults to the last 30 days when no time range is specified — provide `start_time` and `end_time` to query older data.
**Query Parameters:**
- **user** (Required): Filter by address
- **event_types**: Filter by balance-event type.<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
- **start_time**: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
- **end_time**: UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
- **limit**: Number of items* returned in a single request.<br>*Plan restricted.
- **page**: Page number to fetch.<br>Empty `data` array signifies end of results.
**Responses:**
- **200** (Success): Successful Response
- Content-Type: `application/json`
- **Response Properties:**
- **request_time**: ISO 8601 datetime string
- **Example:**
```json
{
"data": [
{
"block_num": 1,
"timestamp": "string",
"transaction_hash": "string",
"amount": 1.5,
"counterparty": "string",
"notes": "string",
"token": "string",
"user": "string",
"event_type": "bridge_deposit",
"event_index": 1
}
],
"statistics": {
"elapsed": 1.5,
"rows_read": 1.5,
"bytes_read": 1.5
},
"pagination": {
"previous_page": 1,
"current_page": 1
},
"request_time": "string",
"duration_ms": 1.5,
"results": 1.5
}
```
- **400**: Client side error
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}
```
- **401**: Authentication failed
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}
```
- **403**: Forbidden
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}
```
- **404**: Not found
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}
```
- **500**: Server side error
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}
```