WALLET

Wallet Address-Deprecated

Call this interface to place an order for wallet recharge. It will return the order number, and the amount to be deposit.

POST /merchant/core/mcb/account/walletDeposit

Request

Param	Type	Required	Remark
chain	String	false	Network chain. default: TRC20 TRC20 BEP20
amount	BigDecimal	true	Deposit amount

Response

Param	Type	Required	Remark
orderNo	String	true	Transaction id
userInputDepositAmount	BigDecimal	true	The deposit amount input by the user
actualDepositAmount	BigDecimal	true	The actual amount to be recharged. A decimal may be generated based on userInputDepositAmount
currency	String	true	currency
chain	String	true	Network chain
toAddress	String	true	Wallet deposit address
createTime	Long	true	Order time. Timestamp
expireSecond	Long	true	Validity period (unit: seconds)

Example Response

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "orderNo": "CND1896547520597221376",
        "userInputDepositAmount": 20,
        "actualDepositAmount": 20.0377,
        "currency": "USDT",
        "chain": "TRC20",
        "toAddress": "TF9fZHD27TmEznSRHcirWkXj2asg24kl3jg",
        "createTime": 1741007139000,
        "expireSecond": 10800
    }
}

Wallet Deposit Transaction-Deprecated

Note: that if status=fail is not considered the final state, we can manually enter the final status=success (this is a possibility).

POST /merchant/core/mcb/account/walletDepositTransaction

Request

Param	Type	Required	Remark
pageNum	Long	true	Current page. Default: 1
pageSize	Long	true	Number of pages per page. Default: 10; Maximum: 100
orderNo	String	false	Transaction id
fromAddress	String	false	Source address
toAddress	String	false	Target address
txId	String	false	Tx hash
status	String	false	Status wait_process: Wait process; processing: Processing; success: Success; fail: Failed;
startTime	Long	false	Order start time. Millisecond timestamp
endTime	Long	false	Order end time. Millisecond timestamp

Response

Param	Type	Required	Remark
orderNo	String	true	Transaction id
needDepositTxAmount	BigDecimal	true	Order Amount
txAmount	BigDecimal	false	On-chain deposit amount
feeRate	BigDecimal	true	Deposit fee rate. Example: 1 = 1%
feeRateAmount	BigDecimal	true	Deposit fee rate amount
fixedFee	BigDecimal	true	Fixed deposit fee amount
currency	String	true	Currency. Example: USDT
receivedAmount	BigDecimal	false	Received amount
receivedCurrency	String	false	Received currency
chain	String	true	Chain. Example: TRC20
fromAddress	String	false	Source address
toAddress	String	true	Target address
txId	String	false	Tx hash
block	Integer	false	Block Height
confirmTime	Long	false	Transaction confirmation time on the chain. Millisecond timestamp
type	String	true	Type chain_deposit: On-chain deposit
status	String	true	Status wait_process: Pending; processing: Processing; success: Success; fail: Failed;
remark	String	false	Remark
createTime	Long	true	Order create time. Millisecond timestamp
updateTime	Long	true	Order update time. Millisecond timestamp

Example Response

{
    "success": true,
    "code": 200,
    "msg": "SUCCESS",
    "data":
    {
        "total": 25,
        "records":
        [
            {
                "orderNo": "CND1985645689502720000",
                "needDepositTxAmount": 20,
                "txAmount": 20,
                "feeRate": 1.5,
                "fee": 0.3,
                "fixedFee": 0,
                "currency": "USDT",
                "receivedAmount": 19.7,
                "receivedCurrency": "USD",
                "chain": "TRC20",
                "fromAddress": "TVwdXFHzD5mJP52xkxtRfVCLrWNaLGiiaB",
                "toAddress": "TF9fZHk27TmEznSRHiirWkX23zbZJC299M",
                "txId": "b5eccb05e227fab979182905e3ff1ec8a0995f43bc407aaaaaaaaaaaaaaa",
                "block": 65567635,
                "confirmTime": 1727351235000,
                "type": "chain_deposit",
                "status": "success",
                "remark": "Chain deposit",
                "createTime": 1762249798000,
                "updateTime": 1762249920000
            }
        ]
    }
}

