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():
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():
const incoming = await account.getTransfers({ direction: 'incoming' })
console.log('Incoming transfers:', incoming)You can retrieve outgoing transfers with a custom limit using account.getTransfers():
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():
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():
const receipt = await account.getTransactionReceipt('abc123...')
if (receipt) {
console.log('Transaction confirmed')
}Next Steps
Learn how to sign and verify messages.