post
https://sandboxapi.legendtrading.com/app/orderbyfiat
法币购买加密货币
用法币购买加密货币的接口。
查询参数说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 | 可选值/枚举 |
|---|---|---|---|---|---|
uid | string | 是 | 用户唯一标识符 | - | |
side | string | 是 | buy | 交易方向 | buy, sell |
pair | string | 是 | USDTUSD | 交易对(需大写) | - |
size | string | 是 | 100 | 交易规模(需符合交易规则) | - |
reference | string | 否 | - | 参考信息(将在后续相关接口中原样返回,最长255字符) | - |
referral_uid | string | 否 | - | 推荐人用户ID | - |
network | string | 否 | ETH | 网络类型 | ETH, ARB, MATIC, BASE, OP, XLM, SOL |
说明:
pair参数必须使用大写字母,且为用户支持的交易对size参数必须符合平台的交易规则限制reference字段最大长度不超过255个字符network参数指定交易发生的区块链网络,默认为ETH
备注
在购买加密货币的场景下,调用此接口将创建交易并扣减相应的法币余额。此扣减操作理论上会立即生效。
最佳实践建议:为保证状态一致性,建议在收到Webhook:trade-execute口返回
trade_status状态为succeeded后,再调用 fiatbalances API 查询最新的、已扣减后的法币余额。”
交易过程中触发的Webhook通知
- 用户交易发起通知
trade-notify - 用户交易结果通知
trade-execute(交易所可配置是否自动重试retry_trade_execute,默认不自动重试)
关于幂等操作
该接口采用reference字段作为唯一幂等标识。若请求成功,系统将记录该reference信息,后续所有使用相同reference的请求均无法再次处理,以确保操作的唯一性。
如因网络异常等原因未收到明确响应,可基于原参数重试,此时系统将依据reference执行去重校验,未入库的数据可正常处理。
建议在调用时做好reference的记录与识别,避免重复发起已成功的请求。
