Earn

Staking positions, rewards, and movements on the Wallet API.

Earn (staking) lives on the gateway. Every call works for subaccounts too: send X-SUBACCOUNT-ID. REST pages are generated from the Wallet OpenAPI snapshot.

Deposit crypto in Earn

GET /v2/earn/assets lists the currencies Earn accepts. GET /v2/earn/apy returns the current annual percentage yield of each one.

POST /v1/earn/movements
{
  "type": "deposit",
  "currency": "BTC",
  "amount": "0.01"
}

The amount moves from the user's wallet to the Earn wallet. Send lockPeriodId to deposit into a locked Earn wallet. The response carries movementId and walletMovementId.

Withdraw crypto from Earn

GET /v2/earn/wallets shows each Earn wallet with its balance.

Same call with "type": "withdrawal". The amount moves back to the user's wallet.

Reads

CallUse
GET /v2/earn/assetsSupported currencies
GET /v2/earn/apyCurrent APY by currency
GET /v2/earn/walletsList Earn wallets
GET /v1/earn/summaryAggregated rewards
GET /v1/earn/wallets/{walletId}One Earn wallet
GET /v1/earn/wallets/{walletId}/movementsMovement history
GET /v1/earn/wallets/rewards/configGlobal rewards config

Use the REST reference for request bodies. Do not hard-code APY figures: read them from GET /v2/earn/apy.

On this page