WDK logoWDK documentation

Transaction History

Retrieve and filter Bitcoin transfer history.

This guide explains how to retrieve all transfers, filter by direction, paginate results, and check transaction receipts.

Retrieve All Transfers

You can retrieve the account's transfer history using account.getTransfers():

Get All Transfers
const transfers = await account.getTransfers()
console.log('Recent transfers:', transfers)

The default limit is 10 transfers. Change outputs are automatically filtered out. Transfers are sorted by block height (newest first).

Filter by Direction

You can filter transfers by direction using the direction option in account.getTransfers():

Incoming Transfers
const incoming = await account.getTransfers({ direction: 'incoming' })
console.log('Incoming transfers:', incoming)

You can retrieve outgoing transfers with a custom limit using account.getTransfers():

Outgoing Transfers
const outgoing = await account.getTransfers({
  direction: 'outgoing',
  limit: 5
})
console.log('Outgoing transfers:', outgoing)

Paginate Results

You can paginate through transfer history using the limit and skip options in account.getTransfers():

Paginate Transfers
const page = await account.getTransfers({
  direction: 'all',
  limit: 20,
  skip: 10
})
console.log('Transfers 11-30:', page)

Check Transaction Receipts

You can check whether a specific transaction has been confirmed using account.getTransactionReceipt():

Get Transaction Receipt
const receipt = await account.getTransactionReceipt('abc123...')
if (receipt) {
  console.log('Transaction confirmed')
}

Next Steps

Learn how to sign and verify messages.

On this page