Allocate Earn Funds

curl --request POST \
  --url https://api.kraken.com/0/private/Earn/Allocate \
  --header 'API-Key: <api-key>' \
  --header 'API-Sign: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "4.3",
  "nonce": 30295839,
  "strategy_id": "ESRFUO3-Q62XD-WIOIL7"
}
'

{
  "error": [],
  "result": true
}

Earn

Allocate Earn Funds

Allocate funds to the Strategy.

Requires the Earn Funds API key permission. The amount must always be defined.

This method is asynchronous. A couple of preflight checks are performed synchronously on behalf of the method before it is dispatched further. The client is required to poll the result using the /0/private/Earn/AllocateStatus endpoint.

There can be only one (de)allocation request in progress for given user and strategy at any time. While the operation is in progress:

pending attribute in /Earn/Allocations response for the strategy indicates that funds are being allocated,
pending attribute in /Earn/AllocateStatus response will be true.

Following specific errors within Earnings class can be returned by this method:

Minimum allocation: EEarnings:Below min:(De)allocation operation amount less than minimum
Allocation in progress: EEarnings:Busy:Another (de)allocation for the same strategy is in progress
Service temporarily unavailable: EEarnings:Busy. Try again in a few minutes.
User tier verification: EEarnings:Permission denied:The user's tier is not high enough
Strategy not found: EGeneral:Invalid arguments:Invalid strategy ID

POST

private

Earn

Allocate

Allocate Earn Funds

curl --request POST \
  --url https://api.kraken.com/0/private/Earn/Allocate \
  --header 'API-Key: <api-key>' \
  --header 'API-Sign: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "4.3",
  "nonce": 30295839,
  "strategy_id": "ESRFUO3-Q62XD-WIOIL7"
}
'

{
  "error": [],
  "result": true
}

Authorizations

API-Key

string

header

required

The "API-Key" header should contain your API key.

API-Sign

string

header

required

Authenticated requests should be signed with the "API-Sign" header, using a signature generated with your private key, nonce, encoded payload, and URI path.

Body

application/json

Allocation amount in asset specified in the strategy

nonce

integer<int64>

required

Nonce used in construction of API-Sign header

amount

string

required

The amount to allocate.

strategy_id

string

required

A unique identifier of the chosen earn strategy, as returned from /0/private/Earn/Strategies.

Response

200 - application/json

Response

error

string[]

Kraken API error

result

boolean | null

Will return true when the operation is successful, null when an error occurred.

⌘I