钱包接口

查询币种信息

返回币种详细信息以及智能合约地址

请求示例

Get /api/v3/capital/config/getall

返回示例

[
  {
    "coin": "EOS",
    "name": "EOS",
    "networkList": [
      {
          "coin": "EOS",
          "depositDesc": null,
          "depositEnable": true,
          "minConfirm": 0,
          "name": "EOS",
          "network": "EOS",
          "withdrawEnable": false,
          "withdrawFee": "0.000100000000000000",
          "withdrawIntegerMultiple": null,
          "withdrawMax": "10000.000000000000000000",
          "withdrawMin": "0.001000000000000000",
          "sameAddress": false,
          "contract": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxbm9",
          "withdrawTips": "Both a MEMO and an Address are required.",
          "depositTips": "Both a MEMO and an Address are required.",
          "netWork": "EOS"
      },
      {
          "coin": "BTC",
          "depositDesc": null,
          "depositEnable": true,
          "minConfirm": 0,
          "name": "BTC-BSC",
          "network": "BEP20(BSC)",
          "withdrawEnable": true,
          "withdrawFee": "0.000010000000000000",
          "withdrawIntegerMultiple": null,
          "withdrawMax": "100.000000000000000000",
          "withdrawMin": "0.000100000000000000",
          "sameAddress": false,
          "contract": "0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c",
          "withdrawTips": null,
          "depositTips": null,
          "netWork": "BTC"
      }
    ]
  },
]

HTTP请求

GET /api/v3/capital/config/getall

接口权限要求: 钱包提现相关读 / SPOT_WITHDRAW_R

权重(IP): 10

请求参数

参数名	数据类型	是否必须	说明
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	说明
depositEnable	是否可充值
withdrawEnable	是否可提币
withdrawFee	提币手续费
withdrawMax	最大提币限额
withdrawMin	最小提币限额
contract	币种智能合约地址
network	币种所支持的网络（旧参数，即将下线，建议提币使用提币新接口）
netWork	币种所支持的网络（新参数，适用于提币新接口）

提币（新增）

请求示例

post /api/v3/capital/withdraw?coin=EOS&address=zzqqqqqqqqqq&amount=10&netWork=EOS&memo=MX10086&timestamp={{timestamp}}&signature={{signature}}

返回示例

{
    "id":"7213fea8e94b4a5593d507237e5a555b"
}

HTTP请求

POST /api/v3/capital/withdraw

接口权限要求: 钱包提现相关写 / SPOT_WITHDRAW_W

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
coin	string	是	币种
withdrawOrderId	string	否	自定义提币ID
netWork	string	否	提币网络
contractAddress	string	否	币种智能合约地址
address	string	是	提币地址
memo	string	否	如地址中需求memo，则此处必传
amount	string	是	数量
remark	string	否	备注
timestamp	string	是	时间戳
signature	string	是	签名

可以在接口 Get /api/v3/capital/config/getall的返回值中某币种的networkList获取netWork网络字段。

返回参数

参数名	说明
id	提币ID

取消提币

请求示例

delete /api/v3/capital/withdraw?id=ca7bd51895134fb5bd749f1cf875b8af&timestamp={{timestamp}}&signature={{signature}}

返回示例

{
    "id": "ca7bd51895134fb5bd749f1cf875b8af"
}

HTTP请求

DELETE /api/v3/capital/withdraw

接口权限要求: 钱包提现相关写 / SPOT_WITHDRAW_W

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
id	string	是	提币ID

返回参数

参数名	说明
id	提币ID

获取充值历史(支持多网络)

请求示例

get /api/v3/capital/deposit/hisrec?coin=EOS&timestamp={{timestamp}}&signature={{signature}}

返回示例

[
  {
        "amount": "50000",
        "coin": "EOS",
        "network": "EOS",
        "status": 5,
        "address": "0x20b7cf77db93d6ef1ab979c49142ec168427fdee",
        "txId": "01391d1c1397ef0a3cbb3c7f99a90846f7c8c2a8dddcdcf84f46b530dede203e1bc804",
        "insertTime": 1659513342000,
        "unlockConfirm": "10",
        "confirmTimes": "241",
        "memo": "xxyy1122"
  }
]

HTTP请求

GET /api/v3/capital/deposit/hisrec

接口权限要求: 钱包提现相关读 / SPOT_WITHDRAW_R

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
coin	string	否	币种
status	string	否	状态
startTime	string	否	默认当前时间7天前的时间
endTime	string	否	默认当前时间戳，13位
limit	string	否	默认：1000，最大1000
timestamp	string	是	时间戳
signature	string	是	签名

