• Only master account Master API key can call this interface, sub-accounts will return insufficient prvilege type error code
  • All orders returned are final
  • Deposit, Withdrawal failed will not be return
  • Query of trade history supports the past 7 days time range. The other types support maximum 30 days. Exceeded amount will return error code "Exceed maximum time range of N days"
  • Remark can only support up to 128 characters

📘

Please note the current endpoint is available to our Institutional clients only and can be requested by case by case

Weight: 5

Request Parameters

PARAMETERTYPEReq'dDESCRIPTION
accountIdLONGAccount ID
typeSTRINGYTransaction type:
"trade"
"deposit"
"fiatDeposit"
"withdraw"
"fiatWithdraw"
"transfer"
clientOrderIdSTRINGOnly corresponds to type - "trade"
remarkSTRINGRemark
startTimeLONGYStart timestamp
endTimeLONGYEnd timestamp
beginIdINTStart record number. Default: 0
E.g. If input ID is 1, return starting ID as 2
limitINTLimit
recvWindowLONGRecv window
timestampLONGYTimestamp

Type = trade

Supported for the past 7 days time range

Response content

PARAMETERTYPEDESCRIPTION
idSTRINGRecord ID
accountIdSTRINGAccount ID
typeSTRING"trade"
netBaseAmountSTRINGOrder Quantity
Buy direction (+ve)
Sell direction (-ve)
baseCcySTRINGBase currency
baseAssetBalanceSTRINGBase asset balance
netQuoteAmountSTRINGPrice * Quantity
Buy direction (-ve)
Sell direction (+ve)
quoteCcySTRINGE.g. USDT, USDC, USD
quoteAssetBalanceSTRINGQuote asset balance
directionSTRINGBUY or SELL
feeSTRINGTrading fee
feeCcySTRINGE.g. BTC, ETH, USDC
clientOrderIdSTRINGClient order ID
orderIdSTRINGOrder ID
tradeIdSTRINGTrade ID
transactTimeSTRINGTrade completed time

Sample

[
    {
        "id": "1",
        "accountId": "1491920242963768576",
        "type": "trade",
        "netBaseAmount": "-0.117",
        "baseCcy": "USDT",
        "baseAssetBalance": "0",
        "netQuoteAmount": "0.1987947",
        "quoteCcy": "USD",
        "quoteAssetBalance": "101559.9813547",
        "direction": "SELL",
        "fee": "0",
        "feeCcy": "USD",
        "clientOrderId": "1693893900079",
        "orderId": "1502885407766971392",
        "tradeId": "1502885411432734465",
        "transactTime": "1693893902000" // Trade Completed Time
    },
    {
        "id": "2",
        "accountId": "1491920242963768576",
        "type": "trade",
        "netBaseAmount": "0.73",
        "baseCcy": "USDT",
        "baseAssetBalance": "0.73",
        "netQuoteAmount": "-7.738",
        "quoteCcy": "USD",
        "quoteAssetBalance": "111552.2433547",
        "direction": "BUY",
        "fee": "0",
        "feeCcy": "USD",
        "clientOrderId": "76543234677654",
        "orderId": "1503639027592503040",
        "tradeId": "1504416817380112128",
        "transactTime": "1694076460000" // Trade Completed Time
    }
]

Type = fiatDeposit/fiatWithdraw

Supported for the past 30 days time range

Response content

PARAMETERTYPEDESCRIPTION
idSTRINGRecord ID
accountIdSTRINGAccount ID
typeSTRING"fiatDeposit", "fiatWithdraw"
netFiatAmountSTRINGFiat Deposit/Withdraw: amount
fiatCcySTRINGE.g. HKD, USD
fiatBalanceSTRINGFiat balance in the account
feeSTRINGFee amount
feeCcySTRINGFee Currency
orderIdSTRINGFiat Order ID
remarkSTRINGRemark
transactTimeSTRINGFiat Deposit/Withdraw Completed Time (To be released)

Sample

