getTokenTransactions

Query token transactions with cursor-based pagination.

Queries token transactions with optional filters and cursor-based pagination.

Method Signature

async getTokenTransactions(
  params?: QueryTokenTransactionsParams,
): Promise<{
  transactions: TokenTransactionWithStatus[];
  pageResponse: {
    nextCursor?: string;
    prevCursor?: string;
  };
}>

interface QueryTokenTransactionsParams {
  sparkAddresses?: string[];
  issuerPublicKeys?: string[];
  tokenIdentifiers?: string[];
  outputIds?: string[];
  pageSize?: number;            // default: 50
  cursor?: string;
  direction?: "NEXT" | "PREVIOUS";
}

Parameters

Filters are combined using AND logic.

sparkAddresses · string[]

Filter by Spark addresses.

issuerPublicKeys · string[]

Filter by issuer public keys.

tokenIdentifiers · string[]

Filter by Bech32m token identifiers.

outputIds · string[]

Filter by output IDs.

pageSize · number

Number of results per page (default: 50).

cursor · string

Cursor from a previous response for pagination.

direction · "NEXT" | "PREVIOUS"

Pagination direction (default: "NEXT").

Returns

transactions · TokenTransactionWithStatus[] · required

Array of token transaction objects.

pageResponse · object · required

Pagination metadata with nextCursor and prevCursor.

Example

// First page
const page = await client.getTokenTransactions({
  sparkAddresses: ["sp1..."],
  pageSize: 25,
});

console.log(`${page.transactions.length} transactions`);

// Next page
if (page.pageResponse?.nextCursor) {
  const next = await client.getTokenTransactions({
    sparkAddresses: ["sp1..."],
    cursor: page.pageResponse.nextCursor,
    direction: "NEXT",
  });
}