交易
发送市价交易接口
接口信息
请求方法：POST
请求路径：/v1/thirdParty/tx/sendSwapOrder
Content-Type：application/json
请求参数
chain
string
是
链名称，枚举为solana/bsc/base/eth
assetsId
string
是
用户assetsId，用于标识用户
inTokenAddress
string
是
输入代币地址
outTokenAddress
string
是
输出代币地址
inAmount
string
是
输入金额，使用代币的最小精度，例如代币精度为6，则交易1个代币输入为1000000
swapType
string
是
交易类型，枚举为buy/sell
gas
string
否
Solana Gas费用，Solana链时为必填，单位为lamports
extraGas
string
否
EVM链 额外Gas费用，bsc/eth/base链时为必填，将于网络基础费之上额外增加对应费用，单位为wei
slippage
string
是
滑点（百分比) 单位bps，即10000为100%
useMev
boolean
是
是否开启MEV保护，true开启，false关闭
autoSlippage
boolean
否
是否启用自动滑点，默认false，开启后将不再使用slippage字段
autoGas
string
否
自动gas，不传则使用自定义配置gas或extraGas，传入将使用对应挡位的gas消耗，枚举：low/average/high
autoSellConfig
[]AutoSellConfig
否
传入后将启用自动卖出
AutoSellConfig字段说明：
查阅自动排除配置介绍
AutoSellConfig为以下结构体的数组
priceChange
string
价格变化百分比，单位bps，即100%为10000，比如涨50%止盈，则传5000，跌90%止损，则传-9000;移动止盈止损时为回撤比例，如回撤10%，则传1000
sellRatio
string
卖出资金比例， 单位bps，即100%为100000，比如卖50%买入数量为5000
type
string
自动卖出模式，枚举为default/trailing
请求示例
AutoSellConfig为以下结构体的数组
priceChange
string
价格变化百分比，单位bps，即100%为10000，比如涨50%止盈，则传5000，跌90%止损，则传-9000;移动止盈止损时为回撤比例，如回撤10%，则传1000。 止盈时，参数区间为(0,+∞) 止损时，参数区间为(-10000,0) 移动止盈止损时，参数区间为(0,10000]
sellRatio
string
卖出资金比例， 单位bps，即100%为100000，比如卖50%买入数量为5000
type
string
自动卖出模式，枚举为default/trailing
响应参数
status
int
状态码
msg
string
响应消息
data
object
响应数据
data字段说明：
id
string
订单ID
响应示例
发送限价交易接口
接口信息
请求方法：POST
请求路径：/v1/thirdParty/tx/sendLimitOrder
Content-Type：application/json
请求参数
chain
string
是
链名称，枚举为solana/bsc/base/eth
assetsId
string
是
用户资产id，用于标识用户
inTokenAddress
string
是
输入代币地址
outTokenAddress
string
是
输出代币地址
inAmount
string
是
输入金额，使用代币的最小精度，例如代币精度为6，则交易1个代币输入为1000000
swapType
string
是
交易类型，枚举为buy/sell
gas
string
否
Solana Gas费用，Solana链时为必填，单位为lamports
extraGas
string
否
EVM链 额外Gas费用，bsc/base/eth链时为必填，将于网络基础费之上额外增加对应费用，单位为wei
slippage
string
是
滑点（百分比) 单位bps，即10000为100%
useMev
boolean
是
是否开启MEV保护，true开启，false关闭
limitPrice
string
是
挂单价，单位为USD
expireTime
string
否
设置超时时间，单位秒，比如设置1小时超时，则输入3600，最大值604800（7天），不传默认604800
autoSlippage
boolean
否
是否启用自动滑点，默认false，启用后将不再使用slippage字段的设置
autoGas
string
否
自动gas，不传则使用自定义配置gas或extraGas，传入将使用对应挡位的gas消耗，枚举：low/average/high
请求示例
响应参数
status
int
状态码
msg
string
响应消息
data
object
响应数据
data字段说明：
id
string
订单ID
响应示例
取消限价交易接口
接口信息
请求方法：POST
请求路径：/v1/thirdParty/tx/cancelLimitOrder
Content-Type：application/json
请求参数
chain
string
是
链名称，枚举为solana/bsc/base/eth
ids
[]string
是
订单id数组
请求示例
响应参数
status
int
状态码
msg
string
响应消息
data
[]string
已经成功取消的订单ID
响应示例
查询市价单交易记录接口
接口信息
请求方法：GET
请求路径：/v1/thirdParty/tx/getSwapOrder?chain={chain}&ids={ids}
请求参数
chain
string
是
链名称，枚举为solana/bsc/base/eth
ids
string
是
订单Id, 多个订单以逗号","分割
响应参数
status
int
状态码
msg
string
响应消息
data
object
已经成功取消的订单ID
data字段说明
data为以下结构体的数组
id
string
订单id
status
string
交易状态, 枚举为generated已生成/sent交易已发送/confirmed上链成功/error失败
chain
string
链名称，枚举为solana/bsc/base/eth
swapType
string
交易类型，枚举为buy/sell
txPriceUsd
string
成交价，单位为USD
txHash
string
交易hash
inAmount
string
输入token数量
outAmount
string
输出token数量
errorMessage
string
错误消息
响应示例
查询限价单交易记录接口
接口信息
请求方法：GET
请求路径：/v1/thirdParty/tx/getLimitOrder?chain={chain}&assetsId={assetsId}&status={status}&token={token}&pageSize={pageSize}&pageNo={pageNo}
请求参数
chain
string
是
链名称，枚举为solana/bsc/base/eth
assetsId
string
是
用户资产id，用于标识用户
status
string
否
限价单交易状态，枚举为waiting挂单中/confirmed上链成功/error失败/auto_cancelled自动取消/cancelled取消,不传则返回全部状态
token
string
否
代币地址
pageSize
string
是
分页单页数据量
pageNo
string
是
分页页码，第一页从0开始
响应参数
status
int
状态码
msg
string
响应消息
data
object
响应数据
data字段说明
data为以下结构体的数组, 根据挂单时间倒序排列
id
string
订单id
status
string
交易状态，枚举为generated已生成/waiting挂单中/sent交易已发送/confirmed上链成功/error失败/auto_cancelled自动取消/cancelled取消
chain
string
链名称
swapType
string
交易类型，枚举为buy/sell/takeprofit/stoploss/trailing,即挂单买/挂单卖/止盈/止损/移动止盈止损
inTokenAddress
string
输入代币地址
outTokenAddress
string
输出代币地址
txPriceUsd
string
成交价，单位为USD
txHash
string
交易hash
errorMessage
string
错误消息
limitPrice
string
挂单价，单位为USD
createPrice
string
创建挂单时价格，单位为USD
expireAt
string
过期时间的时间戳，单位为秒
inAmount
string
输入token数量
outAmount
string
输出token数量
trailingPriceChange
string
移动止盈止损回撤价格比例
autoSellTriggerHash
string
触发自动卖出的原交易哈希，在止盈/止损/移动止盈止损时生效
响应示例
发送授权交易接口
授权该token的spender合约，将由后端自动匹配到需要授权到的spender合约，并授权最大数量，即uint256(-1)
接口信息
请求方法：POST
请求路径：/v1/thirdParty/tx/approve
Content-Type：application/json
请求参数
chain
string
是
链名称，枚举为bsc/base/eth
assetsId
string
是
用户assetsId，用于标识用户
tokenAddress
string
是
输入代币地址
请求示例
响应参数
status
int
状态码
msg
string
响应消息
data
object
响应数据
data为以下结构体的数组
id
string
订单ID
spender
string
spender合约地址
amm
string
spender合约对应amm类型
响应示例
查询授权交易接口
接口信息
请求方法：GET
请求路径：/v1/thirdParty/tx/getApprove?chain={chain}&ids={ids}
请求参数
chain
string
是
链名称，枚举为bsc/base/eth
ids
string
是
订单Id, 多个订单以逗号","分割
响应参数
status
int
状态码
msg
string
响应消息
data
object
响应数据
data为以下结构体的数组
id
string
订单id
status
string
交易状态, 枚举为generated已生成/sent交易已发送/confirmed上链成功/error失败
chain
string
链名称，枚举为bsc/base/eth
spender
string
spender合约地址
token
string
token地址
txHash
string
交易hash
errorMessage
string
错误消息
响应示例
附录1 自动卖出配置介绍
type类型解释： default：一般止盈止损，作用于价格上涨或下跌到指定比例后触发挂单 trailing：移动止盈止损, 作用于价格上涨后回调到指定比例后触发挂单
可以配置多条一般止盈止损规则, 最多十条一般止盈止损。
只能配置最多一条移动止盈止损规则。
每次交易附带的规则只作用于当次交易。
卖出百分比为当次买入交易获得代币数量的百分比
如果通过手动卖出或自动卖出卖光所有代币, 该代币的其他卖出挂单将被自动取消。
如果卖出挂单触发时, 代币余额小于挂单金额, 挂单将卖出剩余所有代币。
自动卖出将默认卖出为每笔交易买入时用的底池代币。
一般止盈止损单在限价单查询时会显示成买卖限价单类型。
止盈止损示例: 假设买入100枚代币FOO, 传入三个自动卖出配置
将同时生成三笔卖出挂单
当触发止损-50%时, 卖出全部买入金额, 即100 FOO。
当触发止盈50%时, 卖出50%的买入金额, 即50 FOO。
当触发止盈100%时, 卖出50%的买入金额, 即50 FOO。
移动止盈止损示例: 假设买入代币FOO, 买入价格为 $100，传入一个自动卖出配置，回调10%时卖出100%
如果价格从$100下跌10%至$90, 移动止盈止损卖出订单将被触发并转换为卖出订单。 如果价格上升至$200, 然后下跌8%至$184, 移动止盈止损卖出订单将不会被触发。 如果价格上升至$300, 然后下跌10%至$270, 移动止盈止损卖出订单将被触发并转换为卖出订单。
Last updated