/balance-update

用户账户余额(包含法币和数字币)变动通知交易所接口(需要交易所实现)


请求体参数说明

参数名类型必传说明示例值
uidstring用户在交易所的唯一标识符yrhOPvsbAE6vDjnmuJYl
assetstring发生余额变动的资产名称(法币或数字货币)USD
groupstring变动分组:trade(交易)settlement(结算)settlement
categorystring变动类型:
group=trade 时:buy(买入), sell(卖出)
group=settlement 时:参见 Settlement Category 结算分类
WIRE_SENT
amount_changestring变动金额(数值,字符串格式确保精度)50
amount_beforestring变动前的账户余额(数值,字符串格式确保精度)0
amount_afterstring变动后的账户余额(数值,字符串格式确保精度)50
created_atstring变动发生的时间(ISO 8601 格式)2024-01-15T10:30:00Z
reference_idstring关联的业务ID:
group=trade:对应 trade_id
group=settlement:对应 settlement_id(UUID 格式)
987ddf77-a9ad-4bd3-a1f5-bc07ea1e7216
referencestring自定义参考信息,原样返回,长度不超过 255 字符user_ref_123

说明

  • 所有金额字段均使用字符串类型,避免浮点数精度问题
  • reference_id 用于关联具体的交易或结算记录,请确保与业务系统中的ID一致
  • 时间字段需使用 ISO 8601 标准格式(UTC 时区)
Responses

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