转账

发送转账交易接口

转账钱包中的用户资产，只是适用于API创建的代理钱包(delegate类型)，不能转移用户自建钱包（self类型）资产

接口信息

• 请求方法：POST

• 请求路径：/v1/thirdParty/tx/transfer

• Content-Type：application/json

请求参数

参数名	类型	是否必须	说明
chain	string	是	链名称，枚举为bsc/solana/base/eth
assetsId	string	是	用户assetsId，用于标识用户
fromAddress	string	是	转账发起钱包地址
toAddress	string	是	转账接收钱包地址
tokenAddress	string	是	代币地址
amount	string	是	代币数量，需携带精度，比如转账1USDT，精度为18，则传递"1000000000000000000"
gas	string	否	Gas费用，solana链时需设置，单位为lamports
extraGas	string	否	额外Gas费用，evm链时需设置，将于网络基础费之上额外增加对应费用，单位为wei

请求示例

• EVM

{
  "chain": "bsc",
  "assetsId": "1cbac4a6674a419f88208b9f7b90cd45",
  "fromAddress": "0xa5e4ccf218cef628c85364253e5432d2cf18c87e",
  "toAddress": "0x2be4ccf218cef628c85364253e5432d2cf18fd21",
  "tokenAddress": "0x55d398326f99059ff775485246999027b3197955",
  "amount": "1000000000000000000",
  "extraGas": "1000000000"
}

• Solana

{
  "chain": "solana",
  "assetsId": "1cbac4a6674a419f88208b9f7b90cd45",
  "fromAddress": "2QfBNK2WDwSLoUQRb1zAnp3KM12N9hQ8q6ApwUMnWW2T",
  "toAddress": "BFTryQb7qro3uZaQuCMsBqXS8KNnQtWFgM3Zv3uZtF7U",
  "tokenAddress": "Fg2Z4usj7UU99XmWV7H7EYnY2LHS7jmvA1qZ9q7nbqvQ",
  "amount": "1000000000000000000",
  "gas": "10000000"
}

响应参数

参数名	类型	说明
status	int	状态码
msg	string	响应消息
data	object	响应数据

data字段说明：

data为以下结构体的数组

参数名	类型	说明
id	string	订单ID

响应示例

{
  "status": 200,
  "msg": "Success",
  "data": [
    {
      "id": "f50ddc7b87f04b538505cd3e6df6e78f"
    }
  ]
}

查询转账交易接口

接口信息

• 请求方法：GET

• 请求路径：/v1/thirdParty/tx/getTransfer?chain={chain}&ids={ids}

请求参数

参数名	类型	是否必须	说明
chain	string	是	链名称，枚举为solana/bsc/eth/base
ids	string	是	订单Id, 多个订单以逗号","分割

响应参数

参数名	类型	说明
status	int	状态码
msg	string	响应消息
data	object	响应数据

data字段说明：

data为以下结构体的数组

参数名	类型	说明
id	string	订单id
status	string	交易状态, 枚举为generated已生成/sent交易已发送/confirmed上链成功/error失败
chain	string	链名称，枚举为solana/bsc/base/eth
txHash	string	交易hash
errorMessage	string	错误消息

响应示例

{
  "status": 200,
  "msg": "Success",
  "data": [
    {
      "id": "f50ddc7b87f04b538505cd3e6df6e78f",
      "status": "confirmed",
      "chain": "solana",
      "txHash": "3BP18cjNaU4xpFpTsbZ688SEAuKNGaUJupTHpR7fhzB9bPEFQEYtUYT3JAJAB2aAg55t9DvU4LRZK4J92LUQ9beN",
      "errorMessage": ""
    }
  ]
}