Query Buy Crypto

Query Buy Crypto.

API rate limit: 300 req / min

HTTP Request

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

Request Parameters

Parameter	Required	Type	Comments
orderId	false	string	Order Id
startTime	false	integer	Start timestamp (seconds)
endTime	false	integer	End timestamp (seconds)
pageSize	false	integer	Quantity limit per page. [1, 50]. Default: 20
cursor	false	string	Cursor. Used for pagination

Response Parameters

Parameter	Type	Comments
rows	array	Object
> orderId	string	Order Id.
> crypto	string	Crypto
> crypto_amount	string	Crypto amount
> fiat	string	Fiat
> fiat_amount	string	Fiat amount
> trans_status	int	Status 0- Paid 1- In Progress 2- Pending Payment 3- Completed 4- Under Appeal 5- Cancelled 6- Failed
> platform	string	Platform
> unitPrice	string	Price(fiat/crypto)
> time	string	Time
> side	string	Trading direction
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/fiat/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 = {}

create_request(apiKey, secret, params)

Response Example

{
    "ret_code": 0,
    "ret_msg": "OK",
    "ext_code": "",
    "result": {
        "rows": [
          {
            "order_id": "1392502109169127424",
            "crypto": "USDT",
            "crypto_amount": "0",
            "fiat": "USD",
            "fiat_amount": "10",
            "trans_status": 5,
            "platform": "AIchemypay",
            "unitPrice": "0",
            "time": "1752068774",
            "side": "buy",
            "user_id": "101421193"
          }
        ],
        "cursor": ""
    },
    "ext_info": null,
    "time_now": 1718476267321
}