EVM(BSC/ETH/Base)交易API

交易步骤

  1. 客户端本地授权inToken给交易Router合约(主币除外)

合约地址可通过询价接口查询,从response的spender字段获取需要授权的合约地址

  1. 调用构造交易API,API将会使用最佳路由返回构造交易所需的参数

  2. 客户端本地进行交易拼装和签名,建议使用EIP-1559arrow-up-right标准进行交易拼装并签名

  3. 调用发送交易API或自行发送交易至链上

签名交易教程 https://docs.ethers.org/v6/api/providers/#Signer-signTransactionarrow-up-right

ethers js库 https://github.com/ethers-io/ethers.jsarrow-up-right

API详情

构造交易

通过用户输入的入参,构造待签名的交易

接口信息:

  • 请求方法:POST

  • 请求路径:/v1/thirdParty/chainWallet/createEvmTx

  • Content-Type:application/json

请求参数:

参数名
类型
是否必须
说明

chain

string

链名称,枚举为bsc/eth/base

creatorAddress

string

交易发起地址

inAmount

string

输入金额,最小精度

inTokenAddress

string

输入代币地址 其中之一必须是主币或USDT

outTokenAddress

string

输出代币地址 其中之一必须是主币或USDT

swapType

string

交易类型,枚举为buy/sell

slippage

string

滑点(百分比) 单位bps,即10000为100%

feeRecipient

string

返佣地址

feeRecipientRate

string

否,如果设置了feeRecipient, 则feeRecipientRate为必填

返佣手续费比例,占交易金额的比例,最高不超过10%,单位bps,如1%即为100

autoSlippage

boolean

是否启用自动滑点,默认false,开启后将不再使用slippage字段

请求示例:

响应参数:

参数名
类型
说明

status

int

状态码

msg

string

响应消息

data

object

响应数据

data为以下结构体的数组

data字段说明:

参数名
类型
说明

chain

string

链名称,枚举为bsc/eth/base

creatorAddress

string

交易创建者地址,即from地址

swapType

string

交易类型

inTokenAddress

string

输入代币地址

outTokenAddress

string

输出代币地址

txContent

Object

交易内容,包含交易拼装用的data, to地址,value

slippage

string

滑点(百分比),单位bps

minReturn

string

最小返回数量

inAmount

string

输入数量

estimateOut

string

预估输出数量

gasLimit

string

交易gas limit

amms

string[]

AMM信息

createPrice

string

创建价格,单位USD

requestTxId

string

请求交易id

响应示例:

circle-info

交易Four.meme内盘时需要注意以下限制:

1. 买入

  • Fourmeme 内盘买入 没有交易限制

2. 卖出

  • 主币底池

    • 只能卖出为 主币

  • ERC20 底池

    • 只能卖出为 对应底池代币

  • (特殊)ERC20 稳定币底池(USDT / USDC / U)

    • 支持通过 V3 Manager 卖出为 主币

  • 卖出由于直接调用Four.meme合约,所以不支持返佣。

发送签名后的交易

通过用户输入的入参,发送签名后的交易

接口信息:

  • 请求方法:POST

  • 请求路径:/v1/thirdParty/chainWallet/sendSignedEvmTx

  • Content-Type:application/json

请求参数:

参数名
类型
是否必须
说明

chain

string

链名称,枚举为bsc/eth/base

requestTxId

string

请求交易id,通过构造交易接口获取

signedTx

string

签名后的交易,使用base64 encode之后的字串

useMev

bool

是否开启防夹

请求示例:

响应参数:

参数名
类型
说明

status

int

状态码

msg

string

响应消息

data

object

响应数据

data为以下结构体的数组

data字段说明:

参数名
类型
说明

hash

string

交易hash

err

string

链上返回的错误信息

响应示例:

Last updated