Get Status of Recent Withdrawals
POST/private/WithdrawStatus
Retrieve information about recent withdrawals. Results are sorted by recency, use the cursor
parameter to iterate through list of withdrawals (page size equal to value of limit
) from newest to oldest.
API Key Permissions Required: Funds permissions - Withdraw
or Data - Query ledger entries
Request
- application/json
Body
required
- MOD1
- MOD2
Nonce used in construction of API-Sign
header
Filter for specific asset being withdrawn
Default value: currency
Filter for specific asset class being withdrawn
Filter for specific name of withdrawal method
Start timestamp, withdrawals created strictly before will not be included in the response
End timestamp, withdrawals created strictly after will be not be included in the response
cursor object
true/false to enable/disable paginated response (boolean) or cursor for next page of results (string), default false
boolean
string
Default value: 500
Number of results to include per page
Responses
- 200
Recent withdrawals retrieved.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
cancel-pending
cancelation requestedcanceled
canceledcancel-denied
cancelation requested but was deniedreturn
a return transaction initiated by Kraken; it cannot be canceledonhold
withdrawal is on hold pending review- ]
result object[]
Name of withdrawal method
Network name based on the funding method used
Asset class
Asset
Reference ID
Method transaction ID
Method transaction information
Amount withdrawn
Fees paid
Unix timestamp when request was made
Possible values: [Initial
, Pending
, Settled
, Success
, Failure
]
Status of withdraw
For information about the status, please refer to the IFEX financial transaction states.
Possible values: [cancel-pending
, canceled
, cancel-denied
, return
, onhold
]
Addition status properties (if available)
Withdrawal key name, as set up on your account
{
"error": [],
"result": [
{
"method": "Bitcoin",
"aclass": "currency",
"asset": "XXBT",
"refid": "FTQcuak-V6Za8qrWnhzTx67yYHz8Tg",
"txid": "29323ce235cee8dae22503caba7....8ad3a506879a03b1e87992923d80428",
"info": "bc1qm32pq....3ewt0j37s2g",
"amount": "0.72485000",
"fee": "0.00020000",
"time": 1688014586,
"status": "Pending",
"key": "btc-wallet-1"
},
{
"method": "Bitcoin",
"aclass": "currency",
"asset": "XXBT",
"refid": "FTQcuak-V6Za8qrPnhsTx47yYLz8Tg",
"txid": "29323ce212ceb2daf81255cbea8a5...ad7a626471e05e1f82929501e82934",
"info": "bc1qa35ls....3egf0872h3w",
"amount": "0.72485000",
"fee": "0.00020000",
"time": 1688015423,
"status": "Failure",
"status-prop": "canceled",
"key": "btc-wallet-2"
}
]
}