Wallet Flow Chart-v2

1

Call Coin list

Query supported coins

2

Create wallet address

Create wallet address

3

Query wallet address list

Query wallet address list

Coin List-v2

POST /merchant/core/mcb/wallet/v2/coins

Request

Param	Type	Required	Remark

Response

Param	Type	Required	Remark
coinKey	String	true	Coin key
chain	String	true	Chain
coinFullName	String	true	Coin full name
coinName	String	true	Coin name
showCoinDecimal	Integer	true	Coin show decimal
coinDecimal	Integer	true	Coin transaction decimal
blockChainShowName	String	true	Block chain show name
browser	String	true	Wallet address redirect link url
txRefUrl	String	true	Transaction redirect link url
contractAddress	String	true	Contract
enableDeposit	Boolean	true	Enable deposit. true false
enableWithdraw	Boolean	true	Enable withdraw. true false
confirmations	Integer	true	Block confirmation count
enabled	Boolean	true	Enable Coin true false

Example Response

{
  "success": true,
  "code": 200,
  "msg": "SUCCESS",
  "data": [
    {
      "coinKey": "USDT_BEP20",
      "chain": "BEP20",
      "coinFullName": "Tether",
      "coinName": "USDT",
      "showCoinDecimal": 8,
      "coinDecimal": 18,
      "blockChainShowName": "BNB Smart Chain (BEP20)",
      "browser": "https://bscscan.com/token/0x55d398326f99059ff775485246999027b3197955?a={address}",
      "txRefUrl": "https://bscscan.com/tx/{txHash}",
      "contractAddress": "0x55d398326f99059ff775485246999027b3197955",
      "enableDeposit": true,
      "enableWithdraw": true,
      "confirmations": 15,
      "enabled": true
    },
    {
      "coinKey": "USDT_TRC20",
      "chain": "TRC20",
      "coinFullName": "Tether",
      "coinName": "USDT",
      "showCoinDecimal": 6,
      "coinDecimal": 6,
      "blockChainShowName": "Tron (TRC20)",
      "browser": "https://tronscan.org/#/address/{address}",
      "txRefUrl": "https://tronscan.org/#/transaction/{txHash}",
      "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "enableDeposit": true,
      "enableWithdraw": true,
      "confirmations": 38,
      "enabled": true
    }
  ]
}

Create Wallet Address-v2

This function is only supported when the parameter enabled=true. Also, You can also automatically generate a wallet address after selecting the coin and chain in the dashboard.

POST /merchant/core/mcb/wallet/v2/create

Request

Param	Type	Required	Remark
coinKey	String	true	Coin key

Response

Param	Type	Required	Remark
coinKey	String	true	Coin key
chain	String	true	Chain
coinName	String	true	Coin name
address	String	true	Address

Example Response

{
  "success": true,
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "coinKey": "USDT_BEP20",
    "chain": "BEP20",
    "coinName": "USDT",
    "address": "0xAAac5f0d8133424d86D5Ef3f170E0420e561125f"
  }
}

Wallet Address List-v2

POST /merchant/core/mcb/wallet/v2/addressList

Request

Param	Type	Required	Remark

Response

Param	Type	Required	Remark
coinKey	String	true	Coin key
chain	String	true	Chain
coinName	String	true	Coin name
address	String	true	Address

Example Response

{
  "success": true,
  "code": 200,
  "msg": "SUCCESS",
  "data": [
    {
      "coinKey": "USDT_BEP20",
      "chain": "BEP20",
      "coinName": "USDT",
      "address": "0xAAac5f0d8133424d86D5Ef3f170E0420e561125f"
    }
  ]
}

Wallet Transaction History-v2

Webhook link

POST /merchant/core/mcb/wallet/v2/transaction

Request

