getTransfers

Gets paginated transfer history for a Spark address with optional date filters.

Method Signature

async getTransfers(params: QueryTransfersParams): Promise<{
  transfers: Transfer[];
  offset: number;
}>

interface QueryTransfersParams {
  sparkAddress: string;
  limit?: number;         // default: 20
  offset?: number;        // default: 0
  types?: TransferType[];
  createdAfter?: Date;
  createdBefore?: Date;
}

Parameters

string

required

The Spark address to query transfers for.

number

Maximum number of transfers to return (default: 20).

number

Offset for pagination (default: 0).

TransferType[]

Filter by transfer types. Defaults to TRANSFER, PREIMAGE_SWAP, COOPERATIVE_EXIT, UTXO_SWAP.

Date

Only return transfers created after this date.

Date

Only return transfers created before this date.

createdAfter and createdBefore are mutually exclusive. Providing both will throw an error.

Returns

Transfer[]

required

Raw protobuf Transfer objects with numeric enums, not the WalletTransfer objects returned by SparkWallet. Use participants and leaf values to derive wallet direction and amount; see transfer object differences.

number

required

The offset to use for the next page, or -1 when there are no more results.

Example

// Basic pagination
const { transfers, offset } = await client.getTransfers({
  sparkAddress: "sp1...",
  limit: 25,
  offset: 0,
});

// Transfers from the last 24 hours
const recent = await client.getTransfers({
  sparkAddress: "sp1...",
  createdAfter: new Date(Date.now() - 86_400_000),
});

Introduction

Wallets

Wallet Viewer

Utilities

Issuance

getTransfers

Method Signature

Parameters

Returns

Example

​Method Signature

​Parameters

​Returns

​Example

Method Signature

Parameters

Returns

Example