List Wallet Transactions

Lists wallet transactions in the authenticated merchant user's scope. All supplied filters are combined with AND.

Deposit whitelist

Deposit records carry whiteListStatus, the deposit-whitelist gate state: init / pending / approved / rejected (lowercase). Non-deposit transactions may return null or omit it. creditStatus travels with it and is the spendability signal.

Filter on the whiteListStatus query parameter to build the work queue:

Filter	Gives you
`whiteListStatus=init`	Deposits waiting for payer details to be submitted for the first time
`whiteListStatus=rejected`	Deposits whose review was rejected and must be resubmitted
`whiteListStatus=pending`	Deposits currently under review — nothing for you to do
`whiteListStatus=approved`	Deposits that cleared the gate

Submit details with POST /v1/wallet/deposit-whitelist/transactions/{transactionId}/submit, and read one transaction with GET /v1/wallet/transaction/detail.

GET /v1/wallet/deposit-whitelist/pending-list was removed. This endpoint plus whiteListStatus replaces it.

Whether the funds are spendable is not answered by the order status here — see GET /v1/wallet/transaction/detail (creditStatus) or GET /v1/wallet/asset-balance.

Guide: Wallet · Deposit whitelist

API Key

Add parameter in header

API-KEY

Example:

API-KEY: ********************

API Key

Add parameter in header

API-SIGNATURE

Example:

API-SIGNATURE: ********************

API Key

Add parameter in header

API-TIMESTAMP

Example:

API-TIMESTAMP: ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 0,
    "code": "string",
    "msg": "string",
    "traceId": "string",
    "success": true,
    "data": {
        "pageNumber": 1,
        "pageSize": 10,
        "totalPage": 3,
        "totalRow": 27,
        "records": [
            {
                "transactionId": "20573580428712136704",
                "requestId": "b0f4c6a2-7d51-4c0e-9a2f-6f7a1c2d3e45",
                "walletId": 123,
                "transactionType": "DEPOSIT",
                "status": "PROCESSING",
                "whiteListStatus": "init",
                "creditStatus": "PENDING",
                "failMessage": "",
                "currency": "USDC",
                "amount": "100.00",
                "fee": "0.50",
                "network": "BSC",
                "fromAddress": "0x3a1F8C4e2b6C8c9D7fE2B8b5a1d3C9A0bE12F345",
                "toAddress": "0x9dE4a1B7c2F80e5A3b6C1d9E7f0A2b4C6d8E0F13",
                "memo": "",
                "blockchainHash": "0x9c1a...f3",
                "createTime": "2026-09-08T09:12:00Z",
                "completeTime": ""
            }
        ]
    }
}

List Wallet Transactions

Deposit whitelist#

Request

Request Code Samples

Responses

Deposit whitelist