Listen Key

生成 Listen Key

响应

{
  "listenKey": "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s61cv6a81va65sdf19v8a65a1"
}

接口权限要求: 账户读 / SPOT_ACCOUNT_R

HTTP请求

• POST /api/v3/userDataStream

开始一个新的数据流。除非发送 keepalive，否则数据流于60分钟后关闭。

参数:

NONE

获取有效 Listen Key

响应

{
    "total": 200,
    "listenKey": [
        "342e83dfc434e8a5639a6f405d3cf9dc3caaf11ca6f6b9a475a6f2e9a4e1bf8d",
        "c716a755cc12fc905159c4f318920ccd25938224230d676431607735609719ed"
    ],
    "available": 198
}

接口权限要求: 账户读 / SPOT_ACCOUNT_R

HTTP请求

• GET /api/v3/userDataStream

获取当前所有有效的listenKey

请求参数

NONE

返回参数

参数名	数据类型	说明
listenKey	string	listenKey
total	string	总listenKey数
available	string	可用listenKey数

延长 Listen Key 有效期

响应

{
    "listenKey": "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s61cv6a81va65sdf19v8a65a1"
}

HTTP请求

• PUT /api/v3/userDataStream

有效期延长至本次调用后60分钟,建议每30分钟发送一次请求。

请求参数:

参数名	数据类型	是否必需	说明
listenKey	string	是

关闭 Listen Key

响应

{
    "listenKey": "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s61cv6a81va65sdf19v8a65a1"
}

HTTP请求

• DELETE /api/v3/userDataStream

关闭用户数据流。

请求参数:

参数名	数据类型	是否必需	说明
listenKey	string	是