账户接口

端点

下载Schema

调整全仓最大杠杆 (USER_DATA)

调整全仓最大杠杆倍数

POST

/sapi/v1/margin/max-leverage

https://api.binance.com

调整全仓最大杠杆 (USER_DATA) › 授权

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

调整全仓最大杠杆 (USER_DATA) › 请求权重

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

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

账户权重

3000, 1 times/min per IP

调整全仓最大杠杆 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

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

示例： API_KEY

调整全仓最大杠杆 (USER_DATA) › 请求体

maxLeverage

integer · int64 · 必须

只能调整3, 5 , 或者 10。举例: maxLeverage = 5 或者3是选择全仓Classic模式； maxLeverage=10 是选择切换成全仓 Pro 模式下的10倍杠杆或者 20倍杠杆（在合规允许的情况下）。

示例： 3

timestamp

integer · int64 · 必须

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

示例： 1770736694138

调整全仓最大杠杆 (USER_DATA) › 响应

200

Adjust cross 杠杆最大leverage

success

boolean

成功.

示例： true

查询杠杆逐仓账户信息 (USER_DATA)

查询杠杆逐仓账户信息

GET

/sapi/v1/margin/isolated/account

https://api.binance.com

查询杠杆逐仓账户信息 (USER_DATA) › 授权

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

查询杠杆逐仓账户信息 (USER_DATA) › 请求权重

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

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

IP 权重10

