从Beta版迁移

最近更新 2026年8月20日

本文适用于在Beta访问模式下创建的组织。在该模式下，管理员需逐一为每位成员分配权限。现在，访问权限由工作流配置文件和账户角色构成，Kraken将为您自动完成组织的迁移。

迁移前，请注意以下两点：

  • 如果您使用API密钥，请检查其在组织中的行为。现有调用将继续在主账户上运行。请使用account_id选择其他账户，并将提款调用成功视为请求已提交，而非资金已转移的证明。请参阅下文“检查API行为”。
  • 我们将请您确认是否已准备就绪。在您确认变更之前，组织不会完成迁移。

迁移不会移除任何访问权限。每位成员原有的所有权限均将保留。

现有API密钥不会被撤销或重新签发。其登录凭证、权限及账户映射均完整保留。未传入account_id的现有调用将继续在组织的主账户上运行。请检查您的集成如何选择其他账户，以及如何读取提款响应。

按需指定账户

省略account_id时，私有请求将在主账户上执行：

bash

Bash

POST /0/private/AddOrder

如需在特定账户上执行操作，请将account_id作为查询参数附加到URL中：

bash

Bash

POST /0/private/AddOrder?account_id=W5PB62NTPNYT6TYH

请将参数附在 URL 中，而非请求体内。显式传入的 account_id 优先级高于主账户默认值。这不会扩展密钥的账户映射范围或权限。

解读新的提款响应

WithdrawFunds会同时返回approval_request_id和refid：

bash

Bash

{
  "error": [],
  "result": {
    "refid": "FTcLNGa-4ZWmo4GCo8wrBNZz5v53v9",
    "approval_request_id": "656a021a-1d55-42c9-853a-aea57bf5abd1"
  }
}
  • refid不再代表提款已完成。请求提交后，相应金额将锁定在来源账户，仅在请求获批后才完成结算。
  • approval_request_id是该提款请求对应审批的操作句柄。请将其与自有记录关联保存。
  • 待审批的提款请求不会显示在WithdrawStatus中。被拒绝或已到期的请求不会生成任何提款记录，因此未出现在WithdrawStatus中，并不意味着提款从未提交。

若自动化流程将refid视为提款完成的凭证，则在请求仍处于审批队列期间，系统将错误地把提款标记为已结算。完整模型说明请参阅API密钥。

转化完成后，组织将获得两套标准构建模块。

工作流配置文件

工作流配置文件用于定义成员在各受管工作流上可执行的操作。每位成员仅持有一个。

个人简介

包含权限

管理

所有工作流的全部权限级别，包括执行权限

发起人

所有工作流的查看与发起权限。无审批权限

审批人

所有工作流的查看与审批权限。无发起权限

审核人

所有工作流的查看权限。无操作权限

资金管理员

提款请求和划转请求的查看、发起与审批权限。管理地址的查看与发起权限

账户角色

账户角色定义成员在您名下各账户上可执行的操作。标准角色覆盖所有现有及未来账户，因此持有“交易所有账户”角色的成员，可在您日后新建的账户上直接进行交易。

角色

对每个账户授予的权限

读取全部

阅读

交易全部

交易

资金全部

划转、提币、理财申购、理财赎回

完全权限

全部账户权限

标准配置文件和角色会随产品同步更新：每当新增工作流时，持有相应配置文件的成员将自动获得对应权限级别。完整模型详见角色、配置文件与权限。

若成员的权限与任何标准配置文件均不匹配，系统将为其创建一个角色，完整保留其原有权限。权限完全相同的成员共享同一角色，因此组织的角色数量将远少于成员数量。

这些角色以您为成员设置的标签命名，例如标签为“Trader”的成员，对应角色名称为trader。未设置标签的成员将归入migrated-role角色。每个此类角色均带有migrated标记，表示名称为系统生成，您可自行修改。

提示：

转化完成后，建议优先将这些角色重命名为您实际使用的称谓。编辑角色后，migrated标记将自动清除。

为何“Admin”成员未被分配到Admin配置文件

Beta版的“Admin”标签允许成员查看、发起和审批，但无法在无需二次审批的情况下完成自己提交的请求。Admin配置文件包含该能力，对应权限级别为Execute（执行）。

为避免自动授予此权限，持有旧标签的成员将被分配到名为beta-admin的角色，仅保留其原有权限。如需将其迁移至Admin，在您决定时完成一次角色分配即可。

注意：Kraken Futures 目前不对美国和其他国家/地区的客户开放。

beta-admin属于您的自定义角色，持有该角色的成员不会像标准配置文件那样自动获得新工作流的权限。这也是建议在转化完成后尽快审查这些角色的原因之一。

所有者将被置于Admin配置文件，保留原有的全部权限，并自动获取新工作流。所有者同时持有“Read all”角色，该角色无法移除。

若您此前主动缩减了所有者的权限，该设置将予以保留：所有者将转换为一个与其他成员相同、仅持有其实际权限的角色。

  • 每位成员原有的所有权限均将保留。
  • API密钥登录凭证、权限及账户映射均保持不变。
  • 余额、账户及账户归属均不受影响。
  • 进行中的审批请求将继续执行，策略、审批阈值及“始终要求审批”设置均保持不变。
  • 身份验证不受影响，所有成员无需重新登录或重新接受邀请。
  • 仅属于本组织的账户会被转换。组织以外账户的权限维持原状。

疑难解答

未传入account_id的调用将在组织的主账户上执行。如需查询密钥账户映射中的其他账户，请在URL中传入该账户的account_id。请参阅“按需选择指定账户”。

该调用已创建请求，并在来源账户上锁定对应金额。审批通过后方可结算。请使用调用返回的approval_request_id跟踪请求，或前往Requests页面查看。请参阅划转与提款。

权限与标准配置文件不符的成员，各自需要一个保留其访问权限的角色；仅当两名成员权限完全相同时，才会合并至同一角色。即便权限相同，被赋予不同标签的成员仍会保留各自的角色，因为标签本身表明该区分是有意为之。如需精简角色，可将相应成员重新分配后删除空角色。

负责管理组织、团队访问权限、账户或API密钥的成员将被赋予“读取全部”角色，因为管理账户意味着需具备查看权限。若权限范围超出需求，可将“读取全部”替换为仅限特定账户的账户角色。

不可以，此转换为单向操作。转换后的所有内容均可编辑，原有的访问权限配置均可通过配置文件和角色重新搭建。

相关文章