默认返回最近7天的记录.
startTime 与 endTime 的默认时间戳，保证请求时间间隔不超过7天.
做多可查询90天内的记录. 返回参数

参数名	说明
amount	数量
coin	币种
network	链类型
status	充值状态，1:不入账的小额充值，2:延遲到賬，3:大額充值，4:等待中，5:入账成功，6:审核中，7:驳回，8:强充值退回，9:预入账，10:无效充值，11:受限中，12 :已退回
address	地址
addressTag	地址标签
txId	交易编号
insertTime	插入时间/创建时间
unlockConfirm	解锁需要的网络确认次数
confirmTimes	已解锁次数
memo	memo

获取提币历史 (支持多网络)

请求示例

get /api/v3/capital/withdraw/history?coin=EOS&timestamp={{timestamp}}&signature={{signature}}

返回示例

[
  {
        "id": "bb17a2d452684f00a523c015d512a341",
        "txId": null,
        "coin": "EOS",
        "network": "EOS",
        "address": "zzqqqqqqqqqq",
        "amount": "10",
        "transferType": 0,
        "status": 3,
        "transactionFee": "0",
        "confirmNo": null,
        "applyTime": 1665300874000,
        "remark": "",
        "memo": "MX10086",
        "transHash": "0x0ced593b8b5adc9f6003a934d0d7335456a7ed772ea5547beda4f33a065c",
        "updateTime": 1712134082000,
        "coinId": "128f589271cb491b03e71e6323eb7be",
        "vcoinId": "af42c6414b9a43869ce30fd51660f"
  }
]

HTTP请求

GET /api/v3/capital/withdraw/history

接口权限要求: 钱包提现相关读 / SPOT_WITHDRAW_R

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
coin	string	否	币种
status	string	否	提币状态
limit	string	否	默认：1000，最大：1000
startTime	string	否	默认当前时间7天前的时间戳
endTime	string	否	默认当前时间戳
timestamp	string	是	时间戳
signature	string	是	签名

默认返回最近7天的记录.
startTime 与 endTime 的默认时间戳，保证请求时间间隔不超过7天.
做多可查询90天内的记录.
支持多网络提币前的历史记录可能不会返回network字段. 返回参数

参数名	说明
address	地址
amount	提现转出金额
applyTime	申请时间
coin	币种
id	该笔提现的id
withdrawOrderId	自定义ID，如果没有则不返回该字段
network	链类型
transferType	0: 站外转账，1: 站内转账
status	提币状态，1:提交申请，2:审核中，3:等待处理，4:处理中，5:等待打包，6:等待确认，7:提现成功，8:提现失败，9:已取消，10:手动入账
transactionFee	手续费
confirmNo	提现确认数
txId	提现交易id
remark	提现记录备注
memo	memo
transHash	交易hash
coinId	资产id
vcoinId	币种id

生成充值地址 (支持多网络)

请求示例

post /api/v3/capital/deposit/address?coin=EOS&network=EOS&timestamp={{timestamp}}&signature={{signature}}

返回示例

{
    "coin": "EOS",
    "network": "EOS",
    "address": "zzqqqqqqqqqq",
    "memo": "MX10068"
}

HTTP请求

POST /api/v3/capital/deposit/address

接口权限要求: 钱包提现相关写 / SPOT_WITHDRAW_W

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
coin	string	是	币种
network	string	是	充值网络
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	说明
address	地址
coin	币种
network	链类型
memo	memo值

获取充值地址 (支持多网络)

请求示例

get /api/v3/capital/deposit/address?coin=USDT&timestamp={{timestamp}}&signature={{signature}}

返回示例

[
  {
      "coin": "USDT",
      "network": "TRC20",
      "address": "TXobiKkdciupZrhdvZyTSSLjE8CmZAufS",
      "memo": null
  },
  {
      "coin": "USDT",
      "network": "BEP20(BSC)",
      "address": "0xebe4804f7ecc22d5011c42e6ea1f2e6c891d89b",
      "memo": null
  },
  {
      "coin": "USDT",
      "network": "ERC20",
      "address": "0x3f4d1f43761b52fd594e5a77cd83cab6955e85b",
      "memo": null
  }
]

HTTP请求

GET /api/v3/capital/deposit/address

接口权限要求: 钱包提现相关读 / SPOT_WITHDRAW_R

权重(IP): 10

请求参数

参数名	数据类型	是否必须	说明
coin	string	是	币种
network	string	否
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	说明
address	地址
coin	币种
memo	memo
network	网络

