Bithumb MCP Server

Instructions

Implementation Reference

• src/bitThumb/index.ts:222-238 (handler)

  The core handler function for the 'post_user_transactions' tool. It constructs parameters and calls the Bithumb info API endpoint 'user_transactions' to retrieve the member's transaction completion history.
  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:196-207 (registration)

  Registration of the 'post_user_transactions' tool in the MCP server, including name, description, and input schema definition.
  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-362 (handler)

  Dispatch handler in the MCP CallToolRequestSchema that invokes the bithumbApi.postUserTransactions method with parsed arguments.
  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 ); break;
• src/bitThumb/types/user-transactions.interface.ts:1-20 (schema)

  TypeScript interface defining the expected response structure for the postUserTransactions API call.
  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[]; }