Kraken Earn Deallocate Status API 就绪清单

决策矩阵

来源地图

• Kraken Developers：Deallocate Earn Funds（kraken-deallocate-earn）
• Kraken Developers：Get Deallocation Status（kraken-deallocation-status）
• Kraken Developers：Get Allocation Status（kraken-allocation-status）
• Kraken Developers：Get API Key Info（kraken-api-key-info）

控制说明

1. Permission scope

这一项要求读者先把公开来源翻译成操作规则。这里的含义是：Earn operations depend on key permissions rather than general login state。可执行动作是：confirm the key has only the permissions needed for the test。仍然未知的是：private account policy not visible in public docs。因此本文不会把未知部分包装成收益承诺、牌照承诺、审批保证、恢复保证、结算保证、可用性保证、价格暗示或平台排名。

2. Strategy identity

这里的含义是：the strategy ID anchors which Earn position is being changed。可执行动作是：record strategy ID as a non-secret operational identifier。仍然未知的是：renamed strategies in a private account UI。

操作测试也必须很窄。这就是本节保留边界的原因。

3. Nonce handling

这里的含义是：authenticated calls require nonce and signature handling。可执行动作是：use the client library or signing routine without logging secrets。仍然未知的是：clock or nonce-window edge cases under retries。

操作测试也必须很窄。这就是本节保留边界的原因。

4. Async status

这里的含义是：deallocation can require status polling before it is final。可执行动作是：poll status and record pending false before downstream accounting。仍然未知的是：latency during exchange-side maintenance。

操作测试也必须很窄。这就是本节保留边界的原因。

5. Operation concurrency

这里的含义是：one operation can be in progress for a strategy。可执行动作是：avoid parallel deallocation attempts on the same strategy。仍然未知的是：operator race conditions across multiple bots。

操作测试也必须很窄。这就是本节保留边界的原因。

6. Error mapping

这里的含义是：minimum amount, busy state and invalid strategy errors need separate recovery actions。可执行动作是：map each error to a stop rule instead of blind retry。仍然未知的是：future API error wording changes。

操作测试也必须很窄。这就是本节保留边界的原因。

7. Evidence hygiene

这里的含义是：debugging can prove status without leaking authentication material。可执行动作是：log endpoint name, non-secret error class, timestamp and request intent only。仍然未知的是：screenshots that accidentally reveal balances or key names。

操作测试也必须很窄。这就是本节保留边界的原因。

仍需明确的未知项

• private account policy not visible in public docs
• renamed strategies in a private account UI
• clock or nonce-window edge cases under retries
• latency during exchange-side maintenance
• operator race conditions across multiple bots
• future API error wording changes
• screenshots that accidentally reveal balances or key names

实用结论

Kraken Earn API 操作应被视为异步资金控制流程，而不是一次按钮点击的结果。Kraken 文档说明，Deallocate Earn Funds 需要 Earn Funds API key permission、amount 与 strategy ID，并且当返回 202 时需要轮询 deallocation status；状态端点还会暴露 pending state，Get API Key Info 可查看 key 的 permission、restriction 与 usage timestamp。实用结论是：在把资金视为可用之前，先核验 key permission、strategy ID、nonce handling、同一 strategy 一次只能有一个操作，以及 status polling。 本文停在证据边界内，帮助读者决定下一步核验什么，而不是把公开文档改写成私人账户、钱包、回调、政策框架、结算路径或流动性头寸在任何未来条件下都能成功的承诺。