Transfer

This endpoint allows you to transfer funds between two margin accounts with the same collateral currency, or between a margin account and your cash account.

Authentication is required.

Endpoint

Request Type Permissible API Keys
/api/v3/transfer
POST Read-write, Master
Argument Type Required Description
fromAccount
string Yes The name of the cash or margin account to move funds from. The names and balances of the accounts can be seen with the /accounts endpoint.
toAccount
string Yes The name of the cash or margin account to move funds to. The names and balances of the accounts can be seen with the /accounts endpoint.
unit
string Yes The unit to transfer.
amount
positive float Yes The amount to transfer.
Sample Calls

https://futures.kraken.com/derivatives/api/v3/transfer?fromAccount=fi_xbtusd&toAccount=cash&unit=xbt&amount=1.5

https://futures.kraken.com/derivatives/api/v3/transfer?fromAccount=fi_xrpxbt&toAccount=fi_xbtusd&unit=xbt&amount=0.1

https://futures.kraken.com/derivatives/api/v3/transfer?fromAccount=cash&toAccount=fi_xrpusd&unit=xrp&amount=17300

Sample Return if Successful

{  
    "result":"success",
    "serverTime":"2018-05-09T11:48:27.507Z"

}

Field

Type Description
result
string Always success
serverTime
ISO8601 datetime The server date and time

 

Sample Return if Unsuccessful
 {  
   "result":"error",
   "serverTime":"2016-02-25T09:45:53.818Z",
   "error":"invalidUnit",
}

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
  • invalidAccount: the fromAccount or the toAccount are invalid
  • invalidAmount: the amount specified must be positive and specified to at most 11 decimal places
  • insufficientFunds: the fromAccount does not have enough funds to make the transfer
  • 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