/app/orderbyfiat

法币购买加密货币

用法币购买加密货币的接口。


查询参数说明

参数名类型必填默认值说明可选值/枚举
uidstring用户唯一标识符-
sidestringbuy交易方向buy, sell
pairstringUSDTUSD交易对(需大写)-
sizestring100交易规模(需符合交易规则)-
referencestring-参考信息(将在后续相关接口中原样返回,最长255字符)-
referral_uidstring-推荐人用户ID-
networkstringETH网络类型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的记录与识别,避免重复发起已成功的请求。

Query Params
string
required
Defaults to 380ee89d-8c44-48cf-b3d0-12a8663137de
string
required
Defaults to buy
string
required
Defaults to USDTUSD

必须使用大写字母的交易对格式。

string
required
Defaults to 100

交易数量必须符合交易规则。

string

存放reference数据,在后边相关接口会原样跟随这笔结算返回,最长不能查过255个字符。

string

推荐用户 ID

string
enum

网络

Allowed:
Responses

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