ACCOUNT

Assets

POST /merchant/core/mcb/account/info

Request

Param	Type	Require	Remark

Response

Param	Type	Require	Remark
accountId	String	true	Account id
accountName	String	true	Account Name
accountType	String	true	Account Type
currency	String	true	Currency
totalBalance	BigDecimal	true	Total Balance
availableBalance	BigDecimal	true	Available balance
frozenBalance	BigDecimal	true	Freeze Balance
digital	Long	true	Digital

Example Response

{
    "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

POST /merchant/core/mcb/account/list

Request

Param	Type	Require	Remark
accountId	Long	false	AccountId
type	String	false	Account Type: WALLET - Wallet Account MARGIN - Margin Account
pageNum	Integer	true	Current page. Default is 1
pageSize	Integer	true	Number of pages per page. Default 10, maximum 10

Response

Param	Type	Require	Remark
accountId	String	true	Account id
accountName	String	true	Account Name
accountType	String	true	Account Type
currency	String	true	Currency
totalBalance	BigDecimal	true	Total Balance
availableBalance	BigDecimal	true	Available balance
frozenBalance	BigDecimal	true	Freeze Balance
digital	Long	true	Digital

Example Response

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "total": 21,
        "records":
        [
            {
                "accountId": "19847563867367666",
                "accountName":"wallet9023",
                "accountType":"WALLET",
                "currency": "USD",
                "totalBalance": 100,
                "availableBalance": 100,
                "frozenBalance": 0,
                "digital": 2
            }
        ]
    }
}

Single Account Query

POST /merchant/core/mcb/account/single/query

Request

Param	Type	Require	Remark
accountId	Long	true	Account ID

Response

Param	Type	Require	Remark
accountId	String	true	Account id
accountName	String	true	Account Name
accountType	String	true	Account Type
currency	String	true	Currency
totalBalance	BigDecimal	true	Total Balance
availableBalance	BigDecimal	true	Available balance
frozenBalance	BigDecimal	true	Freeze Balance
digital	Long	true	Digital

Example Response

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "accountId": "1996967874372661250",
            "accountName":"Frank's wallet",
            "accountType":"WALLET",
            "currency": "USD",
            "totalBalance": 1000,
            "availableBalance": 1000,
            "frozenBalance": 0,
            "digital": 2
        }
    ]
}

Ledger Transactions

User's financial transaction history

POST /merchant/core/mcb/account/transaction

Request

Param	Type	Require	Remark
pageNum	Integer	true	Current page. Default is 1
pageSize	Integer	true	Number of pages per page. Default 10, maximum 100
orderNo	String	false	Transaction id
accountId	Long	false	Account ID
bizType	String	false	Transaction type chain_deposit: Wallet chain deposit chain_withdraw: Wallet chain withdrawal card_purchase: Card purchase card_deposit: Card deposit card_withdraw: Card withdraw card_cancel: Card cancel card_auth_fee_patch: Card authorization fee card_auth_cross_board_patch: Card cross-border fee gt_transfer: Global transfer fixed: Adjustment card_overdraft_statement: Card overdraft bill gt_transfer_refund: Global transfer refund card_settlement: Card transaction settlement card_refund: Card transaction refund fund_transfer: Fund transfer fund_collection: Fund Collection card_decline_fee: Card refusal processing fee
startTime	Long	false	Start transaction time. Milliseconds timestamp. The time range cannot exceed 30 days. The default query retrieves data from the most recent 30 days.
endTime	Long	false	End transaction time. Milliseconds timestamp. The time range cannot exceed 30 days. The default query retrieves data from the most recent 30 days.

Response

Param	Type	Require	Remark
txId	Long	true	Internal transaction id
accountId	String	true	account id
amount	BigDecimal	true	Amount
beforeBalance	BigDecimal	true	Before balance
afterBalance	BigDecimal	true	After Balance
orderNo	String	true	Transaction id
bizType	String	true	Transaction type chain_deposit: Wallet chain deposit chain_withdraw: Wallet chain withdrawal card_purchase: Card purchase card_deposit: Card deposit card_withdraw: Card withdraw card_cancel: Card cancel card_auth_fee_patch: Card authorization fee card_auth_cross_board_patch: Card cross-border fee gt_transfer: Global transfer fixed: Adjustment card_overdraft_statement: Card overdraft bill gt_transfer_refund: Global transfer refund card_settlement: Card transaction settlement card_refund: Card transaction refund fund_transfer: Fund transfer fund_collection: Fund Collection card_decline_fee: Card refusal processing fee
direction	String	true	Direction. IN OUT
remark	String	false	Remark
createTime	Long	true	Transaction time. Milliseconds timestamp

Example Response

{
    "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
            },
            {
                "txId": 517580,
                "accountId": "1979009257233215490",
                "currency": "USD",
                "amount": "113.93",
                "beforeBalance": "99440.97375",
                "afterBalance": "99327.04375",
                "orderNo": "C2C_TJS_2025122307554166839",
                "bizType": "gt_transfer",
                "direction": "OUT",
                "remark": "Global transfer",
                "createTime": 1766480100707
            }
        ]
    }
}

Create a shared account

POST /merchant/core/mcb/account/create

Request

Param	Type	Require	Remark
accountName	String	true	Shared account name

Response

Param	Type	Require	Remark
accountId	String	true	Account id
accountName	String	true	Account Name
accountType	String	true	Account Type
currency	String	true	Currency
totalBalance	BigDecimal	true	Total Balance
availableBalance	BigDecimal	true	Available balance
frozenBalance	BigDecimal	true	Freeze Balance
digital	Long	true	Digital

Example Response

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "accountId": "1996967874372661250",
            "accountName":"margin9980",
            "accountType":"MARGIN",
            "currency": "USD",
            "totalBalance": 0,
            "availableBalance": 0,
            "frozenBalance": 0,
            "digital": 2
        }
    ]
}

Fund transfer

POST /merchant/core/mcb/account/transfer

Request

Param	Type	Require	Remark
type	String	true	Operation type: TRANSFER: represents transfer; COLLECTION: represents collection.
merchantOrderNo	String	true	Client transaction id. length[20...40]
amount	BigDecimal	true	Amount of operation
payerAccountId	Long	true	Payer ID, typically an account ID of type WALLET.
payeeAccountId	Long	true	Payee ID, usually an account ID of type MARGIN.
remark	String	false	Remark

Response

Param	Type	Require	Remark

Example Response

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data": true
}