Query the full transaction history for your token. Filter by address, status, or transaction hash to understand how your token moves through the network.
Query Transactions
Get all transactions for your token:
const tokenId = await wallet.getIssuerTokenIdentifier();
const response = await wallet.queryTokenTransactions({
tokenIdentifiers: [tokenId]
});
console.log("Total transactions:", response.tokenTransactions.length);
Filter by Address
Get transactions for a specific Spark address:
const response = await wallet.queryTokenTransactions({
sparkAddresses: ["spark1abc..."]
});
You can only use one filter type per query. To filter by both token and address, first query by tokenIdentifiers, then filter the results by address in your application code.
Transaction Status
Each transaction has a status:
| Status | Meaning |
|---|
TOKEN_TRANSACTION_STARTED | Created, not yet signed |
TOKEN_TRANSACTION_SIGNED | Signed by all parties |
TOKEN_TRANSACTION_FINALIZED | Confirmed |
TOKEN_TRANSACTION_STARTED_CANCELLED | Cancelled before signing |
TOKEN_TRANSACTION_SIGNED_CANCELLED | Cancelled after signing |
const finalized = response.tokenTransactions.filter(
tx => tx.status === "TOKEN_TRANSACTION_FINALIZED"
);
console.log("Completed transactions:", finalized.length);
const response = await wallet.queryTokenTransactions({
tokenIdentifiers: [tokenId],
order: "desc",
pageSize: 50,
offset: 0
});
console.log("Transactions in page:", response.tokenTransactions.length);
