EVM(BSC/ETH/Base)交易API
交易步骤
客户端本地授权inToken给交易Router合约(主币除外)
合约地址可通过询价接口查询,从response的spender字段获取需要授权的合约地址
调用构造交易API,API将会使用最佳路由返回构造交易所需的参数
客户端本地进行交易拼装和签名,建议使用EIP-1559标准进行交易拼装并签名
调用发送交易API或自行发送交易至链上
签名交易教程 https://docs.ethers.org/v6/api/providers/#Signer-signTransaction
ethers js库 https://github.com/ethers-io/ethers.js
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
响应示例:
交易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