post
https://exchange.com/api/balance-update
用户账户余额(包含法币和数字币)变动通知交易所接口(需要交易所实现)
请求体参数说明
| 参数名 | 类型 | 必传 | 说明 | 示例值 |
|---|---|---|---|---|
uid | string | 是 | 用户在交易所的唯一标识符 | yrhOPvsbAE6vDjnmuJYl |
asset | string | 是 | 发生余额变动的资产名称(法币或数字货币) | USD |
group | string | 是 | 变动分组:trade(交易)settlement(结算) | settlement |
category | string | 是 | 变动类型: • group=trade 时:buy(买入), sell(卖出)• group=settlement 时:参见 Settlement Category 结算分类 | WIRE_SENT |
amount_change | string | 是 | 变动金额(数值,字符串格式确保精度) | 50 |
amount_before | string | 是 | 变动前的账户余额(数值,字符串格式确保精度) | 0 |
amount_after | string | 是 | 变动后的账户余额(数值,字符串格式确保精度) | 50 |
created_at | string | 是 | 变动发生的时间(ISO 8601 格式) | 2024-01-15T10:30:00Z |
reference_id | string | 是 | 关联的业务ID: • group=trade:对应 trade_id• group=settlement:对应 settlement_id(UUID 格式) | 987ddf77-a9ad-4bd3-a1f5-bc07ea1e7216 |
reference | string | 否 | 自定义参考信息,原样返回,长度不超过 255 字符 | user_ref_123 |
说明:
- 所有金额字段均使用字符串类型,避免浮点数精度问题
reference_id用于关联具体的交易或结算记录,请确保与业务系统中的ID一致- 时间字段需使用 ISO 8601 标准格式(UTC 时区)
