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
| Call | Use |
|---|---|
GET /v2/earn/assets | Supported currencies |
GET /v2/earn/apy | Current APY by currency |
GET /v2/earn/wallets | List Earn wallets |
GET /v1/earn/summary | Aggregated rewards |
GET /v1/earn/wallets/{walletId} | One Earn wallet |
GET /v1/earn/wallets/{walletId}/movements | Movement history |
GET /v1/earn/wallets/rewards/config | Global rewards config |
Use the REST reference for request bodies. Do not hard-code APY figures: read them from GET /v2/earn/apy.