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 provider 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.market.baseAsset.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	Provider identifier
params.address	Address	Yes	User’s wallet address (viem 0x${string})
params.cursor	string	No	Pagination cursor from previous response
params.limit	number	No	Items per page. Hyperliquid: default 50, max 200. Other providers: provider-defined.
params.startTime	number	No	Filter: activity at or after this timestamp (ms)
params.endTime	number	No	Filter: activity at or 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
TRANSFER	Transfer between two distinct accounts (Hyperliquid and Lighter; not Ondo)

Ondo: getActivity returns only FUNDING, LIQUIDATION, DEPOSIT, and WITHDRAWAL items. TRANSFER items come from Hyperliquid and Lighter only.

​

Activity item fields

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

DEPOSIT (DepositActivity): asset (Asset; use asset.displaySymbol), amount, counterpartyAddress? (source address, when the venue’s deposit payload names one), explorerLink? (block-explorer URL for the on-chain deposit tx)

WITHDRAWAL (WithdrawalActivity): asset (Asset; use asset.displaySymbol), amount, fee? (Fee, absent when the venue reports no fee), explorerLink? (block-explorer URL for the on-chain withdrawal tx)

FUNDING (FundingActivity): market (MarketDisplay), amount (negative = paid), positionSize, fundingRate

LIQUIDATION (LiquidationActivity): liquidatedNotionalPosition?, accountValue?, leverageType? (each absent when the venue reports no such value), liquidatedPositions[] (each with market: MarketDisplay and size?; at least one entry is guaranteed)

TRANSFER (TransferActivity): direction ('IN' or 'OUT', relative to the queried account), counterpartyAccountIndex? (L2 account integer — Lighter), counterpartyAddress? (wallet address — Hyperliquid), asset (Asset), amount, fees? (Fee[], every fee the venue charged, in the order reported — absent when the venue reports no fee), meta?, explorerLink? (block-explorer URL for the on-chain transfer tx). At least one of counterpartyAccountIndex / counterpartyAddress is always present; either may appear alone or alongside the other.

Activity items carry no classification field; only Fill does.

​

Throws

PerpsError with one code for the account’s access state. See Account access.

• SetupRequired — the venue needs a credential (a Lighter auth token or an Ondo session) and none is stored.
• Unauthorized — the venue rejects the credential.
• AccountNotFound — the wallet has no venue account.

An account with no activity returns an empty items list.

Data shapes: getActivity — a direct-to-provider read, not a LI.FI HTTP endpoint.