Skip to main content

Query Transfer List (PREDICTION_TRADE)

API Description

Get the authenticated user's prediction wallet transfer history within a date range.

HTTP Request

GET /sapi/v1/w3w/wallet/prediction/transfer/list

Request Weight(IP)

200

Request Parameters

NameTypeMandatoryDescription
walletAddressSTRINGYESUser's prediction wallet address
startDateSTRINGYESStart date. Format: yyyy-MM-dd. Must be ≤ endDate
endDateSTRINGYESEnd date. Format: yyyy-MM-dd. Must be ≥ startDate
tokenSymbolSTRINGNOFilter by token symbol (e.g. USDT)
directionSTRINGNOFilter by direction. Enum: INBOUND, OUTBOUND
offsetINTNOPagination offset. Default: 0, min: 0
limitINTNOPage size. Default: 20, range: 1–100

Response Example

{
"transfers": [
{
"transferId": "tf_20260525_out_001",
"direction": "OUTBOUND",
"status": "SUCCESS",
"walletAddress": "0x12e32db8817e292508c34111cbc4b23340df542c",
"fromToken": "USDT",
"fromTokenAmount": "100.00",
"toToken": "USDT",
"toTokenAmount": "100.00",
"errorCode": null,
"errorMessage": null,
"createTime": "2026-05-25T04:00:00.000+00:00",
"updateTime": "2026-05-25T04:00:05.000+00:00",
"completeAt": "2026-05-25T04:00:05.000+00:00"
},
{
"transferId": "tf_20260525_in_001",
"direction": "INBOUND",
"status": "SUCCESS",
"walletAddress": "0x12e32db8817e292508c34111cbc4b23340df542c",
"fromToken": "USDT",
"fromTokenAmount": "50.00",
"toToken": "USDT",
"toTokenAmount": "50.00",
"errorCode": null,
"errorMessage": null,
"createTime": "2026-05-24T08:00:00.000+00:00",
"updateTime": "2026-05-24T08:00:05.000+00:00",
"completeAt": "2026-05-24T08:00:05.000+00:00"
}
]
}