如何检查Bybit上的API密钥权限

了解 API 密钥权限级别

1. Bybit将API权限分为三个不同的级别：只读、交易和提现。

2. 只读访问允许在不修改任何状态的情况下检索市场数据、账户余额、订单历史和仓位信息。

3. 交易许可允许在现货、保证金和衍生品市场下单、取消和修改订单。

4. 提款权限授予从 Bybit 账户发起资金转账的能力——该权限需要明确的手动激活和额外的安全验证。

5. 每个权限级别在 API 密钥创建期间分配，并且在不生成新密钥对的情况下无法追溯更改。

找到您的 API 密钥仪表板

1. 使用经过验证的凭据登录您的 Bybit 账户并完成 2FA 身份验证。

2. 导航到右上角的用户菜单，然后选择“安全中心”部分下的“API 管理”。

3. 仪表板显示所有活动 API 密钥及其关联标签、创建时间戳和 IP 绑定状态。

4. 单击任意密钥旁边的“详细信息”按钮以显示其完整配置，包括权限标志和白名单 IP。

5. 标记为“仅测试网”的密钥单独出现，并在设计上与主网操作隔离。

通过 API 响应验证权限标志

1. 使用您的 API 密钥和秘密签名向/user/info端点发送 GET 请求。

2. 包含所需的标头： X-BAPI-API-KEY 、 X-BAPI-SIGN 、 X-BAPI-TIMESTAMP和X-BAPI-RECV-WINDOW 。

3. 成功的响应返回一个 JSON 对象，其中包含将启用的功能列为布尔值的权限字段。

4. 如果响应包含'withdraw': true ，则密钥具有撤回权限 - 除非明确要求，否则该值应保持为 false。

5. 任何缺失或不一致的权限指示符都表明配置错误或密钥初始化不完整。

解读实践中的权限限制

1. 仅具有读取权限的 API 密钥在尝试 POST 到/order/create时将返回 HTTP 403。

2. 尝试使用非提现密钥调用/asset/withdraw会触发错误代码10004和描述性消息“无提现权限”。

3. 交易端点强制执行严格验证：在缺少衍生品权限的密钥上提交带有杠杆参数的订单会产生错误11001 。

4. 基于权限范围的速率限制行为变化——交易密钥比只读密钥面临更严格的基于权重的配额。

5. 如果请求源自注册地址范围之外，则无论权限级别如何，IP 绑定密钥都会失败。

常见问题解答

问：API key 创建后可以降级吗？不可以。Bybit 不支持修改现有密钥的权限。您必须停用当前密钥并生成具有所需设置的新密钥。

问：为什么我的 API 密钥显示“Trading: false”，即使我在设置过程中选择了它？当在您的账户设置中启用期货或衍生品交易之前创建密钥时，就会发生这种情况。首先启用这些模块，然后重新生成密钥。

问：有没有办法审核我的密钥已成功访问哪些端点？是的。 Bybit 在 API 管理界面的“API 活动历史记录”选项卡中记录所有经过身份验证的 API 调用，显示时间戳、端点和响应代码。

问：如果我将 API 密钥绑定到 IP 地址并随后更改网络，会发生什么情况？来自未列出 IP 的请求会收到 HTTP 401 ，错误代码为10002 。您必须更新 IP 白名单或禁用绑定才能恢复功能。