如何使用 API

5 小时 28 分 30 秒之前
627,699 阅读量
131

1. 登录 Gate 个人账户,点击右上角 “头像”—“API管理”。

1

2. 在“API Key 管理”页面,点击“创建 API Key”。

1

3. 创建 API Key

APIv2 Key 创建:

① 输入 IP 地址权限:可选择绑定/不绑定 IP。注意:不绑定 IP 将允许任何地址访问,有效期为 90 天。

② API Key 类型:选择API v2 Key。每个用户只可创建 1 组,新创建的将覆盖之前。权限可选择读写/只读。

③ 核实无误后,点击“提交”。

注:新的API Keys产生后,旧的API Keys将立即失效。

使用API Keys 可以通过程序查询该账号信息、进行交易操作/提现操作等,请妥善保管,切勿泄露API Keys给他人!避免造成不必要的损失。

APIv4 Key 创建:

① API Key 备注: 助于辨别和记忆。

② 输入 IP 地址权限:可选择绑定/不绑定IP。注意:不绑定IP将允许任何地址访问,有效期为90天。

③ API Key类型:选择 API v4 Key。

④ 账户类型:可选择经典/统一/模拟账户。

⑤ 权限:可选择读写/只读。注意:币对信息不能为空,添加交易后方可保存。

⑥ 核实无误后,点击“提交”。

4. 提交后会弹出风险提示,请仔细阅读,勾选并点击“我已知晓”或点击“取消”。

输入资金密码,选择二次验证方式后输入验证码,点击“确认”。

5. 创建完成,可对创建的API进行管理。

6. 注意事项:

① APIv2/4 目前支持提币、充值操作。使用API进行提现,必须要是手动提现过一次的地址,并且经过24小时才可以操作提现;

② APIv2 与 APIv4 的区别:

  • 两者的 API Key 是独立的;
  • APIv2 在交易操作上只支持现货交易,APIv4 支持现货、杠杆和合约的完整交易操作;
  • APIv2 在个人账户的 “APIv2 Keys” 入口申请,APIv4 在个人账户的 “APIv4 Keys” 页面申请。

请根据个人当前状况自行选择,更新情况请注意文档的更新。

如文档说明中未能为您遇到的问题提供帮助,请您提交工单进行反馈。提交问题中请写明以下信息,以便快速定位您的问题并为您解决。

请尽可能提供以下相关信息: ID,原始的请求 URL、请求参数和请求具体内容、使用的 API Key 是现货/杠杆,合约模拟/合约实盘、编程语言(最好提供一段发送请求的代码片段)、 是否使用了 SDK(如使用 SDK ,请说明调用方式或可通过 Github 留言)。

7. API 文档可在网页端首页底部“服务”——“开发者中心”获取。

1

8. 限频规则

市场 入口 限速 依据 包含
公共接口 公共接口 单个接口 200r/10s IP 深度、K线、交易对信息等
钱包 私有接口 提现接口(POST /withdrawals) 1r/3s
提现uid转账接口(POST /withdrawals/push) 1r/10s
交易账户互转接口 (POST /wallet/transfers) 80r/10s
主子账号互转 (POST /wallet/sub_account_transfers) 80r/10s
子账号与子帐号互转 (POST /wallet/sub_account_to_sub_account) 80r/10s
查询个人账户总额 (GET /wallet/total_balance) 80r/10s
查询子账号余额信息 (GET /wallet/sub_account_balances) 80r/10s
查询子账号逐仓杠杆账户余额信息 (GET /wallet/sub_account_margin_balances) 80r/10s
查询子账号永续合约账户余额信息 (GET /wallet/sub_account_futures_balances) 80r/10s
查询子账号全仓杠杆账户余额信息 (GET /wallet/sub_account_cross_margin_balances) 80r/10s
钱包其他单个接口 200r/10s
UID 提现
个人账户余额查询
子账户余额查询
现货 私有接口 现货批量/单个下单/单个修改接口一共订单数 10r/s (uid+市场)
现货批量/单个撤单接口一共 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 创建普通子账户
查询子账户列表
禁用、启用子账户APIKEY
保证金 私有接口 借入或还款 15/10s UID 借入或还款(POST /unified/loans)
其他私有接口 私有接口 单个接口 150r/10s UID 理财、抵押借币等

限速是每个子账号或主账号单独计算的,如果需要更高的频率,可以使用子账号来获得更高的限速频率。

WebSocket:

  • 发送消息频率:无限制
  • 每个 IP 最大连接数: ≤ 300

注意:
触发限速上限后,如果:

  • 频率没有超过突发上限,请求会被延迟处理
  • 超过突发上限,请求会被拒绝
立即注册,最高可领 $10,000 迎新奖励
signup-tips