> ## Documentation Index > Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Wallet Transaction History > Query wallet deposit/withdraw transaction history ## OpenAPI ````yaml post /api/v2.1/fincard/virtual/wallet/v2/transaction openapi: 3.1.0 info: title: Business BFF API version: 1.0.0 description: Backend for Frontend - Business Panels Orchestration Layer servers: - url: https://sandbox.finhub.cloud description: Sandbox Environment security: [] tags: - name: AML description: Anti-Money Laundering checks and transaction monitoring - name: Admin - Consent Management description: Operations for managing consent templates and definitions - name: B2B Customer - Organization description: B2B organization registration and management - name: B2C Customer - Individual description: Individual customer registration and lifecycle management - name: BFF Admin - Tenant Initialization description: Lazy tenant initialization for fast startup - name: Catalog Hierarchy description: Hierarchical catalog management APIs - name: Catalog-Process Mapping description: APIs for catalog-process relationship management - name: Consent description: Payment consent creation and approval - name: Draft Management - name: External Events description: Kafka-to-HTTP bridge event ingestion and query - name: FinCard Virtual - Webhooks description: FinCard Virtual Card Webhook receiver - name: FinCard Virtual Account description: FinCard Virtual Card Account API proxy - name: FinCard Virtual Card Holder description: FinCard Virtual Card Holder API proxy - name: FinCard Virtual Cards description: FinCard Virtual Card API proxy - name: FinCard Virtual Common description: FinCard Virtual Card Common API proxy - name: FinCard Virtual Wallet description: FinCard Virtual Card Wallet API v2 proxy - name: FinTrans - Operations description: Financial transaction operations - name: Internal Webhooks description: Internal service-to-service webhook trigger (HMAC-secured) - name: MFE Preload description: MFE preload endpoints for SSR optimization - name: MFE Registry description: MFE Registry management endpoints - name: Payment Consent Management description: Operations for managing payment consents and validation - name: Person description: Person details for process context - name: Products description: Product Catalog Management API - name: Reference Data description: Shared reference data (countries, etc.) - name: Tenant Lifecycle description: Tenant mode transitions and lifecycle management - name: Tenant Registration description: Self-registration and tenant onboarding - name: Transfers description: Transfer prepare/execute aliases for muse-proxy compatibility - name: Verification description: Customer verification (KYC/KYB/AML) management - name: Wallet description: Wallet operations and balance management - name: Webhooks description: Webhook subscription and delivery management paths: /api/v2.1/fincard/virtual/wallet/v2/transaction: post: tags: - FinCard Virtual Wallet summary: Wallet Transaction History description: Query wallet deposit/withdraw transaction history parameters: - description: User agent name: User-Agent in: header schema: type: string - description: Forwarded for name: X-Forwarded-For in: header schema: type: string - $ref: '#/components/parameters/XForwardedFromHeader' - description: Tenant ID name: X-Tenant-ID in: header schema: type: string - description: Device ID name: deviceId in: header schema: type: string - description: Platform name: platform in: header schema: type: string requestBody: description: Wallet transaction request content: application/json: schema: $ref: '#/components/schemas/WalletTransactionRequest' required: true responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/WalletTransactionResponse' '400': description: Bad request '500': description: Internal server error components: parameters: XForwardedFromHeader: name: X-Forwarded-From in: header required: true description: Client application identifier schema: type: string example: client-app schemas: WalletTransactionRequest: type: object description: Wallet transaction history request properties: coinKey: type: string description: Coin key (optional) coinName: type: string description: Coin name (optional) txHash: type: string description: Transaction hash (optional) sourceAddress: type: string description: Source address (optional) destinationAddress: type: string description: Destination address (optional) orderNo: type: string description: Order number (optional) transactionType: type: string description: 'Transaction type: DEPOSIT, WITHDRAW' transactionStatus: type: string description: 'Transaction status: wait_process, processing, success, fail' startTime: type: integer format: int64 description: Start time (milliseconds). Range cannot exceed 90 days. endTime: type: integer format: int64 description: End time (milliseconds). Range cannot exceed 90 days. pageNum: type: integer format: int32 description: Current page. Default is 1 default: 1 pageSize: type: integer format: int32 description: Page size. Default 10, maximum 100 default: 10 searchTerm: type: string description: Search term (optional) WalletTransactionResponse: type: object description: Wallet transaction response properties: success: type: boolean examples: - true description: Success flag example: true code: type: integer format: int32 examples: - 200 description: Response code example: 200 msg: type: string examples: - Success description: Response message example: Success data: $ref: '#/components/schemas/WalletTransactionListData' type: object description: Wallet transaction data WalletTransactionListData: type: object description: Wallet transaction data properties: total: type: integer format: int64 examples: - 500 description: Total count example: 500 pageNum: type: integer format: int32 examples: - 1 description: Page number example: 1 pageSize: type: integer format: int32 examples: - 10 description: Page size example: 10 records: type: array items: $ref: '#/components/schemas/WalletTransactionData' description: Wallet transaction records WalletTransactionData: type: object description: Wallet transaction data properties: orderNo: type: string description: Transaction order number coinKey: type: string description: Coin key block: type: integer format: int32 description: Block Height sourceAddress: type: string description: Source address destinationAddress: type: string description: Destination address txHash: type: string description: Tx hash transactionHash: type: string description: Transaction hash (BFF alias for txHash) txAmount: type: number description: On-chain transaction amount transactionTime: type: integer format: int64 description: Transaction time on the chain. Millisecond timestamp confirmTime: type: integer format: int64 description: Transaction confirmation time on the chain. Millisecond timestamp coinName: type: string description: Coin name feeRate: type: number description: 'Platform fee rate. Example: 1 = 1%' fee: type: number description: Platform fee rate amount fixedFee: type: number description: Platform Fixed fee amount receivedAmount: type: number description: >- Received amount type = DEPOSIT: Amount deposit after deducting platform fees; type = WITHDRAW: Amount withdraw after deducting platform fees; receivedCurrency: type: string description: Received currency type: type: string description: Type DEPOSIT WITHDRAW status: type: string description: >- Status wait_process: Pending; processing: Processing; success: Success; fail: Failed; message: type: string description: Remark createTime: type: integer format: int64 description: Order create time. Millisecond timestamp updateTime: type: integer format: int64 description: Order update time. Millisecond timestamp transactionId: type: string description: Transaction ID (BFF extension - maps to orderNo) addressId: type: string description: Address ID (BFF extension) accountId: type: string description: Account ID (BFF extension) chainKey: type: string description: Chain key (BFF extension) blockHash: type: string description: Block hash (BFF extension) blockNumber: type: integer format: int64 description: Block number (BFF extension) blockHeight: type: integer format: int64 description: Block height (BFF extension) transactionType: type: string description: Transaction type (BFF extension) transactionStatus: type: string description: Transaction status (BFF extension) amount: type: number description: Amount (BFF extension) feeAmount: type: number description: Fee amount (BFF extension) confirmations: type: integer format: int32 description: Confirmations (BFF extension) requiredConfirmations: type: integer format: int32 description: Required confirmations (BFF extension) fromAddress: type: string description: From address (BFF extension) toAddress: type: string description: To address (BFF extension) memo: type: string description: Memo/Tag (BFF extension) blockTime: type: integer format: int64 description: Block time (BFF extension) description: type: string description: Description (BFF extension) isInternal: type: boolean description: Is internal transaction (BFF extension) isWatchOnly: type: boolean description: Is watch only (BFF extension) explorerUrl: type: string description: Explorer URL (BFF extension) network: type: string description: Network (BFF extension) ````