Skip to main content

​
Crypto Wallet APIs (v2)

Manage cryptocurrency wallet addresses for funding your merchant account. Supports USDT on TRC20 and BEP20 chains.
Base URL: POST /api/v2.1/fincard/virtual/wallet/v2/...

​
Coin List

Query all supported coins and blockchain networks. 
POST /api/v2.1/fincard/virtual/wallet/v2/coins
Request: {} (empty body) Response data[]:
FieldTypeDescription
coinKeyStringUnique coin identifier (e.g. USDT_TRC20)
chainStringBlockchain network (e.g. TRC20, BEP20)
coinFullNameStringFull name (e.g. Tether)
coinNameStringShort name (e.g. USDT)
showCoinDecimalIntegerDisplay decimal places
coinDecimalIntegerTransaction decimal places
blockChainShowNameStringDisplay name (e.g. Tron (TRC20))
browserStringBlockchain explorer URL template for addresses
txRefUrlStringBlockchain explorer URL template for transactions
contractAddressStringSmart contract address
enableDepositBooleanDeposits enabled
enableWithdrawBooleanWithdrawals enabled
confirmationsIntegerRequired block confirmations
enabledBooleanCoin is active
{
  "success": true,
  "code": 200,
  "msg": "SUCCESS",
  "data": [
    {
      "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

Generate a new deposit address for a specific coin and chain. 
POST /api/v2.1/fincard/virtual/wallet/v2/create
Request:
FieldTypeRequiredDescription
coinKeyStringYesCoin key from Coin List (must have enabled=true)
Response data:
FieldTypeDescription
coinKeyStringCoin key
chainStringBlockchain network
coinNameStringCoin name
addressStringGenerated deposit address
{
  "success": true,
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "coinKey": "USDT_BEP20",
    "chain": "BEP20",
    "coinName": "USDT",
    "address": "0xAAac5f0d8133424d86D5Ef3f170E0420e561125f"
  }
}
You can also generate wallet addresses from the dashboard. Each coinKey has one address per merchant.

​
Wallet Address List

Query all generated wallet deposit addresses. 
POST /api/v2.1/fincard/virtual/wallet/v2/addressList
Request: {} (empty body) Response data[]: Same shape as Create Wallet Address response.

​
Wallet Transaction History

Query crypto deposit and withdrawal transaction history. 
POST /api/v2.1/fincard/virtual/wallet/v2/transaction
Request:
FieldTypeRequiredDescription
pageNumLongYesPage number (default 1)
pageSizeLongYesPage size (default 10, max 100)
coinKeyStringNoFilter by coin key
coinNameStringNoFilter by coin name
txHashStringNoFilter by on-chain tx hash
sourceAddressStringNoFilter by source address
destinationAddressStringNoFilter by destination address
orderNoStringNoFilter by platform tx ID
typeStringNoDEPOSIT or WITHDRAW
statusStringNowait_process / processing / success / fail
startTimeLongNoStart time (ms). Max 90-day range
endTimeLongNoEnd time (ms)
Response data: { total, records[] }
FieldTypeDescription
orderNoStringPlatform transaction ID
coinKeyStringCoin key
coinNameStringCoin name
blockIntegerBlock height
sourceAddressStringSource address
destinationAddressStringDestination address
txHashStringOn-chain transaction hash
txAmountBigDecimalOn-chain amount
transactionTimeLongChain transaction time (ms)
confirmTimeLongChain confirmation time (ms)
feeRateBigDecimalPlatform fee rate (1 = 1%)
feeBigDecimalPlatform fee amount
fixedFeeBigDecimalPlatform fixed fee
receivedAmountBigDecimalNet received amount
receivedCurrencyStringReceived currency (e.g. USD)
typeStringDEPOSIT or WITHDRAW
statusStringwait_process / processing / success / fail
messageStringRemark
createTimeLongOrder create time (ms)
updateTimeLongOrder update time (ms)
{
  "success": true,
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "total": 5,
    "records": [
      {
        "orderNo": "CND2031235349498847232",
        "coinKey": "USDT_TRC20",
        "block": 80817428,
        "sourceAddress": "TK4ykR48cQQoyFcZ5N4xZCbsBaHcg6n3gJ",
        "destinationAddress": "TReJ9YfvmpPTXuq3kzQneXDco1fQprqZ9v",
        "txHash": "1c19a9635e8c11c6b7be0e402017e81e64e9f7f1ad1a10e1ea1304955745b434",
        "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
      }
    ]
  }
}
If status=fail, it is not necessarily final. The platform may manually resolve failed deposits to success.