BPN
  1. Wallet
BPN
  • Getting Started
    • Introduction to BPN
    • Key Concepts & Terminology
    • Architecture Overview
  • Onboarding & Prerequisites
    • Product Demo
    • Sandbox & Test Environment
  • Use Case
    • Transfer
    • Vault
    • On/Off Ramp
    • Compliance (Travel Rule Information Submission)
  • API Reference
    • KYB
      • Share KYB Info For Sub User
      • Get KYB Sub User Status
    • Account Management
      • add bank account
      • list bank account
      • create virtaul account
      • list virtual account
      • Master VA balance inquiry
      • list virtual account orders
      • refund virtual account order
    • Wallet
      • Get Asset Balance
        GET
      • Get Deposit Address
        GET
      • Add Deposit Sender
        POST
      • Add Withdraw Whitelist
        POST
      • Delete Withdraw Whiltelist
        POST
      • Request Withdraw
        POST
      • Query Transaction History
        GET
    • FX
      • fx inquery
    • BPN Transactions
      • get stablecoin quote
      • create stable order
      • get order (single) detail
      • list orders(batch)
    • Reconciliation
  • Webhooks & Event
    • resend fail webhook
      POST
    • KYB Status Notification
      POST
    • Transaction Status Notification
      POST
    • Account Status Notification
      POST
    • Open Virtual Account Status
      POST
    • Deposit Sender Detail Required
      POST
    • virtual account payment status
      POST
  • Appendix
    • Enum
    • Virtual Account(VA) Support List
  • Release Notes & Changelog
    • Version History
  • Schemas
    • Schemas
      • walletBalance
      • walletAddress
      • transactionRecord
  1. Wallet

Query Transaction History

GET
/v1/wallet/history

Request

Query Params

Responses

🟢200OK
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1/wallet/history?transactionId=txn_20250808120000123&hash=0x0a9f3c2d5b7e98c4e0f1a9b7c3d2e1f0a9f3c2d5b7e98c4e0f1a9b7c3d2e1f0&transactionCreateTimeFrom=1640995200000&transactionCreateTimeTo=1640995202000&transactionType&lackDepositSender&pageSize&pageNumber'
Response Response Example
{
    "status": "200",
    "code": null,
    "msg": null,
    "traceId": "Auto:bf288b9af2e04dff88e943f2dcaf2b03",
    "data": {
        "pageNumber": 1,
        "pageSize": 2,
        "totalPage": 1,
        "totalRow": 2,
        "records": [
            {
                "transactionId": "txn_20250808120000123",
                "userId": "100001121",
                "currency": "USDC",
                "walletId": "wlt_6f3a21d0",
                "amount": 1250.75,
                "fee": 1.25,
                "openBalance": 10000,
                "closeBalance": 8750,
                "transactionType": "withdraw",
                "subType": "ON_CHAIN",
                "status": "success",
                "orderReference": "ord_8a7f5e11",
                "channelOrderId": "chn_5d92c0b7",
                "description": "User withdrawal to external wallet",
                "blockchainHash": "0x0a9f3c2d5b7e98c4e0f1a9b7c3d2e1f0a9f3c2d5b7e98c4e0f1a9b7c3d2e1f0",
                "blockchainHashLink": "https://etherscan.io/tx/0x0a9f3c2d5b7e98c4e0f1a9b7c3d2e1f0a9f3c2d5b7e98c4e0f1a9b7c3d2e1f0",
                "network": "ETH",
                "memo": "",
                "fromAddress": "0x1234abcd5678ef901234abcd5678ef901234abcd",
                "toAddress": "0x9abcdef0123456789abcdef0123456789abcdef0",
                "createTime": "2025-08-08T11:58:00Z",
                "updateTime": "2025-08-08T12:00:00Z",
                "processTime": "2025-08-08T11:59:10Z",
                "completeTime": "2025-08-08T12:00:00Z",
                "cancelTime": ""
            },
            {
                "transactionId": "txn_20250808115900456",
                "userId": "100001121",
                "currency": "BTC",
                "walletId": "wlt_2a9b33c1",
                "amount": 0.015,
                "fee": 0.0001,
                "openBalance": 0.25,
                "closeBalance": 0.235,
                "transactionType": "deposit",
                "status": "pending",
                "orderReference": "ord_1f2e3d4c",
                "channelOrderId": "chn_7b61a2e4",
                "description": "Inbound transfer awaiting confirmations",
                "blockchainHash": "0xb1f3d9c0a7e6543210b1f3d9c0a7e6543210b1f3d9c0a7e6543210b1f3d9c0a7",
                "blockchainHashLink": "https://www.blockchain.com/explorer/transactions/btc/0xb1f3d9c0a7e6543210b1f3d9c0a7e6543210b1f3d9c0a7e6543210b1f3d9c0a7",
                "network": "BTC",
                "memo": "",
                "fromAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
                "toAddress": "bc1q9m2n3p4q5r6s7t8u9v0w1x2y3z4a5b6c7d8e9f",
                "createTime": "2025-08-08T11:59:00Z",
                "updateTime": "2025-08-08T11:59:00Z",
                "processTime": "",
                "completeTime": "",
                "cancelTime": ""
            }
        ]
    }
}
Modified at 2025-09-10 15:55:15
Previous
Request Withdraw
Next
fx inquery
Built with