获取提币地址 (支持多网络)

请求示例

get /api/v3/capital/withdraw/address?coin=USDT&timestamp={{timestamp}}&signature={{signature}}

返回示例

{
    "data": [
        {
            "coin": "USDT",
            "network": "TRC20",
            "address": "TArGWdTApuuZtiWMjupXqbZqQYsBTy126o",
            "addressTag": "test",
            "memo": null
        },
        {
            "coin": "USDT",
            "network": "BEP20(BSC)",
            "address": "0xa82898C70BeB5E1b1621fdA62fD17Ba27227BBC5",
            "addressTag": "usdt",
            "memo": null
        }
    ],
    "totalRecords": 2,
    "page": 1,
    "totalPageNum": 1
}

HTTP请求

GET /api/v3/capital/withdraw/address

接口权限要求: 钱包提现相关读 / SPOT_WITHDRAW_R

权重(IP): 10

请求参数

参数名	数据类型	是否必须	说明
coin	string	否	币种
page	number	否	页数，默认1
limit	number	否	条数
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	说明
coin	币种
network	链名称
address	地址
addressTag	地址标签
memo	memo
totalRecords	总条数
totalPageNum	总页数
page	当前页

用户万向划转【母母账户】

请求示例

post /api/v3/capital/transfer?fromAccountType=FUTURES&toAccountType=SPOT&asset=USDT&amount=1&timestamp={{timestamp}}&signature={{signature}}

返回示例

[
  {
    "tranId": "c45d800a47ba4cbc876a5cd29388319"
  }
]

HTTP请求

POST /api/v3/capital/transfer

接口权限要求: 资金划转写 / SPOT_TRANSFER_W

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
fromAccountType	string	是	划出账户类型，现货/合约，枚举值："SPOT","FUTURES"
toAccountType	string	是	划入账户类型，现货/合约，枚举值："SPOT","FUTURES"
asset	string	是	资产
amount	string	是	数量
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	说明
tranId	划转ID

查询用户万向划转历史

请求示例

get /api/v3/capital/transfer

返回示例

[
  {
    "rows":[
    {
      "tranId":"11945860693",//划转ID
      "clientTranId":"test",//client ID
      "asset":"BTC",//币种
      "amount":"0.1",//划转数量
      "fromAccountType":"SPOT",//转出业务账户
      "toAccountType":"FUTURE",//划入业务账户
      "fromSymbol":"SPOT",//转出交易对
      "toSymbol":"FUTURE",//划入交易对
      "status":"SUCCESS",//划转状态
      "timestamp":1544433325000//划转时间
    },
    {
      "tranId":"11945860693",//划转ID
      "clientTranId":"test",//client ID
      "asset":"BTC",//币种
      "amount":"0.1",//划转数量
      "fromAccountType":"SPOT",//转出业务账户
      "toAccountType":"FUTURE",//划入业务账户
      "fromSymbol":"SPOT",//转出交易对
      "toSymbol":"FUTURE",//划入交易对
      "status":"SUCCESS",//划转状态
      "timestamp":1544433325000//划转时间
    }],
    "total": 2,//总数
  }
]

HTTP请求

GET /api/v3/capital/transfer

接口权限要求: 资金划转读 / SPOT_TRANSFER_R

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
fromAccountType	string	是	划出账户类型，现货/合约，枚举值："SPOT","FUTURES"
toAccountType	string	是	划入账户类型，现货/合约/，枚举值："SPOT","FUTURES"
startTime	string	否
endTime	string	否
page	string	否	默认1
size	string	否	默认 10, 最大 100
timestamp	string	是	时间戳
signature	string	是	签名

仅支持查询最近半年（6个月）数据
若startTime和endTime没传，则默认返回最近7天数据 返回参数

参数名	说明
total	总数
tranId	划转ID
clientTranId	client ID
asset	币种
amount	划转数量
fromAccountType	转出业务账户
toAccountType	划入业务账户
symbol	转出交易对
status	划转状态，枚举值："SUCCESS"成功，"FAILED"失败，"WAIT"处理中
timestamp	划转时间

查询用户万向划转历史（根据tranId）

请求示例

get /api/v3/capital/transfer/tranId?tranId=cb28c88cd20c42819e4d5148d5fb5742&timestamp={{timestamp}}&signature={{signature}}

返回示例

{
    "tranId": "cb28c88cd20c42819e4d5148d5fb5742",
    "clientTranId": null,
    "asset": "USDT",
    "amount": "10",
    "fromAccountType": "SPOT",
    "toAccountType": "FUTURES",
    "symbol": null,
    "status": "SUCCESS",
    "timestamp": 1678603205000
}

