Get Deposit Records

Query deposit records.

API rate limit: 300 req / min

HTTP Request

GET /private/v1/asset/deposit/query-record

Request Parameters

Parameter	Required	Type	Comments
type	false	integer	Deposit type. 0(default): on chain. 1: internal transfer. 2: all
chain	false	string	Default return of all data
coin	false	string	Coin
txId	false	string	Transaction hash ID
startTime	false	integer	The start timestamp (s)
endTime	false	integer	The end timestamp (s)
pageSize	false	integer	Limit for data size per page. [1, 50]. Default: 20
cursor	false	string	Cursor. Used for pagination

Response Parameters

Parameter	Type	Comments
rows	array	Object
> type	string	0: on chain. 1: internal transfer.
> chain	string	Chain
> coin	string	Coin
> amount	string	Amount
> address	string	To deposit address. Internal transfer: Display Zoomex UID
> status	string	Deposit status: 0- in progress 1- successful 2- failed
> time	string	Update timestamp (s)
> transaction_id	string	Unique transaction ID
> tx_id	string	Transaction hash, only on chain transactions will generate
> create_time	int	Creation time (second level timestamp)
cursor	string	Cursor. Used for pagination

---

Request Example

import time
import hmac
import hashlib
import requests
import urllib.parse

def create_request(apiKey, secret, params):
    url = 'https://openapi-testnet.zoomex.com/private/v1/asset/deposit/query-record'
    timestamp = int(time.time() * 1000)
    recv_window = 1000000

    params['api_key'] = apiKey
    params['timestamp'] = timestamp
    params['recv_window'] = recv_window

    ordered_params = '&'.join([f"{key}={params[key]}" for key in sorted(params.keys())])

    signature = hmac.new(secret.encode('utf-8'), ordered_params.encode('utf-8'), hashlib.sha256).hexdigest()

    params['sign'] = signature

    headers = {
        'X-BAPI-API-KEY': apiKey,
        'X-BAPI-SIGN': signature,
        'X-BAPI-TIMESTAMP': str(timestamp),
        'X-BAPI-RECV-WINDOW': str(recv_window)
    }

    query_string = urllib.parse.urlencode(params)
    full_url = f"{url}?{query_string}"

    response = requests.get(full_url, headers=headers)

    print("response status:", response.status_code)
    print("response info:", response.json())
    print("response time:", response.elapsed.total_seconds())

apiKey = 'your key'
secret = 'your secret'
params = {
    "coin": "USDT",
}

create_request(apiKey, secret, params)

Response Example

{
    "ret_code": 0,
    "ret_msg": "OK",
    "ext_code": "",
    "result": {
        "rows": [
          {
            "type": 1,
            "coin": "USDT",
            "chain": "your chain",
            "amount": "your amount",
            "address": "to address",
            "status": "withdraw status",
            "time": "update time"
          }
        ],
        "cursor": ""
    },
    "ext_info": null,
    "time_now": 1718476267321
}