Skip to main content

Query Fund Records

Type: GET

Description: /v4/finance/bills

Query user's earn fund records.

Parameters

NameTypeMandatoryDescription
typestringfalseRecord type: SUBSCRIBE, REDEEM, INTEREST, etc.
currencystringfalseCurrency
startTimelongfalseStart time (millisecond timestamp)
endTimelongfalseEnd time (millisecond timestamp)
pageintegerfalsePage number
sizeintegerfalsePage size

Request Example

Request
curl -G "https://sapi.xt.com/v4/finance/bills" \
-H "validate-appkey: $APPKEY" \
-H "validate-timestamp: $TIMESTAMP" \
-H "validate-signature: $SIGNATURE" \
-H "Content-Type: application/json" \
-d "type=SUBSCRIBE" \
-d "page=1" \
-d "size=10"

Response Example

Response
{
"rc": 0,
"mc": "SUCCESS",
"result": {
"hasPrev": false,
"hasNext": true,
"items": [
{
"orderId": "123456789",
"type": "SUBSCRIBE",
"productId": 1001,
"productType": "DEMAND_SAVING",
"amount": "1000.00",
"currency": "USDT",
"status": "SUCCESS",
"createTime": 1700000000000,
"completeTime": 1700000001000
}
]
}
}

Response Fields

FieldTypeDescription
orderIdstringOrder ID
typestringRecord type
productIdlongProduct ID
productTypestringProduct type
amountstringAmount
currencystringCurrency
statusstringStatus
createTimelongCreate time
completeTimelongComplete time