HTTP请求

GET /api/v3/capital/transfer/tranId

接口权限要求: 资金划转读 / SPOT_TRANSFER_R

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
tranId	string	是	划转id
timestamp	string	是	时间戳
signature	string	是	签名

仅支持查询最近半年（6个月）数据

返回参数

参数名	说明
tranId	划转ID
clientTranId	client ID
asset	币种
amount	划转数量
fromAccountType	转出业务账户
toAccountType	划入业务账户
symbol	转出交易对
status	划转状态
timestamp	划转时间

获取小额资产可兑换列表

请求示例

get {{api_url}}/api/v3/capital/convert/list?timestamp={{timestamp}}&signature={{signature}}

返回示例

[
    {
           "convertMx": "0.000009",
           "convertUsdt": "0.000009",
           "balance": "0.000441",
           "asset": "USDT",
           "code": "30021",
           "message": "xxxxxxx"
 },
{
           "convertMx": "0.000009",
           "convertUsdt": "0.000009",
           "balance": "0.000441",
           "asset": "BTC",
           "code": "30021",
           "message": "xxxxxxx"
 }
]

HTTP请求

GET /api/v3/capital/convert/list

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	说明
convertMx	余额mx值预估(扣除手续费后)
convertUsdt	余额usdt估值
balance	币种余额
asset	币种
code	无法兑换原因code
message	无法兑换原因message

小额资产兑换

请求示例

post {{api_url}}/api/v3/capital/convert?asset=BTC,FIL,ETH&timestamp={{timestamp}}&signature={{signature}}

返回示例

{
  "successList":["ALGO","OMG"],
  "failedList":[],
  "totalConvert":"0.07085578",
  "convertFee":"0.00071571"
  }

HTTP请求

POST /api/v3/capital/convert

接口权限要求: 账户写 / SPOT_ACCOUNT_W

权重(IP): 10

请求参数

参数名	数据类型	是否必须	说明
asset	string	是	要兑换mx的小额资产(最多可以传15个)如:asset=BTC,FIL,ETH
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	说明
totalConvert	转换后的mx数量(扣除mx手续费)
convertFee	扣除mx手续费
successList	兑换成功币种列表
failedList	兑换失败币种列表
-asset	资产名称
-message	兑换失败错误信息
-code	兑换失败错误码

查询小额资产兑换历史

请求示例

get {{api_url}}/api/v3/capital/convert?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
    "data": [
        {
            "totalConvert": "0.00885018",
            "totalFee": "0.000177",
            "convertTime": 1665360563000,
            "convertDetails": [
                {
                    "id": "3e52a99c5c3447b2af2163cd829dca28",
                    "convert": "0.00885018",
                    "fee": "0.000177",
                    "amount": "0.007130464601986065",
                    "time": 1665360563000,
                    "asset": "ETHF"
                }
            ]
        },
        {
            "totalConvert": "0.026782",
            "totalFee": "0.00053562",
            "convertTime": 1663631477000,
            "convertDetails": [
                {
                    "id": "6483bfb1766d41d8a4b6b6315ded6e99",
                    "convert": "0.02098255",
                    "fee": "0.00041965",
                    "amount": "0.00000098",
                    "time": 1663631477000,
                    "asset": "BTC"
                },
                {
                    "id": "f9e886f28c454f5dae45eec6a11f6c6a",
                    "convert": "0.00084019",
                    "fee": "0.0000168",
                    "amount": "2",
                    "time": 1663631477000,
                    "asset": "JAM"
                }
            ]
        }
    ],  
    "totalRecords": 4,
    "page": 1,
    "totalPageNum": 1
}

HTTP请求

GET /api/v3/capital/convert

接口权限要求: 现货交易信息读 / SPOT_DEAL_R

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
startTime	long	否	开始时间
endTime	long	否	结束时间
page	int	否	页数,默认 1
limit	int	否	返回的条数,默认 1; 最大 1000
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	数据类型	说明
totalConvert	string	转换后的mx数量(扣除mx手续费)
totalFee	string	本次兑换的总手续费
convertTime	long	本次兑换时间
convertDetails	object	本次转换的细节
id	string	兑换id
convert	string	兑换后的mx
fee	string	兑换手续费
amount	string	币种数量
time	long	兑换时间
asset	string	币种
page	int	当前页
totalRecords	int	总记录数
totalPage	int	总页数

用户站内转账接口

请求示例

post /api/v3/capital/transfer/internal?&timestamp={{timestamp}}&signature={{signature}}

