bitcoin_transactions
Fetch the complete transaction history for any Bitcoin wallet address, including timestamps, amounts, and transaction IDs, with pagination support.
Instructions
Used to fetch the full transaction history of a Bitcoin wallet. Required: address - The Bitcoin address to query transactions for. Optional: pageSize - Number of results per page (default: 10). Optional: pageNumber - Page number for pagination (default: 0, first page). Returns comprehensive transaction details including timestamps, amounts, and transaction IDs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | The Bitcoin address to get transaction history for. Must be a valid Bitcoin address. | |
| pageSize | No | Number of transactions to return per page. Default is 10, maximum is 100. | |
| pageNumber | No | Page number for pagination, starting from 0. Default is 0. |
Implementation Reference
- src/services/BitcoinService.ts:70-123 (handler)Implementation of the "bitcoin_transactions" tool, including registration, input schema definition, and the handler function.
server.tool( "bitcoin_transactions", "Used to fetch the full transaction history of a Bitcoin wallet.\n" + "Required: address - The Bitcoin address to query transactions for.\n" + "Optional: pageSize - Number of results per page (default: 10).\n" + "Optional: pageNumber - Page number for pagination (default: 0, first page).\n" + "Returns comprehensive transaction details including timestamps, amounts, and transaction IDs.", { address: z .string() .describe( "The Bitcoin address to get transaction history for. Must be a valid Bitcoin address." ), pageSize: z .number() .optional() .default(10) .describe( "Number of transactions to return per page. Default is 10, maximum is 100." ), pageNumber: z .number() .optional() .default(0) .describe( "Page number for pagination, starting from 0. Default is 0." ), }, async (params) => { try { const response = await goldRushClient.BitcoinService.getTransactionsForBtcAddress( { address: params.address, pageSize: params.pageSize, pageNumber: params.pageNumber, } ); return { content: [ { type: "text", text: stringifyWithBigInt(response.data), }, ], }; } catch (error) { return { content: [{ type: "text", text: `Error: ${error}` }], isError: true, }; } } );