/app/fiatsettlementhistory

查询法币结算/对账历史

本接口用于查询指定用户(或您平台所有用户)的法币充值与提现历史记录(可支持法币对账)。

翻页参数和日期查询参数规范可以参考tradehistory接口的参数说明

结算状态说明

状态说明
pending用户已提交请求,待 Legend 财务团队审核处理
in progressLegend 财务/运营团队正在处理中
settledLegend 财务团队已完成该笔法币充提处理
canceled请求已被取消
rejected结算请求已被拒绝(通常因合规或风控原因)

注意:状态流转顺序通常为 pending → in progress → settled,若中间环节出现问题则可能变为 canceled 或 rejected 状态。

参数说明

参数名类型默认值必填备注
uidstring选填用户ID,如果不填会返回该交易所所有用户的结算列表
settlement_idstring-选填结算ID
settlement_statusstring-选填结算状态:pending(待处理), settled(已结算), canceled(已取消), rejected(已拒绝), in progress(处理中)
limitint3210选填每页返回记录数量
offsetint320选填偏移量,offset=当前页码-1(当前页码>=1),第一页表示为(offset+1)
startdatestring选填开始时间,时间格式:Y-m-d\TH:i:s.u\Z,例如:2025-09-04T03:01:01.000000Z
enddatestring选填结束时间,时间格式:Y-m-d\TH:i:s.u\Z,例如:2025-09-04T03:01:01.000000Z
orderstring-选填排序方式:asc(升序), desc(降序)
referencestring-选填存放reference数据,可进行精准匹配查询
time_typestringcreated_at选填时间字段类型:created_at(创建时间) 或 updated_at(更新时间)

时间格式注意事项:

时间按created_at 查询

微秒部分必须是 6 位数字

时区必须是 Z(表示 UTC)

时间使用 24 小时制

月份和日期需要补零


返回值说明

字段名类型说明
settlement_idstring结算单唯一标识,用于跟踪和查询特定结算记录
created_atstring记录创建时间,格式为 ISO 8601(例如:2024-01-15T10:30:00Z
updated_atstring最后更新时间,格式为 ISO 8601,状态变更时自动更新
settlement_statusstring结算状态, 包含状态:'created','pending','settled','canceled','in progress','rejected','on hold'
typestring结算类型
destinationstring资金目的地,提现时为收款账户信息,充值时可能为空或显示入金账户
quantitystring加密货币结算数量,字符串格式,确保金额精度(例如:"1000.00"
assetstring法币币种,遵循 ISO 4217 标准(例如:USDEURGBP
referencestring参考信息,调用接口时传入的自定义标识,原样返回用于业务关联

注意:

  • 所有时间字段均返回 UTC 时区的 ISO 8601 格式
  • 金额与数量字段均以字符串类型返回,避免浮点数精度问题
  • 结算状态变更会同时更新 updated_at 时间戳

Query Params
string

选填,如果uid不填,会返回该交易所的所有用户的settlement list. 用下面参数进行分页显示。

string

settlement_id

string
enum

结算状态,不传递查询全部

Allowed:
string
Defaults to 10
string
Defaults to 0

offset=当前页码-1(当前页码>=1). 第一页表示为(offset+1)。

string
Defaults to 2025-09-04T03:01:01.000000Z

filter: start time 开始时间,时间格式为:Y-m-d\TH:i:s.u\Z

string
Defaults to 2025-09-04T03:01:01.000000Z
string
Defaults to desc

asc or desc 排序: 取值 asc--升序, desc--降序

string

存放reference数据,在这里可进行精准匹配查询。

string
Defaults to created_at

按时间查询或排序的时间字段,取值:created_at或updated_at. 不填默认:created_at.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json