适用说明
- 本文适用于：Gate Web 端
- 操作前准备：已完成 Gate 账户注册和登录
- 预计用时：5 分钟
操作目标
本文将指导你如何在 Gate Web 端完成 API Key 的创建和管理。
操作步骤
第一步：进入 API 管理页面
- 登录 Gate 个人账户
- 点击页面右上角的"头像"图标
- 在下拉菜单中选择"API 管理"
第二步：开始创建 API Key
在"API Key 管理"页面，点击"创建 API Key"按钮。
第三步：选择并配置 API Key 类型
创建 API v2 Key：
- 配置 IP 地址权限：
- 可选择绑定特定 IP 地址或不绑定 IP
- 不绑定 IP 将允许任何地址访问，有效期为 90 天
- 选择 API Key 类型：API v2 Key
- 设置权限：选择"读写"或"只读"
- 核实信息无误后，点击"提交"
创建 API v4 Key：
- 填写 API Key 备注：用于辨别和记忆
- 配置 IP 地址权限：可选择绑定或不绑定 IP（不绑定 IP 有效期为 90 天）
- 选择 API Key 类型：API v4 Key
- 选择账户类型：经典账户/统一账户/模拟账户
- 设置权限：选择"读写"或"只读"，并添加交易币对信息
- 核实信息无误后，点击"提交"
第四步：确认安全验证
- 系统弹出风险提示窗口，仔细阅读后勾选"我已知晓"或点击"取消"
- 输入资金密码
- 选择二次验证方式并输入验证码
- 点击"确认"完成创建
第五步：管理已创建的 API Key
创建完成后，可以在 API 管理页面查看和管理所有已创建的 API Key。
注意事项
-
安全提醒：
- 新创建的 API v2 Key 会立即使 API v2 Key 失效（每个用户只能创建 1 组 API v2 Key）
- API Key 可用于查询账户信息、交易操作和提现操作，请妥善保管，切勿泄露给他人
-
提现限制：
- 使用 API 进行提现时，必须是已手动提现过一次的地址
- 地址需要经过 24 小时后才可以通过 API 操作提现
-
IP 绑定建议：
- 建议绑定固定 IP 地址以提高账户安全性
- 不绑定 IP 的 API Key 有效期为 90 天
-
API v2 与 API v4 的区别：
| 对比项 | API v2 | API v4 |
|---|---|---|
| API Key 独立性 | 独立管理 | 独立管理 |
| 交易支持 | 仅支持现货交易 | 支持现货、杠杆和合约的完整交易操作 |
| 申请入口 | 个人账户"API v2 Keys"页面 | 个人账户"API v4 Keys"页面 |
| 数量限制 | 每个用户只能创建 1 组 | 可创建多组 |
- API 限频规则：
| 市场 | 入口 | 限速 | 依据 | 包含 |
|---|---|---|---|---|
| 公共接口 | 公共接口 | 单个接口 200r/10s | IP | 深度、K线、交易对信息等 |
| 钱包 | 私有接口 | 提现接口 1r/3s；uid转账接口 1r/10s；交易账户互转 80r/10s；其他单个接口 200r/10s | UID | 提现、个人账户余额查询、子账户余额查询 |
| 现货 | 私有接口 | 批量/单个下单/修改接口 10r/s；批量/单个撤单接口 200r/s；其他单个接口 200r/10s | UID | 现货下单、撤单、成交历史、费率查询等 |
| 永续合约 | 私有接口 | 批量/单个下单/修改接口 100r/s；批量/单个撤单接口 200r/s；其他单个接口 200r/10s | UID | 合约下单、撤单、成交历史、费率查询等 |
| 交割合约 | 私有接口 | 单个下单接口 500r/10s；单个撤单接口 500r/10s；其他单个接口 200r/10s | UID | 下单、撤单 |
| 期权合约 | 私有接口 | 单个下单接口 200r/s；单个撤单接口 200r/s；其他单个接口 200r/10s | UID | 下单、撤单 |
| 子账户 | 私有接口 | 单个接口 80r/10s | UID | 创建子账户、查询子账户列表、禁用/启用子账户 API Key |
| 保证金 | 私有接口 | 借入或还款 15r/10s | UID | 借入或还款操作 |
| 其他私有接口 | 私有接口 | 单个接口 150r/10s | UID | 理财、抵押借币等 |
WebSocket 限制：
- 发送消息频率：无限制
- 每个 IP 最大连接数：≤ 300
限速触发说明：
- 频率未超过突发上限：请求会被延迟处理
- 超过突发上限：请求会被拒绝
- 子账户使用：
- 限速是每个子账号或主账号单独计算
- 如需更高频率，可使用子账号获得更高的限速频率
常见问题
Q1：如何获取 API 文档？
A：可以在 Gate 网页端首页底部"服务"——"开发者中心"获取完整的 API 文档。
Q2：如果遇到 API 文档中未说明的问题怎么办？
A：请联系客服并提供以下信息以便快速定位问题：
- 账户 ID
- 原始请求 URL、请求参数和请求具体内容
- 使用的 API Key 类型（现货/杠杆/合约模拟/合约实盘）
- 编程语言和代码片段
- 是否使用 SDK（如使用，请说明调用方式或通过 GitHub 留言）
Q3：API v2 和 API v4 应该选择哪个？
A：建议根据您的交易需求选择：
- 如果只需要现货交易，可以选择 API v2
- 如果需要现货、杠杆和合约的完整交易功能，建议选择 API v4
- API v4 支持创建多组 Key，更适合多策略运行
免责声明
本文内容仅供参考与学习目的，不构成任何金融、投资、交易或法律建议，也不构成购买或出售任何数字资产的要约或邀请。Gate 对文中信息的准确性、完整性或时效性不作任何明示或暗示的保证。产品功能、界面、规则及费率等信息可能随时更新或调整，请以 Gate 平台的最新公告及实际页面展示为准。
数字资产投资涉及高风险,价格可能出现大幅波动,您可能损失全部投入资金。请在充分了解相关风险的基础上,根据自身财务状况和风险承受能力谨慎决策。如有需要,建议您咨询独立的专业财务或法律顾问。
有关更多风险信息，请参阅 Gate《风险警示》及《用户协议》。
免责声明
本文内容仅供参考与学习目的，不构成任何金融、投资、交易或法律建议，也不构成购买或出售任何数字资产的要约或邀请。Gate 对文中信息的准确性、完整性或时效性不作任何明示或暗示的保证。产品功能、界面、规则及费率等信息可能随时更新或调整，请以 Gate 平台的最新公告及实际页面展示为准。
数字资产投资涉及高风险，价格可能出现大幅波动，您可能损失全部投入资金。请在充分了解相关风险的基础上，根据自身财务状况和风险承受能力谨慎决策。如有需要，建议您咨询独立的专业财务或法律顾问。
有关更多风险信息，请参阅 Gate 《风险警示》及 《用户协议》。
