SwapBox V1 接口文档

请求与返回

RESTFUL访问格式：

添加请求头 Content-Type: application/json;charset=UTF-8

接口地址：

https://api.v2.nabox.io/nabox-api

返回格式：

//成功示例
{
    "code": 1000,      //返回码，1000表示成功，其余表示失败
    "msg": "成功",     //返回信息
    "data": {         //返回数据
      "success":true
    }      
}
//错误示例
{
    "code": 1002,
    "msg": "语言类型错误",
    "data": null
}

接口详情

Swap Transactions

查询链配置

详细描述： 查询SwapBox当前支持的各条链的Swap配置信息，所有应用应该首先调用此接口获取链配置（链信息和资产信息），并缓存在本地。

访问：

url	method	说明
/swap/info	get	查询Swap配置信息

参数： 无

返回：

{
"chain": "Ethereum",      //链名称
"evmChainId": 1,          //EVM的ID
"chainId": 101,           //Nerve跨链系统给当前链分配的链ID
"chainType": 2,           //链类型：1:Nerve链，2:EVM链

"configs": {              //链的其他配置
    "multiCallAddress": "0x6899aa135037a4c8a3cab11622d35cea4cd63747",
    //批量查询合约地址
    "crossAddress": "0xc707e0854da2d72c90a7453f8dc224dd937d7e82",
    //跨链swap的中间账户
    "nft": "eth"     //是否支持NFT
},

"stableSwapAssetList": [      //稳定币sawp的token列表
  {
    "chain": "Ethereum",     //资产所属链
    "chainId": 101,          //资产所属链对应Nerve跨链系统的链id
    "assetId": 0,            //Nerve链给资产分配的资产id,每条链的代币assetId=1，
    "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    //token的合约地址
    "decimals": 6,           //资产小数位
    "symbol": "USDT",
    "channelInfo": {         //资产支持的swap渠道信息
        "iSwap": {           //iswap渠道信息
            "code": [
                "BIG",       //大额兑换
                "BRG",       //大额跨链桥
                "SWP"        //普通兑换
            ],
            "token": "USDT"  
        },
        "NERVE": {           //Nerve稳定币兑换渠道信息
            "pairAddress": "NERVEepb7WDfEU4ZKsEFmwCfGwCaYWgdHgk5tW",
                             //稳定币交易对合约地址
            "coinIndex": 0,  //当前资产对应的下标
            "lpChainId": 9,  //lp资产在Nerve链上对应的链id
            "lpAssetId": 220 //lp资产在Nerve链上对应的资产id
        }
    }
  }
]
      

查询订单详情

详细描述：通过订单ID查询SwapBox发起的Swap交易详情。

访问：

url	method	说明
/swap/tx/orderId	post	查询swap交易详情

参数：

参数名	类型	必填	描述
language	string	Y	语言：EN/CHS
orderId	string	Y	交易的订单ID

返回：

{
    "id": 232,
    "orderId": "25172d2b-bdb9-4dd3-8698-b5e0fe34ad97", //订单ID
    "channel": "NERVE",                                //兑换通道
    "platform": "NABOX",     //发起兑换平台
    "swapType": 2,           //兑换类型 1：普通兑换，2：稳定币兑换，3：大额兑换
    "fromChain": "Heco",     //发起链
    "fromAddress": "0xf8a8435f7a93c73862974e19865b7089707813F1",//发起地址
    "toChain": "BSC",        //兑换目标链
    "toAddress": "0xf8a8435f7a93c73862974e19865b7089707813F1",  //目标地址
    "chainId": 103,          //发起链资产对应的Nerve分配链ID
    "assetId": 0,            //发起链资产的资产ID，代币该值为1，Token合约资产为0
    "contractAddress": "0xa71edc38d189767582c38a3145b5873052c3e47a",
                             //发起链资产的token合约地址
    "decimal": 18,           //发起链资产小数位
    "symbol": "USDT",        //资产符号                         
    "swapChainId": 102,      //目标链资产对应的Nerve分配链ID
    "swapAssetId": 0,        //目标链资产的资产ID
    "swapContractAddress": "0x55d398326f99059ff775485246999027b3197955",
                             //目标链资产的token合约地址
    "swapDecimal": 18,       //目标链资产小数位
    "swapSymbol": "USDT"     //资产符号
         
    "txHash": "0x7ee9e904c0183ad248587ae20052ea99485762602b5077e88e3ebfe8c3d4e4f1",
                             //发起链的交易hash
    "nerveTxHash": "243d52b1d354fb7dbfc17b918cb0cbfe1e0441d1702b48d11c03758f96005896",
                             //Nerve链上做兑换处理的交易hash
    "crossTxHash": "0x72c0a9f93bd04df3f81fdfb59a8e7267e81c8df86c3d6b752b2034a5536be537",
                             //目标链地址接收到兑换币的交易hash
    "amount": "8.898993",    //发起链资产的数量
    "swapSuccAmount": "8.897193",  //目标链兑换成功的数量
    "swapFee": "0.001800",         //兑换收取的手续费(收取兑换资产)
    "crossFee": "0.049300",        //兑换的跨链手续费(收取发起链代币)
    "slippage": 0,                 //滑点
    "pairAddress": "NERVEepb7WDfEU4ZKsEFmwCfGwCaYWgdHgk5tW",
                                   //Nerve链兑换的合约地址
    "status": 3,  //订单状态  0：订单已生成， 1：发起链交易已发送，
                  // 2：发起链交易已确认，3:兑换成功，4：兑换失败                  
    "nerveStatus": 2,  //Nerve链上的兑换状态 0：未兑换， 1：已兑换，2：已跨链转出
    "createTime": "2022-03-02 21:04:04",
    "updateTime": "2022-03-02 21:04:03",
    "errorMsg": ""      //兑换失败信息
}

查询订单列表

详细描述：通过发起地址查询订单列表, 返回最近的10条记录。

访问：

url	method	说明
/swap/tx/query	post	查询Swap交易列表

参数：

参数名	类型	必填	描述
language	string	Y	语言：EN/CHS
nativeId	int	Y	evmChainId
address	string	Y	用户地址

返回：

{
    "code": 1000,
    "msg": "success",
    "data": [
        {
            "id": 103,
            "orderId": "7f1426ad-36b4-4786-9b01-524d4bdff4ac",
            "channel": "NERVE",
            "platform": "SWFT",
            "swapType": 2,
            "fromChain": "BSC",
            "fromAddress": "0x3083f7ed267dca41338de3401c4e054db2a1cd2f",
            "toChain": "NERVE",
            "toAddress": "TNVTdTSPVaHLGXQJDVCyNAo67zAoUcvbpeUri",
            "chainId": 102,
            "assetId": 0,
            "contractAddress": "0xd0a347e0ebea8f8efc26d539e17853c8e7a721c4",
            "decimal": 18,
            "symbol": "USDT",
            "swapChainId": 5,
            "swapAssetId": 90,
            "swapContractAddress": "",
            "swapDecimal": 6,
            "swapSymbol": "USDT",
            "txHash": "0x4e94169c2dc457dbac3af5a7d90c80eb825abf29b0414da6d2a7f2d1d42a9efe",
            "nerveTxHash": "0929249e710c203851a4f723a8d2774dc4d0fb9ecdcebbd058e6cbc82051372e",
            "crossTxHash": "0x4c07ee6e235af2e4cbb95d6a459fe37e365c71de55563036c78d90fef856d675",
            "amount": "100",
            "swapSuccAmount": "99.9500",
            "swapFee": "0.05",
            "crossFee": "0.0001",
            "slippage": 0,
            "pairAddress": "TNVTdTSQoL9quSyGJCA9sY8pcMEVy4RN4EjbB",
            "status": 3,
            "nerveStatus": 2,
            "createTime": "2022-03-09 14:18:12",
            "updateTime": "2022-03-23 14:27:20",
            "errorMsg": ""
        },
        {
            "id": 102,
            "orderId": "90c9784a-8ce9-4271-8c0b-037ac7fd918d",
            "channel": "NERVE",
            "platform": "SWFT",
            "swapType": 2,
            "fromChain": "BSC",
            "fromAddress": "0x3083f7ed267dca41338de3401c4e054db2a1cd2f",
            "toChain": "NERVE",
            "toAddress": "TNVTdTSPVaHLGXQJDVCyNAo67zAoUcvbpeUri",
            "chainId": 102,
            "assetId": 0,
            "contractAddress": "0xd0a347e0ebea8f8efc26d539e17853c8e7a721c4",
            "decimal": 18,
            "symbol": "USDT",
            "swapChainId": 5,
            "swapAssetId": 90,
            "swapContractAddress": "",
            "swapDecimal": 6,
            "swapSymbol": "USDT",
            "txHash": "0xb94eaeb65630d536a2313f6bea20ccf6f2eb735dd20e2f65c15a972fb5b6379d",
            "nerveTxHash": "e62cba9f464d5fca04d90f0280bbbe763eb148255ef2c41b8788ef6c8c744e94",
            "crossTxHash": "0x68a8c10c638d4412a8638e1a0799584facfa7eccad1b3a2581ed760af1089260",
            "amount": "100",
            "swapSuccAmount": "99.9500",
            "swapFee": "0.05",
            "crossFee": "0.0001",
            "slippage": 0,
            "pairAddress": "TNVTdTSQoL9quSyGJCA9sY8pcMEVy4RN4EjbB",
            "status": 3,
            "nerveStatus": 2,
            "createTime": "2022-03-09 14:14:32",
            "updateTime": "2022-03-23 14:27:20",
            "errorMsg": ""
        }