getActivity

Fetch account activity: deposits, withdrawals, liquidations, and funding

Returns paginated account activity: deposits, withdrawals, liquidations, and funding payments.

The examples on this page use Hyperliquid (provider: 'hyperliquid'). Replace the provider value with any supported DEX from getProviders().

import { getActivity } from '@lifi/perps-sdk';

const activity = await getActivity(client, {
  provider: 'hyperliquid',
  address: userAddress,
  limit: 50,
});

for (const item of activity.items) {
  console.log(item.type, item.timestamp);
  if (item.type === 'FUNDING') {
    console.log(item.asset.displaySymbol, item.amount, item.fundingRate);
  }
}

// Pagination
if (activity.pagination.hasMore) {
  const nextPage = await getActivity(client, {
    provider: 'hyperliquid',
    address: userAddress,
    cursor: activity.pagination.cursor,
  });
}

Filtering by type

import { getActivity, ActivityType } from '@lifi/perps-sdk';

// Only funding payments
const funding = await getActivity(client, {
  provider: 'hyperliquid',
  address: userAddress,
  type: [ActivityType.FUNDING],
});

// Deposits and withdrawals
const transfers = await getActivity(client, {
  provider: 'hyperliquid',
  address: userAddress,
  type: [ActivityType.DEPOSIT, ActivityType.WITHDRAWAL],
});

Parameters

Parameter	Type	Required	Description
client	PerpsSDKClient	Yes	SDK client
params.provider	string	Yes	DEX identifier
params.address	string	Yes	User’s wallet address
params.cursor	string	No	Pagination cursor from previous response
params.limit	number	No	Items per page (default 50, max 200)
params.startTime	number	No	Filter: activity after this timestamp (ms)
params.endTime	number	No	Filter: activity before this timestamp (ms)
params.type	ActivityType[]	No	Filter by activity type(s)
options	SDKRequestOptions	No	Request options

Returns

ActivitiesResponse:

Field	Type	Description
provider	string	Provider identifier
items	ActivityItem[]	Activity items (discriminated union by type)
pagination	Pagination	Pagination metadata

ActivityType enum

Value	Description
DEPOSIT	Funds deposited
WITHDRAWAL	Funds withdrawn
FUNDING	Funding payment on position
LIQUIDATION	Position liquidated

Activity item fields

All items share id, provider, type, and timestamp. Additional fields depend on type:

DEPOSIT: amount

WITHDRAWAL: amount, fee

FUNDING: asset (AssetDisplay), amount (negative = paid), positionSize, fundingRate

LIQUIDATION: liquidatedNotionalPosition, accountValue, leverageType, liquidatedPositions[] (each with asset: AssetDisplay and size)

API Reference: GET /activity