组合查询用户财务记录
/sapi/v1/account/bill_record
请求类型: POST
是否验签: 是
接口权限: 读取
限频: 每个UID 3秒最多 144 次请求(交易接口3秒最多 72 次请求，查询接口3秒最多 72 次请求) (该UID的所有币种和不同到期日的合约的所有私有接口共享该限制) 。
接口描述: 该接口支持全仓模式和逐仓模式 请求参数contract支持交割合约代码调用，格式为：BTC-USDT-210625。
请求地址
线上环境（aws客户首选）
请求参数
contract
string
false
合约代码
支持大小写,"BTC-USDT" ...
mar_acct
string
true
保证金账户
USDT
BTC-USDT,"USDT"(查询全仓时使用)...
type
string
false
不填查询全部类型,【查询多类型中间用，隔开】
3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入;38:从其他保证金账户转入 ;39:转出到其他保证金账户 ;85（系统垫资账户-用户U本位账户（转出垫资账户)） ;86（用户U本位账户-系统垫资发放账户 (转入垫资账户)）
start_time
long
false
查询开始时间, 以数据按创建时间进行查询
取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time
long
false
查询结束时间, 以数据按创建时间进行查询
now
取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct
string
false
查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回
next
prev表示向前查询，next表示向后查询。
from_id
long
false
如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id
响应参数
code
int
true
状态码(由具体业务自定义)
msg
string
true
状态码对应的描述信息
ts
long
true
响应生成时间点，单位：毫秒
<data>
object array
true
字典类型
query_id
long
true
下次查询ID
id
long
true
ts
long
true
创建时间
asset
string
true
币种
USDT...
contract_code
string
true
合约代码
BTC-USDT...
margin_account
string
true
保证金账户
BTC-USDT,"USDT"...
face_margin_account
string
true
对手方保证金账户，仅在type交易类型为34、35、36、37、38、39时有值，其他类型为空字符串
BTC-USDT...
type
int
true
交易类型
3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入;38:从其他保证金账户转入 ;39:转出到其他保证金账户 ;85（系统垫资账户-用户U本位账户（转出垫资账户)） ;86（用户U本位账户-系统垫资发放账户 (转入垫资账户)）
amount
decimal
true
金额（计价货币）
</data>
false
请求示例
响应示例
最后更新于