如何在Gate.io上创建一个期货API密钥？

通过启用期货交易权限，设置IP白色以进行安全性并完成2FA，在Gate.io上创建一个期货API密钥，然后使用简单的余额提取请求进行测试。

2025/07/23 03:49

了解Gate.io上的Futures API键

Gate.io上的期货API密钥允许交易者自动化交易策略，管理职位并直接从平台中检索实时市场数据。与现货交易密钥不同，未来的API密钥必须明确启用，以获得期货交易许可。这样可以确保您的自动化系统仅与预期的市场领域互动。首先，请确保您有一个经过验证的GATE.IO帐户，并激活了两因素身份验证（2FA），这是API密钥创建的必要条件。

导航到API管理部分

登录到您的gate.io帐户并找到用户仪表板。在右上角，单击您的个人资料图标。从下拉菜单中，选择“ API管理” 。本节是所有API键（包括主动和不活动）的所有API键。如果这是您第一次创建API密钥，则列表将为空。单击蓝色的“创建API”按钮以启动该过程。弹出窗口将出现，提示您配置权限并设置限制。

配置期货交易的权限

在API创建窗口中，您必须指定密钥的范围。在“权限”部分下，启用以下复选框：

• “期货交易” - 这可以授予地点和取消期货订单的关键访问权限。
• “只读期货帐户” - 允许钥匙获得平衡，位置和订购历史记录数据。
• （可选）“转移” - 仅当您的机器人需要在现货和期货帐户之间移动资金时才能启用。
  

  除非您的策略都涉及两个市场，否则请勿启用“现货交易”。保持钥匙尽可能最小，以减少妥协。

  设置IP白名单以进行安全

  
  在“ IP白名单”字段下，输入您的应用程序将从中发送请求的静态IP地址。 Gate.io将拒绝此处未列出的任何IP的API调用。如果您要在本地测试或使用动态IP，请考虑使用具有固定IP的VPS。您可以通过逗号分隔多个IP来添加多个IP。例如：

• '192.168.1.100，203.0.113.50'

  如果您将此字段留空，则API密钥将从任何IP中使用，但是这是高度劝阻的，用于生产使用。输入IPS后，请仔细检查错别字以避免连接问题。

  完成两因素身份验证步骤

  
  在最终确定密钥之前，Gate.io需要2FA代码。在提供的字段中输入您身份验证器应用程序（例如Google Authenticator或Authy）生成的代码。您还需要输入“基金密码” - 这与您的登录密码不同，并且必须在安全设置下提前设置。两者都被验证后，单击“确认” 。该系统将显示您的新API密钥和秘密密钥。这些只会出现一次 - 将它们立即复制到安全的密码管理器或加密文件中。
  

  用简单的请求测试API键

  
  要验证关键作品，请使用curl或Postman之类的工具发送测试请求。例如，获取您的期货帐户余额：

   curl -H 'KEY: YOUR_API_KEY' \ -H 'SIGN: YOUR_SIGNATURE' \ https://api.gate.io/api/v4/futures/usdt/accounts

  用您刚创建的密钥替换YOUR_API_KEY 。签名（ SIGN ）必须使用您的秘密密钥和每个Gate.io API文档的请求参数生成。如果响应以JSON格式返回您的余额，则密钥是功能性的。如果您遇到403错误，请再次检查IP白名单和权限。
  

  安全存储和管理您的API密钥

  
  切勿在脚本或GitHub存储库中进行硬码API密钥和秘密。相反，使用环境变量：

• 导出gateio_api_key ='your_actual_key'
• 导出gateio_api_secret ='your_actual_secret'

  在您的代码中，将它们引用为os.getenv('GATEIO_API_KEY') （python）或process.env.GATEIO_API_KEY （node.js）。如果您怀疑滥用，每90天或立即旋转一次钥匙。您可以随时从同一API管理页面禁用或删除密钥。

  ---

  常见问题

  问：我可以将相同的API密钥用于现货和期货交易吗？
  
  是的，但是只有当您明确启用创建过程中的“现货交易”和“期货交易”权限时。为了获得更好的安全性，建议为每个市场创建单独的密钥。

  问：如果失去秘密钥匙，该怎么办？
  
  您无法恢复它。您必须删除折衷的密钥并创建一个新的密钥。使用旧密钥的任何应用程序都将停止工作，直到使用新凭据更新为止。

  问：即使在实现了期货交易之后，为什么我也会遇到“允许拒绝”错误？
  
  检查请求是否正在发送到期货端点（例如/api/v4/futures/usdt/... ），而不是点端点。另外，请验证您的IP白名单与确切的IP匹配。

  问：是否可以将API密钥限制在不允许安置订单的情况下仅读取期货位置？
  
  是的。在设置过程中，仅启用“仅适用于期货帐户”许可并未选中“期货交易”。这限制了仅获取数据的关键。