Skip to content

获取钱包流水记录 (Get Wallet Action Log)

获取当前会员的钱包资金流转记录,包含转账、扣款、充值、兑换等流水日志。支持基于交易类型、币种和时间的过滤筛选,以及分页查询。

接口说明

  • 接口地址: /client/member/wallet-log
  • 请求方式: POST
  • 内容类型: application/json
  • 认证方式: Bearer Token (需在 Header 中传递有效的 Authorization: Bearer <token>)

请求头 (Headers)

参数名必填类型说明
AuthorizationStringBearer Token,通过 会员登录 接口获取

请求参数

采用 JSON 格式发送请求参数 (application/json)。

字段名类型必填说明
pagenumber当前页码,例如 1
pageSizenumber每页显示的记录数,例如 10
transTypestring交易类型,例如 exchange_in, exchange_out, manual_adjust
currencystring币种过滤,例如 USD
startTimestring筛选的开始时间,格式:YYYY-MM-DD HH:mm:ss
endTimestring筛选的结束时间,格式:YYYY-MM-DD HH:mm:ss

请求示例

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

响应示例

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"
}

响应参数说明

字段名类型说明
codenumber状态码,0 表示成功
dataobject包含分页信息和数据列表的对象
data.listarray钱包流水记录列表
data.totalnumber满足条件的总记录数
data.pagenumber当前页码
data.pageSizenumber每页大小
data.list[].transTypestring交易类型
data.list[].currencystring变动币种
data.list[].amountnumber变动金额 (正数为增加,负数为减少)
data.list[].beforeBalancenumber变动前余额
data.list[].afterBalancenumber变动后余额
data.list[].relatedCurrencystring相关币种(仅在兑换时存在)
data.list[].exchangeRatenumber汇率(仅在兑换时存在)
data.list[].remarkstring备注说明
data.list[].createdAtstring记录创建时间(ISO 8601格式)
msgstring响应消息提示