期货

端点

下载Schema

查询用户定制 ID

查询用户定制 Id

GET

/papi/v1/apiReferral/userCustomization

https://api.binance.com

查询用户定制 ID › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询用户定制 ID › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

查询用户定制 ID › 查询参数

brokerId

string · 必须

示例： 1

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

查询用户定制 ID › 响应

200

获取用户自定义 ID

brokerId

string

示例： ABCD1234

customerId

string

示例： abc123

用户为自己所在的 API Agent 定制 ID（PAPI） (USER_DATA)

用户为自己所在的 API Agent 定制 ID（PAPI）

POST

/papi/v1/apiReferral/userCustomization

https://api.binance.com

用户为自己所在的 API Agent 定制 ID（PAPI） (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

用户为自己所在的 API Agent 定制 ID（PAPI） (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

用户为自己所在的 API Agent 定制 ID（PAPI） (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

用户为自己所在的 API Agent 定制 ID（PAPI） (USER_DATA) › 请求体

customerId

string · 必须

示例： 1

brokerId

string · 必须

示例： 1

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

用户为自己所在的 API Agent 定制 ID（PAPI） (USER_DATA) › 响应

200

为用户定制 ID

brokerId

string

示例： ABCD1234

customerId

string

示例： abc123

查询用户定制 ID (USER_DATA)

查询用户定制 Id

GET

/fapi/v1/apiReferral/userCustomization

https://api.binance.com

查询用户定制 ID (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询用户定制 ID (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

查询用户定制 ID (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

查询用户定制 ID (USER_DATA) › 查询参数

brokerId

string · 必须

示例： 1

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

查询用户定制 ID (USER_DATA) › 响应

200

获取用户定制 Id

brokerId

string

示例： ABCD1234

customerId

string

示例： abc123

用户为自己所在的 API Agent 定制 ID（合约） (USER_DATA)

用户为自己所在的 API Agent 定制 ID（合约）

POST

/fapi/v1/apiReferral/userCustomization

https://api.binance.com

用户为自己所在的 API Agent 定制 ID（合约） (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

用户为自己所在的 API Agent 定制 ID（合约） (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

用户为自己所在的 API Agent 定制 ID（合约） (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

用户为自己所在的 API Agent 定制 ID（合约） (USER_DATA) › 请求体

customerId

string · 必须

示例： 1

brokerId

string · 必须

示例： 1

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

用户为自己所在的 API Agent 定制 ID（合约） (USER_DATA) › 响应

200

为用户定制 ID

brokerId

string

示例： ABCD1234

customerId

string

示例： abc123

查询用户邮箱和定制 ID（合约） (USER_DATA)

查询用户邮箱和定制 ID（Futures）

GET

/fapi/v1/apiReferral/customization

https://api.binance.com

查询用户邮箱和定制 ID（合约） (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询用户邮箱和定制 ID（合约） (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

查询用户邮箱和定制 ID（合约） (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

查询用户邮箱和定制 ID（合约） (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

customerId

string

示例： 1

email

string

示例： null

page

integer · int64

示例： null

默认值： 1

limit

integer · int64 · max: 1000

示例： 100

默认值： 100

recvWindow

integer · int64 · max: 60000

示例： 5000

查询用户邮箱和定制 ID（合约） (USER_DATA) › 响应

200

获取用户邮箱与自定义 ID

object

customerId

string

示例： abc123

email

string

示例： [email protected]

为用户定制 ID（合约，仅支持 brokerId 持有者） (USER_DATA)

为用户定制 ID（合约，仅支持 brokerId 拥有者）

POST

/fapi/v1/apiReferral/customization

https://api.binance.com

为用户定制 ID（合约，仅支持 brokerId 持有者） (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

为用户定制 ID（合约，仅支持 brokerId 持有者） (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

为用户定制 ID（合约，仅支持 brokerId 持有者） (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

为用户定制 ID（合约，仅支持 brokerId 持有者） (USER_DATA) › 请求体

customerId

string · 必须

示例： 1

email

string · 必须

示例： null

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

为用户定制 ID（合约，仅支持 brokerId 持有者） (USER_DATA) › 响应

200

为用户定制 ID

customerId

string

示例： abc123

email

string

示例： [email protected]

获取账户损益资金流水 (USER_DATA)

获取账户损益资金流水

GET

/fapi/v1/income

https://api.binance.com

获取账户损益资金流水 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

获取账户损益资金流水 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

获取账户损益资金流水 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

获取账户损益资金流水 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

symbol

string

示例： BTCUSDT

incomeType

string · enum

枚举值:

TRANSFER

WELCOME_BONUS

REALIZED_PNL

FUNDING_FEE

COMMISSION

INSURANCE_CLEAR

示例： TRANSFER

startTime

integer · int64

起始时间

示例： 1623319461670

endTime

integer · int64

结束时间

示例： 1641782889000

limit

integer · int64 · max: 1000

示例： 100

默认值： 100

recvWindow

integer · int64 · max: 60000

示例： 5000

获取账户损益资金流水 (USER_DATA) › 响应

200

获取收益历史

object

symbol

string

示例： BTCUSDT

incomeType

string

示例： TRANSFER

income

string

示例： -0.37500000

asset

string

示例： USDT

info

string

示例：

time

integer · int64

示例： 1570608000000

获取返佣数据总览 (USER_DATA)

获取返佣数据总览

GET

/fapi/v1/apiReferral/overview

https://api.binance.com

获取返佣数据总览 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

获取返佣数据总览 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

获取返佣数据总览 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

获取返佣数据总览 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

type

integer · int64

1：U本位合约，2：币本位合约

示例： 1

默认值： 1

recvWindow

integer · int64 · max: 60000

示例： 5000

获取返佣数据总览 (USER_DATA) › 响应

200

获取返佣数据总览

brokerId

string

示例： ABCD1234

newTraderRebateCommission

string

示例： 0.30000000

oldTraderRebateCommission

string

示例： 0.20000000

totalTradeUser

integer · int64

示例： 13

unit

string

示例： USDT

totalTradeVol

string

示例： 405.54379000

totalRebateVol

string

示例： 0.01833800

time

integer · int64

示例： 1597708800000

获取每天返佣金额 (USER_DATA)

获取每天返佣金额

GET

/fapi/v1/apiReferral/rebateVol

https://api.binance.com

获取每天返佣金额 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

获取每天返佣金额 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

获取每天返佣金额 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

获取每天返佣金额 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

type

integer · int64

1：U本位合约，2：币本位合约

示例： 1

默认值： 1

startTime

integer · int64

起始时间

示例： 1623319461670

endTime

integer · int64

结束时间

示例： 1641782889000

limit

integer · int64 · max: 1000

示例： 100

默认值： 500

recvWindow

integer · int64 · max: 60000

示例： 5000

获取每天返佣金额 (USER_DATA) › 响应

200

获取返佣金额

object

unit

string

示例： USDT

rebateVol

string

示例： 0.00023200

time

integer · int64

示例： 1586736000000

获取交易者每天交易明细 (USER_DATA)

获取交易者每天交易明细

GET

/fapi/v1/apiReferral/traderSummary

https://api.binance.com

获取交易者每天交易明细 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

获取交易者每天交易明细 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

获取交易者每天交易明细 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

获取交易者每天交易明细 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

customerId

string

示例： 1

type

integer · int64

1：U本位合约，2：币本位合约

示例： 1

默认值： 1

startTime

integer · int64

起始时间

示例： 1623319461670

endTime

integer · int64

结束时间

示例： 1641782889000

limit

integer · int64 · max: 1000

示例： 100

默认值： 500

recvWindow

integer · int64 · max: 60000

示例： 5000

获取交易者每天交易明细 (USER_DATA) › 响应

200

获取交易者明细

object

customerId

string

示例： sde001

unit

string

示例： USDT

tradeVol

string

示例： 9.57083000

rebateVol

string

示例： 0.00035400

time

integer · int64

示例： 1586736000000

获取交易者数量 (USER_DATA)

获取交易者数量

GET

/fapi/v1/apiReferral/traderNum

https://api.binance.com

获取交易者数量 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

获取交易者数量 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

获取交易者数量 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

获取交易者数量 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

type

integer · int64

1：U本位合约，2：币本位合约

示例： 1

默认值： 1

startTime

integer · int64

起始时间

示例： 1623319461670

endTime

integer · int64

结束时间

示例： 1641782889000

limit

integer · int64 · max: 1000

示例： 100

默认值： 500

recvWindow

integer · int64 · max: 60000

示例： 5000

获取交易者数量 (USER_DATA) › 响应

200

获取交易者数量

object

newTrader

string

示例： 1

oldTrader

string

示例： 2

time

integer · int64

示例： 1586736000000

获取用户每天交易量 (USER_DATA)

获取用户每天交易量

GET

/fapi/v1/apiReferral/tradeVol

https://api.binance.com

获取用户每天交易量 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

获取用户每天交易量 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

获取用户每天交易量 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

获取用户每天交易量 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

type

integer · int64

1：U本位合约，2：币本位合约

示例： 1

默认值： 1

startTime

integer · int64

起始时间

示例： 1623319461670

endTime

integer · int64

结束时间

示例： 1641782889000

limit

integer · int64 · max: 1000

示例： 500

默认值： 500

recvWindow

integer · int64 · max: 60000

示例： 5000

获取用户每天交易量 (USER_DATA) › 响应

200

获取用户交易量

object

unit

string

示例： USDT

tradeVol

string

示例： 53.60756000

time

integer · int64

示例： 1586736000000

查询是否属于新用户 (USER_DATA)

查询是否属于新用户

GET

/papi/v1/apiReferral/ifNewUser

https://api.binance.com

查询是否属于新用户 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询是否属于新用户 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

查询是否属于新用户 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

查询是否属于新用户 (USER_DATA) › 查询参数

brokerId

string · 必须

示例： 1

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

type

integer · int64

1：U本位合约，2：币本位合约

示例： 1

默认值： 1

recvWindow

integer · int64 · max: 60000

示例： 5000

查询是否属于新用户 (USER_DATA) › 响应

200

新用户状态

brokerId

string

示例： ABCD1234

rebateWorking

boolean

示例： false

ifNewUser

boolean

示例： true

查询是否属于新用户 (USER_DATA)

查询是否属于新用户

GET

/fapi/v1/apiReferral/ifNewUser

https://api.binance.com

查询是否属于新用户 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询是否属于新用户 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重100

查询是否属于新用户 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

查询是否属于新用户 (USER_DATA) › 查询参数

brokerId

string · 必须

示例： 1

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

type

integer · int64

1：U本位合约，2：币本位合约

示例： 1

默认值： 1

recvWindow

integer · int64 · max: 60000

示例： 5000

查询是否属于新用户 (USER_DATA) › 响应

200

查询是否属于新用户

brokerId

string

示例： ABCD1234

rebateWorking

boolean

示例： false

ifNewUser

boolean

示例： true