Skip to content
Hightop docs header art
Hightop
Reference

/earn/move

POST/v1/agent/earn/move

Create an earn move operation

Requires API-key authentication (agentAuth, agentId).

Request body

from_position_idrequiredstringExisting earn-position identifier. Always a Base ERC4626 vault contract address (case-insensitive) identifying a vault the wallet holds shares in. Read these from /v1/agent/earn.
move_allboolean
to_vault_idstringEarn vault identifier. Always a Base ERC4626 vault contract address (case-insensitive). Returned in /v1/agent/earn and /v1/agent/earn/opportunities as `vault_id`.
to_best_availableboolean
amountstring
amount_usdstring

Response

okrequiredenum
true
operation_idrequiredstring
statusrequiredenum
accepted · policy_rejected · submitted · executed · execution_failed · cancelled
fee_usdrequiredstring
human_messagestring
repay_amount_usdstring
estimated_ltv_afterstring