获取钱包流水记录 (Get Wallet Action Log)
获取当前会员的钱包资金流转记录,包含转账、扣款、充值、兑换等流水日志。支持基于交易类型、币种和时间的过滤筛选,以及分页查询。
接口说明
- 接口地址:
/client/member/wallet-log - 请求方式:
POST - 内容类型:
application/json - 认证方式: Bearer Token (需在 Header 中传递有效的
Authorization: Bearer <token>)
请求头 (Headers)
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| Authorization | 是 | String | Bearer Token,通过 会员登录 接口获取 |
请求参数
采用 JSON 格式发送请求参数 (application/json)。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | number | 是 | 当前页码,例如 1 |
| pageSize | number | 是 | 每页显示的记录数,例如 10 |
| transType | string | 否 | 交易类型,例如 exchange_in, exchange_out, manual_adjust |
| currency | string | 否 | 币种过滤,例如 USD |
| startTime | string | 否 | 筛选的开始时间,格式:YYYY-MM-DD HH:mm:ss |
| endTime | string | 否 | 筛选的结束时间,格式: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"
}响应参数说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码,0 表示成功 |
| data | object | 包含分页信息和数据列表的对象 |
| data.list | array | 钱包流水记录列表 |
| data.total | number | 满足条件的总记录数 |
| data.page | number | 当前页码 |
| data.pageSize | number | 每页大小 |
| data.list[].transType | string | 交易类型 |
| data.list[].currency | string | 变动币种 |
| data.list[].amount | number | 变动金额 (正数为增加,负数为减少) |
| data.list[].beforeBalance | number | 变动前余额 |
| data.list[].afterBalance | number | 变动后余额 |
| data.list[].relatedCurrency | string | 相关币种(仅在兑换时存在) |
| data.list[].exchangeRate | number | 汇率(仅在兑换时存在) |
| data.list[].remark | string | 备注说明 |
| data.list[].createdAt | string | 记录创建时间(ISO 8601格式) |
| msg | string | 响应消息提示 |