Skip to main content

​
Account APIs

Manage merchant accounts (WALLET and MARGIN types), query balances, view ledger transactions, and execute fund transfers.
Base URL: POST /api/v2.1/fincard/virtual/account/...

​
Assets (Account Info)

Returns all merchant accounts with balances. 
POST /api/v2.1/fincard/virtual/account/info
Request: {} (empty body) Response data[]:
FieldTypeDescription
accountIdStringAccount ID
accountNameStringAccount name
accountTypeStringWALLET or MARGIN
currencyStringCurrency (e.g. USD)
totalBalanceBigDecimalTotal balance
availableBalanceBigDecimalAvailable balance
frozenBalanceBigDecimalFrozen balance
digitalLongDecimal places for display
{
  "success": true,
  "code": 200,
  "msg": "Success",
  "data": [
    {
      "accountId": "19847563867367666",
      "accountName": "wallet9023",
      "accountType": "WALLET",
      "currency": "USD",
      "totalBalance": 100,
      "availableBalance": 100,
      "frozenBalance": 0,
      "digital": 2
    }
  ]
}

​
Account List

Paginated list of accounts with optional type filter. 
POST /api/v2.1/fincard/virtual/account/list
Request:
FieldTypeRequiredDescription
accountIdLongNoFilter by account ID
typeStringNoWALLET or MARGIN
pageNumIntegerYesPage number (default 1)
pageSizeIntegerYesPage size (default 10, max 10)
Response data: { total: Long, records: [...] } — records same shape as Account Info.

​
Single Account Query

Query a single account by ID. 
POST /api/v2.1/fincard/virtual/account/single/query
Request:
FieldTypeRequiredDescription
accountIdLongYesAccount ID
Response data[]: Same shape as Account Info.

​
Ledger Transactions

Query financial transaction history for an account. 
POST /api/v2.1/fincard/virtual/account/transaction
Request:
FieldTypeRequiredDescription
pageNumIntegerYesPage number (default 1)
pageSizeIntegerYesPage size (default 10, max 100)
orderNoStringNoFilter by transaction ID
accountIdLongNoFilter by account
bizTypeStringNoTransaction type (see below)
startTimeLongNoStart time (ms). Max 30-day range
endTimeLongNoEnd time (ms)
Transaction Types (bizType):
ValueDescription
chain_depositWallet chain deposit
chain_withdrawWallet chain withdrawal
card_purchaseCard purchase (create fee + deposit)
card_depositCard deposit
card_withdrawCard withdraw
card_cancelCard cancel
card_auth_fee_patchCard authorization fee
card_auth_cross_board_patchCard cross-border fee
gt_transferGlobal transfer
gt_transfer_refundGlobal transfer refund
fixedAdjustment
card_overdraft_statementCard overdraft bill
Response data: { total, records[] }
FieldTypeDescription
txIdLongInternal transaction ID
accountIdStringAccount ID
amountBigDecimalAmount
beforeBalanceBigDecimalBalance before transaction
afterBalanceBigDecimalBalance after transaction
orderNoStringTransaction ID
bizTypeStringTransaction type
directionStringIN or OUT
remarkStringRemark
createTimeLongMillisecond timestamp
{
  "success": true,
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "total": 34,
    "records": [
      {
        "txId": 517581,
        "accountId": "1979009257233215490",
        "currency": "USD",
        "amount": "4.08",
        "beforeBalance": "99327.04375",
        "afterBalance": "99322.96375",
        "orderNo": "C2C_UZS_2025122307584616966",
        "bizType": "gt_transfer",
        "direction": "OUT",
        "remark": "Global transfer",
        "createTime": 1766480100874
      }
    ]
  }
}

​
Create Shared Account

Create a new MARGIN account for shared card mode. 
POST /api/v2.1/fincard/virtual/account/create
Request:
FieldTypeRequiredDescription
accountNameStringYesAccount name
Response data[]: The created account (same shape as Account Info).

​
Fund Transfer

Transfer or collect funds between accounts. 
POST /api/v2.1/fincard/virtual/account/transfer
Request:
FieldTypeRequiredDescription
typeStringYesTRANSFER or COLLECTION
merchantOrderNoStringYesClient transaction ID [20..40]
amountBigDecimalYesAmount
payerAccountIdLongYesPayer account (typically WALLET)
payeeAccountIdLongYesPayee account (typically MARGIN)
remarkStringNoRemark
Response data: true (boolean)
Use this to fund a MARGIN account before creating shared (BUDGET_CARD) cards linked to it.

​
Wallet Deposit (Deprecated)

Deprecated. Use the Wallet v2 APIs instead.
Create a wallet deposit order. Returns deposit address and amount. 
POST /api/v2.1/fincard/virtual/account/walletDeposit
Request:
FieldTypeRequiredDescription
chainStringNoTRC20 (default) or BEP20
amountBigDecimalYesDeposit amount
Response data:
FieldTypeDescription
orderNoStringTransaction ID
userInputDepositAmountBigDecimalInput amount
actualDepositAmountBigDecimalActual amount (with decimal adjustment)
currencyStringUSDT
chainStringNetwork chain
toAddressStringWallet deposit address
createTimeLongOrder time (ms)
expireSecondLongValidity period (seconds)

​
Wallet Deposit Transactions (Deprecated)

Deprecated. Use the Wallet v2 Transaction History instead.
POST /api/v2.1/fincard/virtual/account/walletDepositTransaction
Paginated query for wallet deposit transactions. Response: { total, records[] }.