跳转至

对接流程

Builder 准备

  • 准备 builder 地址(用于归因与收取 builder fee),这个钱包地址需要有在Aster 注册,并且Aster 合约账户余额里至少有100 Aster。
  • 为每个用户生成一套 API Wallet / Agent(signer 地址 + 私钥),私钥由 Builder 后端安全保管(建议每用户独立 signer)。

用户授权 Agent(API Wallet)

  • 调用 POST /fapi/v3/approveAgent(用户主钱包签名)
  • 设置权限(现货/合约/提现)、IP 白名单、过期时间等。

用户授权 Builder(Builder地址和费率上限)

  • 调用 POST /fapi/v3/approveBuilder(用户主钱包签名)
  • 设置 maxFeeRate(builder 可收取的最大费率)。 注意:授权 Builder可以在授权Agent时一起授权,也可以在授权Agent后单独授权。

Builder 代用户下单

  • 用户发起下单
  • Builder 后端调用 POST /fapi/v3/order
  • 订单参数中携带 builder + feeRate
  • signer 私钥签名并发送请求。

后续维护

  • 更新 / 撤销 Agent:updateAgent / DELETE /agent
  • 更新 / 撤销 Builder:updateBuilder / DELETE /builder