查询资金流水
查询一段时间内你的 USDT 余额变动,用于对账。
POST
/api/open/order/getFlows完整地址 = 接口地址 + 这个路径。接口地址在商户后台「开发者 → API 与回调」查看。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
merchantNo | string | 是 | 商户号 |
begin | string | 是 | 开始时间(包含),yyyy-MM-dd HH:mm:ss,UTC+8 |
end | string | 是 | 结束时间(不包含),最长 24 小时 |
flowType | int | 否 | 只查某种流水,见下表 |
orderNo | string | 否 | 只查某个平台订单号的流水 |
json
{ "merchantNo": "你的商户号", "begin": "2026-10-13 00:00:00", "end": "2026-10-14 00:00:00" }一次返回这段时间的全部流水(不分页),按时间倒序。数据多时请把时间段切小。
返回
| 字段 | 类型 | 说明 |
|---|---|---|
totalCount | int | 条数 |
items[].id | long | 流水编号 |
items[].flowType | int | 流水类型 |
items[].flowTypeText | string | 流水类型说明(英文) |
items[].quantity | number | 变动数量,正数是增加,负数是减少 |
items[].currency | string | 币种,USDT |
items[].postOn | string | 发生时间 |
items[].balance | number | 变动后可用余额 |
items[].freeze | number | 变动后冻结金额 |
items[].fees | number | 手续费 |
items[].orderNo | string | 关联的平台订单号 |
items[].remark | string | 备注 |
items[].isForceRelease | bool | 是否为强制释放 |
items[].operatorId | int | 操作人(平台后台操作时才有) |
常见流水类型
| flowType | 说明 |
|---|---|
| 0 | 手续费 |
| 1 | 入金 |
| 2 | 出金 |
| 3 | 充值 |
| 5 | 提币 |
| 15 | 冻结 |
| 16 | 解冻 |
| 17 | 提币手续费 |
| 22 | 出金驳回 |
| 23 | 出金取消 |
| 28 | 出金手续费 |
| 10 / 12 | 后台充值 / 后台扣除 |
| 36 / 37 | 冲正扣回 / 冲正退回 |
其他类型以 flowTypeText 为准。
常见错误
40000:没传时间段、结束时间不晚于开始时间、或超过 24 小时(message 会说明)。