Param	Type	Required	Remark
pageNum	Long	true	Current page. Default: 1
pageSize	Long	true	Number of pages per page. Default: 10; Maximum: 100
coinKey	String	false	Coin key
coinName	String	false	Coin name
txHash	String	false	Tx hash
sourceAddress	String	false	Source address
destinationAddress	String	false	Destination address
orderNo	String	false	Wasabi transaction id
type	String	false	Type DEPOSIT WITHDRAW
status	String	false	Status wait_process: Pending; processing: Processing; success: Success; fail: Failed;
startTime	Long	false	Order start time. Millisecond timestamp The start and end time range cannot exceed 90 days. The default query will retrieve data from the most recent 90 days.
endTime	Long	false	Order end time. Millisecond timestamp The start and end time range cannot exceed 90 days. The default query will retrieve data from the most recent 90 days.

Response

Param	Type	Required	Remark
orderNo	String	true	Wasabi transaction id
coinKey	String	true	Coin key
block	Integer	false	Block Height
sourceAddress	String	true	Source address
destinationAddress	String	true	Destination address
txHash	String	false	Tx hash
txAmount	BigDecimal	false	On-chain transaction amount
transactionTime	Long	false	Transaction time on the chain. Millisecond timestamp
confirmTime	Long	false	Transaction confirmation time on the chain. Millisecond timestamp
coinName	String	true	Coin name
feeRate	BigDecimal	true	Platform fee rate. Example: 1 = 1%
fee	BigDecimal	true	Platform fee rate amount
fixedFee	BigDecimal	true	Platform Fixed fee amount
receivedAmount	BigDecimal	true	Received amount type = DEPOSIT: Amount deposit after deducting platform fees; type = WITHDRAW: Amount withdraw after deducting platform fees;
receivedCurrency	String	true	Received currency
type	String	true	Type DEPOSIT WITHDRAW
status	String	true	Status wait_process: Pending; processing: Processing; success: Success; fail: Failed;
message	String	false	Remark
createTime	Long	true	Order create time. Millisecond timestamp
updateTime	Long	true	Order update time. Millisecond timestamp

Example Response

{
    "success": true,
    "code": 200,
    "msg": "SUCCESS",
    "data":
    {
        "total": 5,
        "records":
        [
            {
                "orderNo": "CNW2031691897031385088",
                "coinKey": "USDC_BEP20_BINANCE_SMART_CHAIN_MAINNET",
                "block": 85966815,
                "sourceAddress": "0x8B368f7299e4010a1Cf88677e01012dD91a13BB1",
                "destinationAddress": "0xec472ff5dba2a732ed9cbf875a672fb746844982",
                "txHash": "0x5e3ab80d0d43da5f6481fae23f39767889442d83bbc37be987a26387b8208fde",
                "transactionTime": 1773231202000,
                "confirmTime": 1773231276000,
                "coinName": "USDC",
                "txAmount": "6",
                "feeRate": "1",
                "fee": "0.06",
                "fixedFee": "1",
                "receivedAmount": "6",
                "receivedCurrency": "USD",
                "type": "WITHDRAW",
                "status": "success",
                "createTime": 1773228069000,
                "updateTime": 1773231300000
            },
            {
                "orderNo": "CND2031235349498847232",
                "coinKey": "USDT_TRC20",
                "block": 80817428,
                "sourceAddress": "TK4ykR48cQQoyFcZ5N4xZCbsBaHcg6n3gJ",
                "destinationAddress": "TReJ9YfvmpPTXuq3kzQneXDco1fQprqZ9v",
                "txHash": "1c19a9635e8c11c6b7be0e402017e81e64e9f7f1ad1a10e1ea1304955745b434",
                "transactionTime": 1773119090000,
                "confirmTime": 1773119194000,
                "coinName": "USDT",
                "txAmount": "9",
                "feeRate": "1.5",
                "fee": "0.135",
                "fixedFee": "0",
                "receivedAmount": "8.86",
                "receivedCurrency": "USD",
                "type": "DEPOSIT",
                "status": "success",
                "createTime": 1773119220000,
                "updateTime": 1773119220000
            }
        ]
    }
}