Skip to content

Get Wallet Action Log

Retrieve the wallet action log of the current member, including transaction history such as transfers, deductions, deposits, and exchanges. The API supports filtering by transaction type, currency, time range, and provides pagination.

Interface Description

  • Interface path: /client/member/wallet-log
  • Request method: POST
  • Content type: application/json
  • Authentication: Bearer Token (requires passing valid Authorization: Bearer <token> in Header)

Request Headers

Parameter NameRequiredTypeDescription
AuthorizationYesStringBearer Token, obtained through the Member Login interface

Request Parameters

Request parameters are sent in JSON format (application/json).

Field NameTypeRequiredDescription
pagenumberYesCurrent page number, e.g., 1
pageSizenumberYesNumber of records per page, e.g., 10
transTypestringNoTransaction type, e.g., exchange_in, exchange_out, manual_adjust
currencystringNoCurrency filter, e.g., USD
startTimestringNoStart time for filtering, format: YYYY-MM-DD HH:mm:ss
endTimestringNoEnd time for filtering, format: YYYY-MM-DD HH:mm:ss

Request Example

json
{
  "page": 1,
  "pageSize": 10,
  "transType": "exchange_in",
  "currency": "USD",
  "startTime": "2023-01-01 00:00:00",
  "endTime": "2023-12-31 23:59:59"
}

Response Example

json
{
  "code": 0,
  "data": {
    "list": [
      {
        "id": "60a7c9b8f1d2e3b4a5c6d7e8",
        "transType": "exchange_in",
        "currency": "USD",
        "amount": 100.5,
        "beforeBalance": 1500.0,
        "afterBalance": 1600.5,
        "relatedCurrency": "VND",
        "exchangeRate": 24000.0,
        "isMemberOperated": true,
        "remark": "Client Self Exchange",
        "createdAt": "2023-10-15T10:30:00Z"
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 10
  },
  "msg": "Success"
}

Response Parameters Description

Field NameTypeDescription
codenumberStatus code, 0 indicates success
dataobjectObject containing pagination information and the data list
data.listarrayList of wallet action records
data.totalnumberTotal number of records matching the criteria
data.pagenumberCurrent page number
data.pageSizenumberPage size
data.list[].transTypestringTransaction type
data.list[].currencystringCurrency involved in the transaction
data.list[].amountnumberTransaction amount (positive for increase, negative for deduction)
data.list[].beforeBalancenumberBalance before the transaction
data.list[].afterBalancenumberBalance after the transaction
data.list[].relatedCurrencystringRelated currency (only exists during an exchange)
data.list[].exchangeRatenumberExchange rate (only exists during an exchange)
data.list[].remarkstringRemark or description
data.list[].createdAtstringRecord creation time (ISO 8601 format)
msgstringResponse message prompt