Transfers

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