查询杠杆逐仓账户信息 (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

symbols

string · max: 5

Max 5 交易对s can be sent; separated by ",".

示例： BTCUSDT,BNBUSDT,ADAUSDT

recvWindow

integer · int64 · max: 60000

示例： 5000

查询杠杆逐仓账户信息 (USER_DATA) › 响应

200

Isolated 杠杆账户 Info

object[]

assets 列表.

object

base 资产 object.

asset

string

资产.

示例： BTC

borrowEnabled

boolean

借款启用.

示例： true

borrowed

string

借入.

示例： 0.00000000

free

string

可用.

示例： 0.00000000

interest

string

利息.

示例： 0.00000000

locked

string

冻结.

示例： 0.00000000

netAsset

string

净值资产.

示例： 0.00000000

netAssetOfBtc

string

净值资产 Of Btc.

示例： 0.00000000

repayEnabled

boolean

还款启用.

示例： true

totalAsset

string

总计资产.

示例： 0.00000000

object

quote 资产 object.

asset

string

资产.

示例： USDT

borrowEnabled

boolean

借款启用.

示例： true

borrowed

string

借入.

示例： 0.00000000

free

string

可用.

示例： 0.00000000

interest

string

利息.

示例： 0.00000000

locked

string

冻结.

示例： 0.00000000

netAsset

string

净值资产.

示例： 0.00000000

netAssetOfBtc

string

净值资产 Of Btc.

示例： 0.00000000

repayEnabled

boolean

还款启用.

示例： true

totalAsset

string

总计资产.

示例： 0.00000000

symbol

string

交易对.

示例： BTCUSDT

isolatedCreated

boolean

逐仓 Created.

示例： true

enabled

boolean

账户是否启用，true-启用，false-停用

示例： true

marginLevel

string

杠杆 Level.

示例： 0.00000000

marginLevelStatus

string

"EXCESSIVE", "NORMAL", "杠杆_CALL", "PRE_LIQUIDATION", "FORCE_LIQUIDATION"

示例： EXCESSIVE

marginRatio

string

杠杆 Ratio.

示例： 0.00000000

indexPrice

string

index 价格.

示例： 10000.00000000

liquidatePrice

string

liquidate 价格.

示例： 1000.00000000

liquidateRate

string

liquidate 利率.

示例： 1.00000000

tradeEnabled

boolean

交易启用.

示例： true

totalAssetOfBtc

string

总计资产 Of Btc.

示例： 0.00000000

totalLiabilityOfBtc

string

总计 Liability Of Btc.

示例： 0.00000000

totalNetAssetOfBtc

string

总计净值资产 Of Btc.

示例： 0.00000000

GET/sapi/v1/margin/isolated/account

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/margin/isolated/account?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

示例响应

{
  "assets": [
    {
      "baseAsset": {
        "asset": "BTC",
        "borrowEnabled": true,
        "borrowed": "0.00000000",
        "free": "0.00000000",
        "interest": "0.00000000",
        "locked": "0.00000000",
        "netAsset": "0.00000000",
        "netAssetOfBtc": "0.00000000",
        "repayEnabled": true,
        "totalAsset": "0.00000000"
      },
      "quoteAsset": {
        "asset": "USDT",
        "borrowEnabled": true,
        "borrowed": "0.00000000",
        "free": "0.00000000",
        "interest": "0.00000000",
        "locked": "0.00000000",
        "netAsset": "0.00000000",
        "netAssetOfBtc": "0.00000000",
        "repayEnabled": true,
        "totalAsset": "0.00000000"
      },
      "symbol": "BTCUSDT",
      "isolatedCreated": true,
      "enabled": true,
      "marginLevel": "0.00000000",
      "marginLevelStatus": "EXCESSIVE",
      "marginRatio": "0.00000000",
      "indexPrice": "10000.00000000",
      "liquidatePrice": "1000.00000000",
      "liquidateRate": "1.00000000",
      "tradeEnabled": true
    }
  ],
  "totalAssetOfBtc": "0.00000000",
  "totalLiabilityOfBtc": "0.00000000",
  "totalNetAssetOfBtc": "0.00000000"
}

json

application/json

杠杆逐仓账户启用 (TRADE)

启用特定交易对的杠杆逐仓账户（仅支持启用之前停用的账户）。

POST

/sapi/v1/margin/isolated/account

https://api.binance.com

杠杆逐仓账户启用 (TRADE) › 授权

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

杠杆逐仓账户启用 (TRADE) › 请求权重

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

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

账户权重300

杠杆逐仓账户启用 (TRADE) › 请求头

X-MBX-APIKEY

string · 必须

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

示例： API_KEY

杠杆逐仓账户启用 (TRADE) › 请求体

symbol

string · 必须

示例： BTCUSDT

timestamp

integer · int64 · 必须

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

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

杠杆逐仓账户启用 (TRADE) › 响应

200

启用Isolated 杠杆账户

success

boolean

成功.

示例： true

symbol

string

交易对.

示例： BTCUSDT

杠杆逐仓账户停用 (TRADE)

停用特定交易对的杠杆逐仓账户。每个交易对 24 小时内仅可停用一次。

DELETE

/sapi/v1/margin/isolated/account

https://api.binance.com

杠杆逐仓账户停用 (TRADE) › 授权

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

杠杆逐仓账户停用 (TRADE) › 请求权重

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

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

账户权重300

杠杆逐仓账户停用 (TRADE) › 请求头

X-MBX-APIKEY

string · 必须

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

示例： API_KEY

杠杆逐仓账户停用 (TRADE) › 查询参数

symbol

string · 必须

示例： BTCUSDT

timestamp

integer · int64 · 必须

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

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

杠杆逐仓账户停用 (TRADE) › 响应

200

禁用Isolated 杠杆账户

success

boolean

成功.

示例： true

symbol

string

交易对.

示例： BTCUSDT

获取BNB抵扣开关状态 (USER_DATA)

获取BNB抵扣开关状态

GET

/sapi/v1/bnbBurn

https://api.binance.com

获取BNB抵扣开关状态 (USER_DATA) › 授权

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

获取BNB抵扣开关状态 (USER_DATA) › 请求权重

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

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

IP 权重1

获取BNB抵扣开关状态 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

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

示例： API_KEY

获取BNB抵扣开关状态 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

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

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

获取BNB抵扣开关状态 (USER_DATA) › 响应

200

获取BNB Burn 状态

spotBNBBurn

boolean

字段说明：spot BNBBurn.

示例： true

interestBNBBurn

boolean

利息 BNBBurn.

示例： false

查询Margin账户信息汇总 (USER_DATA)

获取用户个人杠杆账户信息汇总

GET

/sapi/v1/margin/tradeCoeff

https://api.binance.com

查询Margin账户信息汇总 (USER_DATA) › 授权

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

查询Margin账户信息汇总 (USER_DATA) › 请求权重

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

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

IP 权重10

查询Margin账户信息汇总 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

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

示例： API_KEY

查询Margin账户信息汇总 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

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

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

查询Margin账户信息汇总 (USER_DATA) › 响应

200

获取Summary of 杠杆账户

normalBar

string

字段说明：normal Bar.

示例： 1.5

marginCallBar

string

杠杆 Call Bar.

示例： 1.3

forceLiquidationBar

string

强平 Bar.

示例： 1.1

查询全仓/逐仓资金流水 (USER_DATA)

查询全仓/逐仓资金流水

GET

/sapi/v1/margin/capital-flow

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

asset

string

示例： USDT

symbol

string

查询逐仓数据时必填

Mandatory for 逐仓数据

示例： BTCUSDT

type

string · enum

枚举值:

TRANSFER

BORROW

REPAY

BUY_INCOME

BUY_EXPENSE

SELL_INCOME

SELL_EXPENSE

TRADING_COMMISSION

示例： TRANSFER

startTime

integer · int64

Only supports 查询数据 from the past 90 days.

示例： 1623319461670

endTime

integer · int64

示例： 1641782889000

fromId

integer · int64

If fromId is set, 数据 with ID greater than fromId will be returned. Otherwise, the latest 数据 will be returned.

示例： 1

limit

integer · int64 · max: 1000

限制 on the number of 数据 records returned per 请求. ;

示例： 500

默认值： 500

recvWindow

integer · int64 · max: 60000

赋值不能大于 60000

示例： 5000

查询全仓/逐仓资金流水 (USER_DATA) › 响应

200

Cross Isolated 杠杆 Capital Flow

object

id

integer · int64

字段说明：ID.

示例： 123456

tranId

integer · int64

字段说明：tran ID.

示例： 123123

timestamp

integer · int64

时间戳.

示例： 1691116657000

asset

string

资产.

示例： USDT

symbol

string

交易对.

示例： BTCUSDT

type

string

类型.

示例： BORROW

amount

string

数量.

示例： 101

note

string · enum

备注.

枚举值:

INSTITUTIONAL_LOAN_TRANSFER

INSTITUTIONAL_LOAN_BORROW

INSTITUTIONAL_LOAN_REPAY

示例： INSTITUTIONAL_LOAN_TRANSFER

查询全仓杠杆账户详情 (USER_DATA)

查询全仓杠杆账户详情

GET

/sapi/v1/margin/account

https://api.binance.com

查询全仓杠杆账户详情 (USER_DATA) › 授权

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

查询全仓杠杆账户详情 (USER_DATA) › 请求权重

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

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

IP 权重10

查询全仓杠杆账户详情 (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

recvWindow

integer · int64 · max: 60000

示例： 5000

查询全仓杠杆账户详情 (USER_DATA) › 响应

200

Cross 杠杆账户 Details

created

boolean

true 表示已开户, false 表示未开户

示例： true

borrowEnabled

boolean

借款启用.

示例： true

marginLevel

string

杠杆 Level.

示例： 11.64405625

collateralMarginLevel

string

collateral 杠杆 Level.

示例： 3.2

totalAssetOfBtc

string

总计资产 Of Btc.

示例： 6.82728457

totalLiabilityOfBtc

string

总计 Liability Of Btc.

示例： 0.58633215

totalNetAssetOfBtc

string

总计净值资产 Of Btc.

示例： 6.24095242

TotalCollateralValueInUSDT

string

总计 Collateral Value In USDT.

示例： 5.82728457

totalOpenOrderLossInUSDT

string

总计 Open 订单 Loss In USDT.

示例： 582.728457

tradeEnabled

boolean

交易启用.

示例： true

transferInEnabled

boolean

划转 In 启用.

示例： true

transferOutEnabled

boolean

划转 Out 启用.

示例： true

accountType

string

MARGIN_1 全仓Classic模式账户, MARGIN_2 全仓Pro模式账户

示例： MARGIN_1

object[]

user Assets 列表.

asset

string

资产.

示例： BTC

borrowed

string

借入.

示例： 0.00000000

free

string

可用.

示例： 0.00499500

interest

string

利息.

示例： 0.00000000

locked

string

冻结.

示例： 0.00000000

netAsset

string

净值资产.

示例： 0.00499500

GET/sapi/v1/margin/account

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/margin/account?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

示例响应

{
  "created": true,
  "borrowEnabled": true,
  "marginLevel": "11.64405625",
  "collateralMarginLevel": "3.2",
  "totalAssetOfBtc": "6.82728457",
  "totalLiabilityOfBtc": "0.58633215",
  "totalNetAssetOfBtc": "6.24095242",
  "TotalCollateralValueInUSDT": "5.82728457",
  "totalOpenOrderLossInUSDT": "582.728457",
  "tradeEnabled": true,
  "transferInEnabled": true,
  "transferOutEnabled": true,
  "accountType": "MARGIN_1",
  "userAssets": [
    {
      "asset": "BTC",
      "borrowed": "0.00000000",
      "free": "0.00499500",
      "interest": "0.00000000",
      "locked": "0.00000000",
      "netAsset": "0.00499500"
    }
  ]
}

json

application/json

获取全仓杠杆利率及限额 (USER_DATA)

通过VIP等级或用户当前VIP等级获取全仓杠杆利率及限额，如：https://www.binance.com/en/margin-fee

GET

/sapi/v1/margin/crossMarginData

https://api.binance.com

获取全仓杠杆利率及限额 (USER_DATA) › 授权

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

获取全仓杠杆利率及限额 (USER_DATA) › 请求权重

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

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

IP 权重

1 when coin is specified;(IP) 5 when the coin parameter is omitted(IP)

获取全仓杠杆利率及限额 (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

vipLevel

integer · int64

默认为用户当前VIP等级

示例： 1

coin

string

示例： BTC

recvWindow

integer · int64 · max: 60000

示例： 5000

获取全仓杠杆利率及限额 (USER_DATA) › 响应

200

Cross 杠杆 Fee Data

object

vipLevel

integer · int64

vip 等级.

示例： 0

coin

string

字段说明：coin.

示例： BTC

transferIn

boolean

划转 In.

示例： true

borrowable

boolean

借款able.

示例： true

dailyInterest

string

daily 利息.

示例： 0.00026125

yearlyInterest

string

yearly 利息.

示例： 0.0953

borrowLimit

string

借款限制.

示例： 180

marginablePairs

string[]

marginable Pairs 列表.

查询杠杆逐仓账户启用限制 (USER_DATA)

查询杠杆逐仓账户启用限制。

GET

/sapi/v1/margin/isolated/accountLimit

https://api.binance.com

查询杠杆逐仓账户启用限制 (USER_DATA) › 授权

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

查询杠杆逐仓账户启用限制 (USER_DATA) › 请求权重

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

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

IP 权重1

查询杠杆逐仓账户启用限制 (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

recvWindow

integer · int64 · max: 60000

示例： 5000

查询杠杆逐仓账户启用限制 (USER_DATA) › 响应

200

Enabled Isolated 杠杆账户限制

enabledAccount

integer · int64

启用 Account.

示例： 5

maxAccount

integer · int64

字段说明：max Account.

示例： 20

获取逐仓杠杆利率及限额 (USER_DATA)

通过VIP等级或用户当前VIP等级获取逐仓杠杆利率及限额，如： https://www.binance.com/en/margin-fee

GET

/sapi/v1/margin/isolatedMarginData

https://api.binance.com

获取逐仓杠杆利率及限额 (USER_DATA) › 授权

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

获取逐仓杠杆利率及限额 (USER_DATA) › 请求权重

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

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

IP 权重

1 when a single is specified;(IP) 10 when the symbol parameter is omitted(IP)

获取逐仓杠杆利率及限额 (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

vipLevel

integer · int64

User's 当前 specific 杠杆数据 will be returned if vipLevel is omitted

示例： 1

symbol

string

示例： BTCUSDT

recvWindow

integer · int64 · max: 60000

示例： 5000

获取逐仓杠杆利率及限额 (USER_DATA) › 响应

200

Isolated 杠杆 Fee Data

object

vipLevel

integer · int64

vip 等级.

示例： 0

symbol

string

交易对.

示例： BTCUSDT

leverage

string

字段说明：leverage.

示例： 10

object[]

数据列表.

coin

string

字段说明：coin.

示例： BTC

dailyInterest

string

daily 利息.

示例： 0.00026125

borrowLimit

string

借款限制.

示例： 270