返回示例

  {
    "tranId": "c45d800a47ba4cbc876a5cd29388319"
  }

HTTP请求

POST /api/v3/capital/transfer/internal

接口权限要求: 钱包提现相关写 / SPOT_WITHDRAW_W

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
toAccountType	string	是	收款账户类型，支持填入手机号/邮箱或者UID
toAccount	string	是	收款账户地址，支持填入手机号/邮箱或者UID
areaCode	string	否	如果toAccount为手机号，该字段为该手机号的必填区号
asset	string	是	资产
amount	string	是	数量
timestamp	string	是	时间戳
signature	string	是	签名

返回参数

参数名	说明
tranId	划转ID

查询用户内部转账历史接口

请求示例

get /api/v3/capital/transfer/internal?&timestamp={{timestamp}}&signature={{signature}}

返回示例

  {
    "page": 1,  //当前页
    "totalRecords": 1,  //总记录数
    "totalPageNum": 1,  //总页数
    "data": [
             {
      "tranId":"11945860693",//划转ID
      "asset":"BTC",//币种
      "amount":"0.1",//划转数量
      "toAccountType":"EMAIL",//收款账户类型
      "toAccount":"156283619@outlook.com",//收款账户
      "fromAccount":"156283618@outlook.com",//付款账户
      "status":"SUCCESS",//划转状态
      "timestamp":1544433325000//划转时间
    },
    {
      "tranId":"",//划转ID
      "asset":"BTC",//币种
      "amount":"0.8",//划转数量
      "toAccountType":"UID",//收款账户类型
      "fromAccount":"156283619@outlook.com",//付款账户
      "toAccount":"87658765",//收款账户
      "status":"SUCCESS",//划转状态
      "timestamp":1544433325000//划转时间
    }
    ]
}

HTTP请求

GET /api/v3/capital/transfer/internal

接口权限要求: 钱包提现相关读 / SPOT_WITHDRAW_R

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
startTime	long	否
endTime	long	否
page	int	否	默认1
limit	int	否	默认10
tranId	string	否	划转id
timestamp	string	是	时间戳
signature	string	是	签名

若startTime和endTime没传，则默认返回最近7天数据

返回参数

参数名	说明
page	当前页
totalRecords	总记录数
totalPage	总页数
tranId	划转ID
asset	币种
amount	划转数量
fromAccountType	转出业务账户
toAccountType	划入业务账户
status	划转状态
timestamp	划转时间

提币（旧接口，即将下线）

请求示例

post /api/v3/capital/withdraw/apply?coin=EOS&address=zzqqqqqqqqqq&amount=10&network=EOS&memo=MX10086&timestamp={{timestamp}}&signature={{signature}}

返回示例

[
  {
    "id":"7213fea8e94b4a5593d507237e5a555b"
  }
]

HTTP请求

POST /api/v3/capital/withdraw/apply

接口权限要求: 钱包提现相关写 / SPOT_WITHDRAW_W

权重(IP): 1

请求参数

参数名	数据类型	是否必须	说明
coin	string	是	币种
withdrawOrderId	string	否	自定义提币ID
network	string	否	提币网络
address	string	是	提币地址
memo	string	否	如地址中需求memo，则此处必传
amount	string	是	数量
remark	string	否	备注
timestamp	string	是	时间戳
signature	string	是	签名

可以在接口 Get /api/v3/capital/config/getall的返回值中某币种的networkList获取network网络字段。

返回参数

参数名	说明
id	提币ID

查询币种信息​

提币（新增）​

取消提币​

获取充值历史(支持多网络)​

获取提币历史 (支持多网络)​

生成充值地址 (支持多网络)​

获取充值地址 (支持多网络)​

获取提币地址 (支持多网络)​

用户万向划转【母母账户】​

查询用户万向划转历史​

查询用户万向划转历史（根据tranId）​

获取小额资产可兑换列表​

小额资产兑换​

查询小额资产兑换历史​

用户站内转账接口​

查询用户内部转账历史接口​

提币（旧接口，即将下线）​

查询币种信息

提币（新增）

取消提币

获取充值历史(支持多网络)

获取提币历史 (支持多网络)

生成充值地址 (支持多网络)

获取充值地址 (支持多网络)

获取提币地址 (支持多网络)

用户万向划转【母母账户】

查询用户万向划转历史

查询用户万向划转历史（根据tranId）

获取小额资产可兑换列表

小额资产兑换

查询小额资产兑换历史

用户站内转账接口

查询用户内部转账历史接口

提币（旧接口，即将下线）