Transfers – Kraken

This endpoint returns information on digital asset deposits and withdrawals to and from a Kraken Futures account.

Authentication is required.

Endpoint	Request Type	Permissible API Keys
/api/v3/transfers	GET	Read-only, Read-write, Master

Argument	Type	Required	Description
lastTransferTime	ISO8601 datetime	No	If not provided, returns the last 100 digital asset deposits or withdrawals w.r.t. receivedTime. If provided, returns the 100 entries before lastTransferTime w.r.t. receivedTime

Sample Call

https://futures.kraken.com/derivatives/api/v3/transfers?lastTransferTime=2016-02-26T00:00:00.000Z

Sample Return if Successful

{
    "result":"success",
    "serverTime":"2016-02-25T09:45:53.818Z",
    "transfers":[
        {
            "receivedTime":"2016-01-28T07:09:42.000Z",
            "completedTime":"2016-01-28T08:26:46.000Z",
            "status":"processed",
            "transfer_id":"b243cf7a-657d-488e-ab1c-cfb0f95362ba",
            "transaction_id":"4a5e1e4baab89f3a32518a88c31bc87f618f7
6673e2cc77ab2127b7afdeda33b",
"targetAddress":"1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
            "transferType":"deposit",
            "currency":"xbt",
            "amount":2.58,
        },
        {
            "receivedTime":"2016-01-28T07:09:42.000Z",
            "status":"pending",
            "transfer_id":"b243cf7a-657d-488e-ab1c-cfb0f95362ba",
            "targetAddress":"1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
            "transferType":"withdrawal",
            "currency":"xbt",
            "amount":-49.9999,
        },
        ...,
    ],
}

Field	Type	Description
result	string	Always success
serverTime	ISO8601 datetime	The server date and time
transfers	list of structures	A list containing structures with information on the account’s transfer history, see below. The list is sorted descending by receivedTime
receivedTime	ISO8601 datetime	If transferType is deposit: The date and time the deposit was first detected If transferType is withdrawal: The date and time the withdrawal request was received
completedTime	ISO8601 datetime	If status is processed: The date and time the transfer has been processed and booked If status is pending: Not returned because N/A
status	string	The status of the transfer request, either of: accepted: the withdrawal request was accepted and will be processed soon insufficientAvailableFunds : the withdrawal request was not accepted because available funds are insufficient
transfer_id	UUID	The unique identifier of the transfer
transaction_id	string	If status is processed: The blockchain transaction id of the transfer if the transfer involves an external digital asset address and Internal Transaction if the transaction is sent to an address controlled by Crypto Facilities If status is pending: Not returned because N/A
targetAddress	string	The digital asset address to which the transfer is sent
transferType	string	The type of the transfer, either deposit or withdrawal
amount	float	The digital asset amount that was transferred. Positive for deposits and negative for withdrawals

Sample Return if Unsuccessful

{
   "result":"error",
   "serverTime":"2016-02-25T09:45:53.818Z",
"error":"apiLimitExceeded",
}

Field	Type	Description
result	string	Always error
serverTime	ISO8601 datetime	The server date and time
error	string	The reason the API call failed, either of: apiLimitExceeded: the API limit for the calling IP address has been exceeded authenticationError: the request could not be authenticated accountInactive: the Crypto Facilities account the request refers to is inactive invalidArgument: <argument>:argument"<argument>" is invalid nonceBelowThreshold: <threshold> the provided nonce is below the <threshold> nonceDuplicate: <duplicate> the provided nonce is a duplicate as it has been used in a previous request

Related articles

Related articles