[
    {
        "id": "3",
        "accountId": "1491920242963768578",
        "type": "fiatDeposit",
        "netFiatAmount": "100001",
        "fiatCcy": "USD",
        "fiatBalance": "897400",
        "fee": "0",
        "feeCcy": "USD",
        "orderId": "FD486905037302665216",
        "remark": "",
        "transactTime": "1693895601000"
    },
  	{
        "id": "1",
        "accountId": "1491920242963768578",
        "type": "fiatWithdraw",
        "netFiatAmount": "50001",
        "fiatCcy": "USD",
        "fiatBalance": "797399",
        "fee": "0",
        "feeCcy": "USD",
        "orderId": "FW486905166923436032",
        "remark": "",
        "transactTime": "1693895424000"
    }  
]

Type = deposit/withdraw

Supported for the past 30 days time range

Response content

PARAMETERTYPEDESCRIPTION
idSTRINGRecord ID
accountIdSTRINGAccount ID
typeSTRING"Deposit", "Withdraw"
netVaAmountSTRINGDeposit/Withdraw: amount
vaCcySTRINGETH, BTC, USDC, etc
vaBalanceSTRINGFiat balance in the account
feeSTRINGDeposit/Withdraw Fee
feeCcySTRINGFee Currency
orderIdSTRINGDeposit/Withdraw Order ID
txnIdSTRINGChain Transaction ID
remarkSTRINGRemark
transactTimeSTRINGDeposit/Withdraw Completed Time

Sample

[
    {
        "id": "1",
        "accountId": "1491920242963768577",
        "type": "Deposit",
        "netVaAmount": "0.01",
        "vaCcy": "ETH",
        "vaBalance": "0.01",
        "fee": "0",
        "feeCcy": "ETH",
        "orderId": "D486914664762015744",
        "txnId": "0xc018245e58832271207160506fb8c405e1d0447f612755eaaa08ce5169a8cb64",
        "remark": "1234",
        "transactTime": "1693897504000"
    },
    {
        "id": "5",
        "accountId": "1491920242963768577",
        "type": "Withdraw",
        "netVaAmount": "0.01",
        "vaCcy": "ETH",
        "vaBalance": "0.03",
        "fee": "0",
        "feeCcy": "ETH",
        "orderId": "W486916336670310400",
        "txnId": "0xad87ba9b35daac48c5fbc2388b3232d611177c53b73b4e1bae5c1565c38d0024",
        "remark": "1234",
        "transactTime": "1693898225000"
    }
]

Type = transfer

Supported for the past 30 days time range

PARAMETERTYPEDESCRIPTION
idSTRINGRecord ID
fromAccountIdSTRINGFrom Account ID
toAccountIdSTRINGTo Account ID
typeSTRING"transfer"
netTransferAmountSTRINGTransfer Amount
transferCcySTRINGETH, BTC, USDC, etc
fromAccountBalanceSTRINGFrom Account balance
toAccountBalanceSTRINGTo Account balance
orderIdSTRINGTransfer OrderID
remarkSTRINGRemark
transactTimeSTRINGTransfer Completed Time
[
    {
        "id": "1",
        "fromAccountId": "1491920242963768578",
        "toAccountId": "1491920242963768576",
        "type": "transfer",
        "netTransferAmount": "10000",
        "transferCcy": "USD",
        "fromAccountBalance": "987400",
        "toAccountBalance": "111559.9813547",
        "orderId": "1502924239170215680", // Transfer order ID
        "remark": "",
        "transactTime": "1693898531000"
    },
    {
        "id": "2",
        "fromAccountId": "1491920242963768577",
        "toAccountId": "1491920242963768576",
        "type": "transfer",
        "netTransferAmount": "0.01",
        "transferCcy": "ETH",
        "fromAccountBalance": "0.02",
        "toAccountBalance": "0.0308",
        "orderId": "1502924310800539392", // Transfer order ID
        "remark": "",
        "transactTime": "1693898539000"
    }
]
Language
Authorization
Header
Click Try It! to start a request and see the response here!