新建低延迟交易SpecialKey(TRADE)
接口描述
- 杠杆交易为VIP4及以上的用户提供了低延迟交易接口，这类接口通过特定的SpecialKey实现杠杆交易。
- 若您的VIP级别为3及以下，请联系您的VIP经理获取相关SpecialKey的使用许可标准。
该接口支持以下产品：
- 全仓杠杆
- 逐仓杠杆
- 统一账户Pro模式
- 全仓杠杆Pro模式（需要签订额外的协议并符合资格标准）
该接口不支持以下产品：
- 统一账户普通模式
我们提供以下3类接口：
- Ed25519 (recommended)
- HMAC
- RSA
这3类接口中，我们推荐用户使用use Ed25519 API keys，它具有最高的性能和安全系数。
我们接受PKCS#8 (BEGIN PUBLIC KEY). 关于如何生成RSA密钥对发送API请求，请参考 FAQ 。
如何使用杠杆专用密钥
- 使用以下
sapi接口创建您的杠杆专用 SpecialKey。 - 关于访问全仓杠杆账户，请勿发送
symbol参数。 - 关于访问逐仓杠杆账户，请在创建 SpecialKey 的请求中传入相关的
symbol参数。 - 使用生成的 SpecialKey（以及对应的 Secret key，如适用）通过 现货 REST API (
https://api.binance.com/api/v3/*) 端点执行杠杆交易和 listenKey 生成操作。
关于如何使用其他API，请参考REST API 或 WebSocket API 。
您需要为special key开通"允许现货及杠杆交易"权限才能调用此接口。
HTTP请求
POST /sapi/v1/margin/apiKey
请求权重
1(UID)
请求参数
| Name | Type | Mandatory | Description |
|---|---|---|---|
| apiName | STRING | YES | |
| symbol | STRING | NO | isolated margin pair |
| ip | STRING | NO | Can be added in batches, separated by commas. Max 30 for an API key |
| publicKey | STRING | NO | 1. If publicKey is inputted it will create an RSA or Ed25519 key. 2. Need to be encoded to URL-encoded format |
| permissionMode | ENUM | NO | 该参数只对Ed25519 API密钥有效，若为其他加密方式不需要传递该参数。取值为 TRADE （TRADE表示所有权限） 或 READ（READ表示 USER_DATA, FIX_API_READ_ONLY）。 默认取值为TRADE。 |
| recvWindow | LONG | NO | The value cannot be greater than 60000 |
| timestamp | LONG | YES |
响应示例
{
"apiKey":"npOzOAeLVgr2TuxWfNo43AaPWpBbJEoKezh1o8mSQb6ryE2odE11A4AoVlJbQoGx",
"secretKey":"87ssWB7azoy6ACRfyp6OVOL5U3rtZptX31QWw2kWjl1jHEYRbyM1pd6qykRBQw8p" //secretKey will be null when creating an RSA key
"type": HMAC_SHA256 //HMAC_SHA256 or RSA
}
常见错误代码：
-
UNSUPPORTED_OPERATION : 该接口不支持统一账户普通模式，请转换账户类型到支持该接口的产品模式。
-
Forbidden: 全仓Pro模式需要签订额外的协议，请联系您的VIP经历获得相应支持。