注意事项
启用账户
现货交易
现货交易在账户注册后自动启用。用户可以在API创建过程中激活现货交易的API访问权限。
合约交易
要启用合约交易，用户必须首先激活其合约账户。首次创建 API 并设置“合约”权限时，系统将提示用户前往【合约交易】页面完成风险测试题。通过测试后，合约交易账户将被激活，方可进行合约交易。
持仓限制
合约交易
有关合约持仓限制的详细信息，请访问 https://www.coinw.com/trading-rules
频率限制
一、合约交易频率限制
合约交易 API 接口受以下两类频率限制的约束：
(a) 单接口频率限制
对于合约交易，每个RESTful API 接口均有各自的访问频率限制，限制对象为 IP 地址与用户 UID。具体频率限制可在各接口文档的 “频率限制” 字段中查看。
若超过接口的频率限制，将返回如下错误信息：
{"code": 29001,"msg": "API access frequently"}
此错误表示该接口的调用频率超过上限，建议用户检查对应接口的频率设置。
(b) 全局频率限制
除了单接口频率限制外，合约 RESTful 接口还受到全局频率限制，即设定时间内，对用户所有合约 RESTful API 的总请求次数设有限额，确保整体请求量不超出系统承载范围。
A 类：行情类接口（基于 IP 限频）
以下接口归类为 A 类，所有接口请求合并计数，共用限频阈值：
- GET /v1/perpumPublic/klines
- GET /v1/perpumPublic/tickers
- GET /v1/perpumPublic/ticker
- GET /v1/perpumPublic/trades
- GET /v1/perpumPublic/depth
频率限制：A 类接口按 IP 维度合并计数，每个 IP 最多请求 30 次/秒。
B 类：其他接口（基于 UID 限频）
未包含在 A 类中的其他接口归为 B 类，所有接口请求合并计数，共用限频阈值：
频率限制：B 类接口按用户 UID 合并计数，每个 UID 最多允许 100 次请求/秒。
如触发限频，系统将返回如下错误：
{"code": 29001,"msg": "API access frequently"}
在合约交易中，若返回该错误，表示请求频率已超过系统设定的阈值。为保障所有用户的服务稳定性与系统性能，建议开发者实施合理的 API 调用频控机制与监控策略。 注意 除了接口级限频与全局限频之外，系统在整体网络拥堵情况下也可能触发限频机制。此类限制并非由某一用户的请求频率造成，而是因平台整体 API 请求量激增所引发。
二、现货交频率限制
现货交易 API 同样受到以下两类限频控制：
(a) 单接口频率限制
对于现货交易，每个 RESTful API 端点均受基于 IP 和用户 ID 的接口频率限制。每个接口的频率限制记录在每个 API 接口中，具体请参考API接口文档中的“频率限制”部分。
(b) 全局频率限制
除了单接口频率限制外，现货 RESTful API 还受到全局限频限制，即设定时间内，对用户所有现货 RESTful API 的总请求次数设有限额，确保整体请求量不超出系统承载范围。
- 每个 IP 地址：最多 100 次/秒
- 每个用户 ID：最多 300 次/秒
在现货交易中，若请求频率超出接口级或全局频率限制，系统将返回如下错误信息：
{"code": 29001,"msg": "API access frequently"}
在现货交易中，若返回该错误，表示请求频率已超过系统设定 的阈值。为保障所有用户的服务稳定性与系统性能，建议开发者实施合理的 API 调用频控机制与监控策略。 注意: 除了接口级限频与全局限频之外，系统在整体网络拥堵情况下也可能触发限频机制。此类限制并非由某一用户的请求频率造成，而是因平台整体 API 请求量激增所引发。
三、API限频策略– 客户端指南
本指南旨在帮助用户了解如何规范使用 API，并说明正常调用频次范围被超出时，系统将采取的处理机制。
(a) 正常使用次数
只要各接口限频与全局限频均未被触发，且在任意10 秒时间窗口内， API 请求数量保持在下方规定阈值内，您的访问将保持畅通，不会返回任何错误信息。
| 类别 | 限额（每 10 秒） |
|---|---|
| 用户账户（UID） | 60 |
| IP地址 | 80 |
| 设备 + IP | 60 |
注意: 注意：上述限额每 10 秒自动重置，只要在每个时间区间内遵守频率限制，API 使用将不会中断； 若超出正常使用次数，系统将启用更严格的限频控制措施。 为避免触发更严格的限频措施 ，建议您严格遵守上述频率要求。
(b) 如果用户超出正常使用次数，会发生什么？
1. 警告阶段（5分钟）
如果您超出正常使用量，您的 API 访问将进入持续 5 分钟的临时警告阶段。在此阶段：
- 所有 API 端点的每个接口速率限制将降低 50%。示例：如果某个端点最初每 2 秒允许 10 个请求，现在将只允许 5 个请求。
- 您可能会更频繁地遇到“超出速率限制”错误。
如果您的错误数量在 5 分钟内保持在以下列出的阈值范围内，您的 API 访问将自动正常使用次数。
| 类别 | 限额（每 10 秒） |
|---|---|
| 用户账户（UID） | 60 |
| IP地址 | 80 |
| 设备 + IP | 60 |
如果在警告阶段错误计数超过这些阈值，您的 API 访问将被临时封禁。
2. 临时封禁（30秒）
临时封禁阶段：
- 所有 API 访问将被封禁 30 秒。
- 30 秒后，您的访问次数将自动恢复正常使用次数。
但是，8 小时内频繁封禁可能会导致被列入黑名单阶段.
3. 黑名单阶段
如果用户在8小时内被封禁次数超过以下阈值，将被列入黑名单：
| 类别 | 8小时内最大封禁次数 |
|---|---|
| 用户账户（UID） | 10 |
| IP地址 | 10 |
| 设备 + IP | 5 |
在黑名单阶段：
- 所有 API 访问将被禁用 8 小时。
- 用户必须联系客服寻求帮助。
如果 8 小时内未突破阈值，您的 API 访问将恢复正常使用次数。
万能金
CoinW合约提供万能金，可用作初始保证金或抵消合约交易中的交易费用、损失和资金支付。更多详情，请访问 https://coinw.zendesk.com/hc/en-us/articles/23111150445977-Introduction-to-Futures-Mega-Coupon
注意事项
合约交易
-
强烈建议查看每个接口中的"注意事项"部分，以避免任何误解或不便。
-
CoinW 允许交易者在同一币种上同时建立多头与空头头寸，从而实现对冲功能，助力构建更灵活复杂的交易策略。
-
通常，平仓是通过在相反方向下达相同订单来完成的。但是，这种方法在CoinW上不适用。在相反方向下达订单将开设新仓位，而不是关闭原始仓位，导致两个活跃仓位。要正确平仓，请参考合约 > 下单 > 平仓。对于批量平仓，请参考合约 > 下单 > 批量平仓。平台支持三种交易来源：用户自主下单、跟单系统下单、策略广场量化机器人下单，三类交易在持仓层面统一展示，不过 OpenAPI 仅支持对用户自主下单产生的仓位进行操作（如平仓、撤单等）。对于跟单及策略广场产生的仓位，API 无操作权限，相关操作建议使用平台内对应功能完成处理。
-
要设置追踪止损、止盈和止损，请参考合约 > 下单。
-
CoinW 提供用于调整仓位布局的接口。更多详情，请参阅 合约 >账户与资产 >设置持仓模式。选择 “合并持仓”选项时，同一工具和方向的所有头寸将合并为一个持仓;选择“分开持仓”选项时，每个新开仓位将单独列出，并拥有唯一的持仓ID
-
一些接口返回以下响应。"code:0"表示操作成功。
{'code': 0, 'msg': ''} -
资金费时间限制: 在资金费用期间，不允许进行下单或平仓等交易操作。尝试这些操作将导致错误响应。 资金费用流程通常需要 30 至 40 秒。建议至少等待 1 分钟后再尝试交易操作。 具体的资金费用表，请参阅官方网页。
-
用websocket订阅的数据，无法保证推送数据时间戳的保序性，因此建议用户在接收后自行检查与数据清洗。
-
返回订单ID不代表成交。 “返回 orderId 表示系统已受理下单请求，但订单可能在撮合时被撤销，并不代表成交。如需确认成交状态，请调用查询订单或持仓信息API。
现货交易
- 用websocket订阅的数据，无法保证推送数据时间戳的保序性，因此建议用户在接收后自行检查与数据清洗。