post_user_transactions
Retrieve a user's transaction history on Bithumb exchange to track buys, sells, deposits, and withdrawals for specific cryptocurrencies.
Instructions
Get member's transaction completion history (Private)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| searchGb | Yes | Search type (0: all, 1: buy complete, 2: sell complete, 3: withdrawal processing, 4: deposit, 5: withdrawal complete, 9: KRW deposit) | |
| orderCurrency | Yes | Cryptocurrency symbol (e.g. BTC, ETH) | |
| offset | No | Start index for retrieval (optional) | |
| count | No | Number of transactions to retrieve (optional, default: 20) |
Implementation Reference
- src/bitThumb/index.ts:222-238 (handler)Core handler function implementing the logic to fetch user transaction history via Bithumb's private API.
public async postUserTransactions( searchGb: number, orderCurrency: string, offset?: number, count?: number, ): Promise<IPostUserTransactions> { const param = { searchGb, order_currency: orderCurrency, offset, count, }; const res = <IPostUserTransactions>( await this.requestInfo('user_transactions', param) ); return res; } - src/index.ts:195-207 (registration)MCP tool registration defining the name, description, and input schema.
{ name: 'post_user_transactions', description: 'Get member\'s transaction completion history (Private)', inputSchema: { type: 'object', properties: { searchGb: { type: 'number', enum: [0, 1, 2, 3, 4, 5, 9], description: 'Search type (0: all, 1: buy complete, 2: sell complete, 3: withdrawal processing, 4: deposit, 5: withdrawal complete, 9: KRW deposit)' }, orderCurrency: { type: 'string', description: 'Cryptocurrency symbol (e.g. BTC, ETH)' }, offset: { type: 'number', description: 'Start index for retrieval (optional)' }, count: { type: 'number', description: 'Number of transactions to retrieve (optional, default: 20)' } }, required: ['searchGb', 'orderCurrency'] } - src/index.ts:355-361 (handler)MCP server handler that routes the tool call to the BithumbApi instance.
case 'post_user_transactions': result = await this.bithumbApi.postUserTransactions( args.searchGb as number, args.orderCurrency as string, args.offset as number | undefined, args.count as number | undefined ); - TypeScript interfaces defining the structure of the response data for the tool.
import { IBithumbResponse } from './bithumb-response.interface.js'; interface IUserTransactions { search: string; transfer_date: number; order_currenecy: string; payment_currency: string; units: string; price: string; amount: string; fee_currency: string; fee: string; order_balance: string; payment_balance: string; } export interface IPostUserTransactions extends IBithumbResponse { data: IUserTransactions[]; }